llvm-dwarfdump.rst 6.57 KB

llvm-dwarfdump - dump and verify DWARF debug information

SYNOPSIS

:program:`llvm-dwarfdump` [options] [filename ...]

DESCRIPTION

:program:`llvm-dwarfdump` parses DWARF sections in object files, archives, and .dSYM bundles and prints their contents in human-readable form. Only the .debug_info section is printed unless one of the section-specific options or :option:`--all` is specified.

If no input file is specified, a.out is used instead. If - is used as the input file, :program:`llvm-dwarfdump` reads the input from its standard input stream.

OPTIONS

FORMAT OF STATISTICS OUTPUT

The ::option:`--statistics` option generates single-line JSON output representing quality metrics of the processed debug info. These metrics are useful to compare changes between two compilers, particularly for judging the effect that a change to the compiler has on the debug info quality.

The output is formatted as key-value pairs. The first pair contains a version number. The following naming scheme is used for the keys:

  • variables ==> local variables and parameters
  • local vars ==> local variables
  • params ==> formal parameters

For aggregated values, the following keys are used:

  • sum_of_all_variables(...) ==> the sum applied to all variables
  • #bytes ==> the number of bytes
  • #variables - entry values ... ==> the number of variables excluding the entry values etc.

EXIT STATUS

:program:`llvm-dwarfdump` returns 0 if the input files were parsed and dumped successfully. Otherwise, it returns 1.

SEE ALSO

:manpage:`dsymutil(1)`