opannotate - produce source or assembly annotated with profile data

opannotate [ options ] [profile specification]

opannotate outputs annotated source and/or assembly from profile data of an OProfile session.

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

No special environment variables are recognised by opannotate.

/var/lib/oprofile/samples/

The location of the generated sample files.

This man page is current for oprofile-0.9.1.

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