llvm-locstats - calculate statistics on DWARF debug location

SYNOPSIS

llvm-locstats [options] [filename]

DESCRIPTION

llvm-locstats works like a wrapper around llvm-dwarfdump. It parses llvm-dwarfdump statistics regarding debug location by pretty printing it in a more human readable way.

The line 0% shows the number and the percentage of DIEs with no location information, but the line 100% shows the information for DIEs where there is location information in all code section bytes (where the variable or parameter is in the scope). The line 50-59% shows the number and the percentage of DIEs where the location information is between 50 and 59 percentage of its scope covered.

OPTIONS

-only-variables

Calculate the location statistics only for local variables.

-only-formal-parameters

Calculate the location statistics only for formal parameters.

-ignore-debug-entry-values

Ignore the location statistics on locations containing the debug entry values DWARF operation.

EXIT STATUS

llvm-locstats returns 0 if the input file were parsed successfully. Otherwise, it returns 1.

OUTPUT EXAMPLE

=================================================
          Debug Location Statistics
=================================================
      cov%          samples       percentage(~)
-------------------------------------------------
   0%                    1              16%
   1-9%                  0               0%
   10-19%                0               0%
   20-29%                0               0%
   30-39%                0               0%
   40-49%                0               0%
   50-59%                1              16%
   60-69%                0               0%
   70-79%                0               0%
   80-89%                1              16%
   90-99%                0               0%
   100%                  3              50%
=================================================
-the number of debug variables processed: 6
-PC ranges covered: 81%
-------------------------------------------------
-total availability: 83%
=================================================