---
name: "opannotate"
section: "1"
platform: "linux"
package: "oprofile"
version: "0.9.6-1.1+squeeze2"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/opannotate"
---

# opannotate(1)

produce source or assembly annotated with profile data

## 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)](/oprofile/1.md) 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 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.\

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

- **--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/,** **[oprofile(1)](/oprofile/1.md)**