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

OPTIONS

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

ENVIRONMENT

85       No special environment variables are recognised by opannotate.
86
87

FILES

89       /var/lib/oprofile/samples/
90              The location of the generated sample files.
91
92

VERSION

94       This man page is current for oprofile-0.9.2.
95
96