| .TH OPREPORT 1 "@DATE@" "oprofile @VERSION@" |
| .UC 4 |
| .SH NAME |
| opreport \- produce symbol or binary image summaries |
| .SH SYNOPSIS |
| .br |
| .B opreport |
| [ |
| .I options |
| ] |
| [profile specification] |
| .SH DESCRIPTION |
| |
| .B opreport |
| outputs binary image summaries, or per-symbol data, from OProfile profiling |
| sessions. See oprofile(1) for how to write profile specifications. |
| |
| .SH OPTIONS |
| .TP |
| .BI "--accumulated / -a" |
| Accumulate sample and percentage counts in the symbol list. |
| .br |
| .TP |
| .BI "--debug-info / -g" |
| Show source file and line for each symbol. |
| .br |
| .TP |
| .BI "--demangle / -D none|smart|normal" |
| none: no demangling. normal: use default demangler (default) smart: use |
| pattern-matching to make C++ symbol demangling more readable. |
| .br |
| .TP |
| .BI "--callgraph / -c" |
| Show call graph information if available. |
| .br |
| .TP |
| .BI "--details / -d" |
| Show per-instruction details for all selected symbols. |
| .br |
| .TP |
| .BI "--exclude-dependent / -x" |
| Do not include application-specific images for libraries, kernel modules |
| and the kernel. This option only makes sense if the profile session |
| used --separate. |
| .br |
| .TP |
| .BI "--exclude-symbols / -e [symbols]" |
| Exclude all the symbols in the given comma-separated list. |
| .br |
| .TP |
| .BI "--global-percent / -%" |
| Make all percentages relative to the whole profile. |
| .br |
| .TP |
| .BI "--help / -? / --usage" |
| Show help message. |
| .br |
| .TP |
| .BI "--image-path / -p [paths]" |
| Comma-separated list of additional paths to search for binaries. |
| This is needed to find modules in kernels 2.6 and upwards. |
| .br |
| .TP |
| .BI "--root / -R [path]" |
| A path to a filesystem to search for additional binaries. |
| .br |
| .TP |
| .BI "--include-symbols / -i [symbols]" |
| Only include symbols in the given comma-separated list. |
| .br |
| .TP |
| .BI "--long-filenames / -f" |
| Output full paths instead of basenames. |
| .br |
| .TP |
| .BI "--merge / -m [lib,cpu,tid,tgid,unitmask,all]" |
| Merge any profiles separated in a --separate session. |
| .br |
| .TP |
| .BI "--no-header" |
| Don't output a header detailing profiling parameters. |
| .br |
| .TP |
| .BI "--output-file / -o [file]" |
| Output to the given file instead of stdout. |
| .br |
| .TP |
| .BI "--reverse-sort / -r" |
| Reverse the sort from the default. |
| .br |
| .TP |
| .BI "--session-dir="dir_path |
| Use sample database out of directory dir_path instead of the default location (/var/lib/oprofile). |
| .br |
| .TP |
| .BI "--show-address / -w" |
| Show each symbol's VMA address. |
| .br |
| .TP |
| .BI "--sort / -s [vma,sample,symbol,debug,image]" |
| Sort the list of symbols by, respectively, symbol address, |
| number of samples, symbol name, debug filename and line number, |
| binary image filename. |
| .br |
| .TP |
| .BI "--symbols / -l" |
| List per-symbol information instead of a binary image summary. |
| .br |
| .TP |
| .BI "--threshold / -t [percentage]" |
| Only output data for symbols that have more than the given percentage |
| of total samples. |
| .br |
| .TP |
| .BI "--verbose / -V [options]" |
| Give verbose debugging output. |
| .br |
| .TP |
| .BI "--version / -v" |
| Show version. |
| .br |
| .TP |
| .BI "--xml / -X" |
| Generate XML output. |
| |
| .SH ENVIRONMENT |
| No special environment variables are recognised by opreport. |
| |
| .SH FILES |
| .TP |
| .I /var/lib/oprofile/samples/ |
| The location of the generated sample files. |
| |
| .SH VERSION |
| .TP |
| This man page is current for @PACKAGE@-@VERSION@. |
| |
| .SH SEE ALSO |
| .BR @OP_DOCDIR@, |
| .BR oprofile(1) |
