OPANNOTATE(1)                                                                                                      OPANNOTATE(1)



NAME
       opannotate - produce source or assembly annotated with profile data

SYNOPSIS
       opannotate [ options ] [profile specification]

DESCRIPTION
       opannotate  outputs annotated source and/or assembly from profile data of an OProfile session. See oprofile(1) for how to
       write profile specifications.


OPTIONS
       --assembly / -a
              Output annotated assembly. If this is combined with --source, then mixed source / assembly annotations are output.

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

       --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-file [files]
              Exclude all files in the given comma-separated list of glob patterns.

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

       --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-file [files]
              Only include files in the given comma-separated list of glob patterns.

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

       --objdump-params [params]
              Pass the given parameters as extra values when calling objdump.

       --output-dir / -o [dir]
              Output  directory. This makes opannotate output one annotated file for each source file. This option can't be used
              in conjunction with --assembly.

       --search-dirs / -d [paths]
              Comma-separated list of paths to search for source files. You may need to use this option when the debug  informa-
              tion for an image contains relative paths.

       --base-dirs / -b [paths]
              Comma-separated list of paths to strip from debug source files, prior to looking for them in --search-dirs.

       --session-dir=dir_path
              Use sample database out of directory dir_path instead of the default location (/var/lib/oprofile).

       --source / -s
              Output annotated source. This requires debugging information to be available for the binaries.

       --threshold / -t [percentage]
              Only output data for symbols that have more than the given percentage of total samples.

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

       --version / -v
              Show version.


ENVIRONMENT
       No special environment variables are recognised by opannotate.


FILES
       /var/lib/oprofile/samples/
              The location of the generated sample files.


VERSION
       This man page is current for oprofile-0.9.6.


SEE ALSO
       /usr/share/doc/oprofile-0.9.6/, oprofile(1)



4th Berkeley Distribution                               Tue 07 June 2011                                           OPANNOTATE(1)