1LLVM-LOCSTATS(1)                     LLVM                     LLVM-LOCSTATS(1)
2
3
4

NAME

6       llvm-locstats - calculate statistics on DWARF debug location
7

SYNOPSIS

9       llvm-locstats [options] [filename]
10

DESCRIPTION

12       llvm-locstats  works  like  a wrapper around llvm-dwarfdump.  It parses
13       llvm-dwarfdump statistics regarding debug location by  pretty  printing
14       it in a more human readable way.
15
16       The  line  0% shows the number and the percentage of DIEs with no loca‐
17       tion information, but the line 100%  shows  the  information  for  DIEs
18       where  there  is  location information in all code section bytes (where
19       the variable or parameter is in the scope). The  line  [50%,60%)  shows
20       the number and the percentage of DIEs where the location information is
21       between 50 and 60 percentage of its scope covered.
22

OPTIONS

24       --only-variables
25              calculate the location statistics only for local variables
26
27       --only-formal-parameters
28              calculate the location statistics only for formal parameters
29
30       --ignore-debug-entry-values
31              ignore the location statistics on locations containing the debug
32              entry values DWARF operation
33
34       --draw-plot
35              make  histogram  of  location  buckets  generated (requires mat‐
36              plotlib)
37

EXIT STATUS

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

EXAMPLE 1

43       Pretty print the location coverage on the standard output.
44
45          llvm-locstats a.out
46
47            =================================================
48                      Debug Location Statistics
49            =================================================
50                  cov%          samples       percentage(~)
51            -------------------------------------------------
52               0%                    1              16%
53               (0%,10%)              0               0%
54               [10%,20%)             0               0%
55               [20%,30%)             0               0%
56               [30%,40%)             0               0%
57               [40%,50%)             0               0%
58               [50%,60%)             1              16%
59               [60%,70%)             0               0%
60               [70%,80%)             0               0%
61               [80%,90%)             1              16%
62               [90%,100%)            0               0%
63               100%                  3              50%
64            =================================================
65            -the number of debug variables processed: 6
66            -PC ranges covered: 81%
67            -------------------------------------------------
68            -total availability: 83%
69            =================================================
70

EXAMPLE 2

72       Generate a plot as an image file.
73
74          llvm-locstats --draw-plot file1.out
75       [image]
76

SEE ALSO

78       llvm-dwarfdump(1)
79

AUTHOR

81       Maintained by the LLVM Team (https://llvm.org/).
82

84       2003-2020, LLVM Project
85
86
87
88
8910                                2020-04-01                  LLVM-LOCSTATS(1)
Impressum