opannotate(1)

1OPANNOTATE(1)               General Commands Manual              OPANNOTATE(1)
2
3
4

NAME

6       opannotate - produce source or assembly annotated with profile data
7

SYNOPSIS

9       opannotate [ options ] [profile specification]
10

DESCRIPTION

12       opannotate  outputs  annotated source and/or assembly from profile data
13       of an OProfile session. See oprofile(1) for how to write profile speci‐
14       fications.
15
16

OPTIONS

18       --assembly / -a
19              Output  annotated  assembly.  If this is combined with --source,
20              then mixed source / assembly annotations are output.
21
22       --demangle / -D none|smart|normal
23              none: no demangling. normal:  use  default  demangler  (default)
24              smart:  use  pattern-matching to make C++ symbol demangling more
25              readable.
26
27       --exclude-dependent / -x
28              Do not include application-specific images for libraries, kernel
29              modules and the kernel. This option only makes sense if the pro‐
30              file session used --separate.
31
32       --exclude-file [files]
33              Exclude all files in the given comma-separated list of glob pat‐
34              terns.
35
36       --exclude-symbols / -e [symbols]
37              Exclude all the symbols in the given comma-separated list.
38
39       --help / -? / --usage
40              Show help message.
41
42       --image-path / -p [paths]
43              Comma-separated list of additional paths to search for binaries.
44              This is needed to find modules in kernels 2.6 and upwards.
45
46       --root / -R [path]
47              A path to a filesystem to search for additional binaries.
48
49       --include-file [files]
50              Only include files in the given  comma-separated  list  of  glob
51              patterns.
52
53       --include-symbols / -i [symbols]
54              Only include symbols in the given comma-separated list.
55
56       --objdump-params [params]
57              Pass the given parameters as extra values when calling objdump.
58
59       --output-dir / -o [dir]
60              Output  directory.  This  makes  opannotate output one annotated
61              file for each source file. This option can't be used in conjunc‐
62              tion with --assembly.
63
64       --search-dirs / -d [paths]
65              Comma-separated  list  of  paths to search for source files. You
66              may need to use this option when the debug  information  for  an
67              image contains relative paths.
68
69       --base-dirs / -b [paths]
70              Comma-separated  list of paths to strip from debug source files,
71              prior to looking for them in --search-dirs.
72
73       --session-dir=dir_path
74              Use sample database out of directory  dir_path  instead  of  the
75              default location (/var/lib/oprofile).
76
77       --source / -s
78              Output  annotated source. This requires debugging information to
79              be available for the binaries.
80
81       --threshold / -t [percentage]
82              Only output data for symbols that have more than the given  per‐
83              centage of total samples.
84
85       --verbose / -V [options]
86              Give verbose debugging output.
87
88       --version / -v
89              Show version.
90
91

ENVIRONMENT

93       No special environment variables are recognised by opannotate.
94
95

FILES

97       /var/lib/oprofile/samples/
98              The location of the generated sample files.
99
100

VERSION

102       This man page is current for oprofile-0.9.6.
103
104