Provided by: oprofile_1.3.0-0ubuntu13_amd64 bug

NAME

       opreport - produce symbol or binary image summaries

SYNOPSIS

       opreport [ options ] [profile specification]

DESCRIPTION

       opreport  outputs  binary  image  summaries,  or  per-symbol data, from OProfile profiling
       sessions. See oprofile(1) for how to write profile specifications.

OPTIONS

       --accumulated / -a
              Accumulate sample and percentage counts in the symbol list.

       --debug-info / -g
              Show source file and line for each symbol.

       --demangle / -D none|smart|normal
              none: no demangling. normal: use default demangler (default)  smart:  use  pattern-
              matching to make C++ symbol demangling more readable.

       --callgraph / -c
              Show call graph information if available.

       --details / -d
              Show per-instruction details for all selected symbols.

       --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.

       --exclude-symbols / -e [symbols]
              Exclude all the symbols in the given comma-separated list.

       --global-percent / -%
              Make all percentages relative to the whole profile.

       --help / -? / --usage
              Show help message.

       --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.

       --root / -R [path]
              A path to a filesystem to search for additional binaries.

       --include-symbols / -i [symbols]
              Only include symbols in the given comma-separated list.

       --long-filenames / -f
              Output full paths instead of basenames.

       --merge / -m [lib,cpu,tid,tgid,unitmask,all]
              Merge any profiles separated in a --separate session.

       --no-header / -n
              Don't output a header detailing profiling parameters.

       --output-file / -o [file]
              Output to the given file instead of stdout.

       --reverse-sort / -r
              Reverse the sort from the default.

       --session-dir=dir_path
              Use  sample  database  from the specified directory dir_path instead of the default
              location. If --session-dir is not specified, then opreport will search for  samples
              in  <current_dir>/oprofile_data  first.  If  that  directory  does  not  exist, the
              standard session-dir of /var/lib/oprofile is used.

       --show-address / -w
              Show each symbol's VMA address.

       --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.

       --symbols / -l
              List per-symbol information instead of a binary image summary.
              Usually,  the  total of all per-symbols samples for a given binary image equals the
              summary count for the binary image (shown by running  opreport  with  no  options).
              However,  it's  possible for some sample addresses to fall outside the range of any
              symbols for a given binary image.  In such cases, the total number  of  per-symbols
              samples  for  the  binary  image  may be less than the summary count for the image.
              Running opreport with the --verbose=debug  option  will  display  an  informational
              message  when this difference is detected.  This difference is typically very small
              and can be ignored.

       --threshold / -t [percentage]
              Only output data for symbols that have more than  the  given  percentage  of  total
              samples.  For  profiles  using multiple events, if the threshold is reached for any
              event, then all sample data for the symbol is shown.

       --verbose / -V [options]
              Give verbose debugging output.

       --version / -v
              Show version.

       --xml / -X
              Generate XML output.

ENVIRONMENT

       No special environment variables are recognized by opreport.

FILES

       <session_dir>/samples
              The location of the generated sample files.

VERSION

       This man page is current for oprofile-1.3.0.

SEE ALSO

       /usr/share/doc/oprofile/, oprofile(1)