opannotate



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.



OPTIONS

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

       --demangle none|smart|normal
              none:  no  demangling.  normal:  use default demangler (default)
              smart: use pattern-matching to make C++ symbol  demangling  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 pro-
              file session used --separate.

       --exclude-file [files]
              Exclude all files in the given comma-separated list of glob pat-
              terns.

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

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

       --search-dirs / -d [paths]
              Comma-separated list of paths to search for  source  files.  You
              may  need  to  use this option when the debug information 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.

       --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  per-
              centage 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.8.2.



SEE ALSO

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



4th Berkeley Distribution      Wed 13 April 2005                 OPANNOTATE(1)

Man(1) output converted with man2html