opreport(1)

1OPREPORT(1)                 General Commands Manual                OPREPORT(1)
2
3
4

NAME

6       opreport - produce symbol or binary image summaries
7

SYNOPSIS

9       opreport [ options ] [profile specification]
10

DESCRIPTION

12       opreport outputs binary image summaries, or per-symbol data, from OPro‐
13       file profiling sessions. See oprofile(1) for how to write profile spec‐
14       ifications.
15
16

OPTIONS

18       --accumulated / -a
19              Accumulate sample and percentage counts in the symbol list.
20
21       --debug-info / -g
22              Show source file and line for each symbol.
23
24       --demangle / -D none|smart|normal
25              none:  no  demangling.  normal:  use default demangler (default)
26              smart: use pattern-matching to make C++ symbol  demangling  more
27              readable.
28
29       --callgraph / -c
30              Show call graph information if available.
31
32       --details / -d
33              Show per-instruction details for all selected symbols.
34
35       --exclude-dependent / -x
36              Do not include application-specific images for libraries, kernel
37              modules and the kernel. This option only makes sense if the pro‐
38              file session used --separate.
39
40       --exclude-symbols / -e [symbols]
41              Exclude all the symbols in the given comma-separated list.
42
43       --global-percent / -%
44              Make all percentages relative to the whole profile.
45
46       --help / -? / --usage
47              Show help message.
48
49       --image-path / -p [paths]
50              Comma-separated list of additional paths to search for binaries.
51              This is needed to find modules in kernels 2.6 and upwards.
52
53       --root / -R [path]
54              A path to a filesystem to search for additional binaries.
55
56       --include-symbols / -i [symbols]
57              Only include symbols in the given comma-separated list.
58
59       --long-filenames / -f
60              Output full paths instead of basenames.
61
62       --merge / -m [lib,cpu,tid,tgid,unitmask,all]
63              Merge any profiles separated in a --separate session.
64
65       --no-header / -n
66              Don't output a header detailing profiling parameters.
67
68       --output-file / -o [file]
69              Output to the given file instead of stdout.
70
71       --reverse-sort / -r
72              Reverse the sort from the default.
73
74       --session-dir=dir_path
75              Use  sample  database  from  the  specified  directory  dir_path
76              instead  of the default location. If --session-dir is not speci‐
77              fied,  then  opreport  will  search   for   samples   in   <cur‐
78              rent_dir>/oprofile_data first. If that directory does not exist,
79              the standard session-dir of /var/lib/oprofile is used.
80
81       --show-address / -w
82              Show each symbol's VMA address.
83
84       --sort / -s [vma,sample,symbol,debug,image]
85              Sort the list of symbols by, respectively, symbol address,  num‐
86              ber  of  samples,  symbol  name, debug filename and line number,
87              binary image filename.
88
89       --symbols / -l
90              List per-symbol information instead of a binary image summary.
91              Usually, the total of all per-symbols samples for a given binary
92              image  equals  the  summary count for the binary image (shown by
93              running opreport with no options).  However, it's  possible  for
94              some  sample  addresses to fall outside the range of any symbols
95              for a given binary image.  In such cases, the  total  number  of
96              per-symbols  samples  for  the binary image may be less than the
97              summary count for the image. Running opreport  with  the  --ver‐
98              bose=debug  option  will  display  an informational message when
99              this difference is detected.  This difference is typically  very
100              small and can be ignored.
101
102       --threshold / -t [percentage]
103              Only  output data for symbols that have more than the given per‐
104              centage of total samples. For profiles using multiple events, if
105              the threshold is reached for any event, then all sample data for
106              the symbol is shown.
107
108       --verbose / -V [options]
109              Give verbose debugging output.
110
111       --version / -v
112              Show version.
113
114       --xml / -X
115              Generate XML output.
116
117

ENVIRONMENT

119       No special environment variables are recognized by opreport.
120
121

FILES

123       <session_dir>/samples
124              The location of the generated sample files.
125
126

VERSION

128       This man page is current for oprofile-1.3.0.
129
130