1OPROFILE(1) General Commands Manual OPROFILE(1)
2
3
4
6 oprofile - a system-wide profiler
7
9 opcontrol [ options ]
10 opreport [ options ] [ profile specification ]
11 opannotate [ options ] [ profile specification ]
12 oparchive [ options ] [ profile specification ]
13 opgprof [ options ] [ profile specification ]
14
16 OProfile is a profiling system for systems running Linux 2.6 and
17 greater. Profiling runs transparently in the background and profile
18 data can be collected at any time. OProfile makes use of the hardware
19 performance counters provided on Intel, AMD, and other processors, and
20 uses a timer-interrupt based mechanism on CPUs without counters. OPro‐
21 file can profile the whole system in high detail.
22 For a gentle guide to using OProfile, please read the HTML documenta‐
23 tion listed in SEE ALSO.
24
26 opcontrol is used for starting and stopping the OProfile daemon, and
27 providing set-up parameters.
28
30 opreport gives image and symbol-based profile summaries for the whole
31 system or a subset of binary images.
32
34 opannotate can produce annotated source or mixed source and assembly
35 output.
36
38 oparchive produces oprofile archive for offline analysis
39
41 opgprof can produce a gprof-format profile for a single binary.
42
43
45 All of the post-profiling tools can take profile specifications, which
46 is some combination of the following parameters. Enclosing part of a
47 profile specification in curly braces { } can be used for differential
48 profiles with opreport ; the braces must be surrounded by whitespace.
49
50
51 archive:archive
52 Path to the archive to inspect, as generated by oparchive
53
54 session:sessionlist
55 A comma-separated list of session names to resolve in. Absence
56 of this tag, unlike all others, means "the current session",
57 equivalent to specifying "session:current".
58
59 session-exclude:sessionlist
60 A comma-separated list of sessions to exclude.
61
62 image:imagelist
63 A comma-separated list of image names to resolve. Each entry may
64 be relative path, glob-style name, or full path, e.g. opreport
65 'image:/usr/bin/oprofiled,*op*,./oprofpp'
66
67 image-exclude:imagelist
68 Same as image:, but the matching images are excluded.
69
70 lib-image:imagelist
71 Same as image:, but only for images that are for a particular
72 primary binary image (namely, an application). This only makes
73 sense to use if you're using --separate. This includes kernel
74 modules and the kernel when using --separate=kernel.
75
76 lib-image-exclude:imagelist
77 Same as <option>lib-image:</option>, but the matching images are
78 excluded.
79
80 event:eventname
81 The symbolic event name to match on, e.g. event:DATA_MEM_REFS.
82
83 count:eventcount
84 The event count to match on, e.g. event:DATA_MEM_REFS
85 count:30000.
86
87 unit-mask:maskvalue
88 The unit mask value of the event to match on, e.g. unit-mask:1.
89
90 cpu:cpulist
91 Only consider profiles for the given numbered CPU (starting from
92 zero). This is only useful when using CPU profile separation.
93
94 tgid:pidlist
95 Only consider profiles for the given task groups. Unless some
96 program is using threads, the task group ID of a process is the
97 same as its process ID. This option corresponds to the POSIX
98 notion of a thread group. This is only useful when using per-
99 process profile separation.
100
101 tid:tidlist
102 Only consider profiles for the given threads. When using recent
103 thread libraries, all threads in a process share the same task
104 group ID, but have different thread IDs. You can use this option
105 in combination with tgid: to restrict the results to particular
106 threads within a process. This is only useful when using per-
107 process profile separation.
108
109
111 No special environment variables are recognised by oprofile.
112
113
115 $HOME/.oprofile/
116 Configuration files
117
118 /root/.oprofile/daemonrc
119 Configuration file for opcontrol
120
121 /usr/share/oprofile/
122 Event description files used by OProfile.
123
124 /var/lib/oprofile/samples/oprofiled.log
125 The user-space daemon logfile.
126
127 /dev/oprofile
128 The device filesystem for communication with the Linux kernel
129 module.
130
131 /var/lib/oprofile/samples/
132 The location of the generated sample files.
133
134
136 This man page is current for oprofile-0.9.9.
137
138
140 /usr/share/doc/oprofile-0.9.9/, opcontrol(1), opreport(1), opanno‐
141 tate(1), oparchive(1), opgprof(1), gprof(1), readprofile(1), CPU vendor
142 architecture manuals
143
144
146 oprofile is Copyright (C) 1998-2004 University of Manchester, UK, John
147 Levon, and others. OProfile is released under the GNU General Public
148 License, Version 2, or (at your option) any later version.
149
151 John Levon <levon@movementarian.org> is the primary author. See the
152 documentation for other contributors.
153
154
155
1564th Berkeley Distribution Tue 21 March 2017 OPROFILE(1)