xenial (1) opreport.1.gz

Provided by: oprofile_1.1.0-0ubuntu1.1_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.1.0.

SEE ALSO

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