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 / -D 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
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.
- --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 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
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.2.
SEE ALSO
/usr/share/doc/oprofile/, oprofile(1)