1OPROFILE(1) General Commands Manual OPROFILE(1)
2
3
4
6 oprofile - a statistical profiler for Linux systems, capable of profil‐
7 ing all running code at low overhead; also included is a set of post-
8 profiling analysis tools, as well as a simple event counting tool
9
11 operf [ options ]
12 ocount [ options ]
13 opreport [ options ] [ profile specification ]
14 opannotate [ options ] [ profile specification ]
15 oparchive [ options ] [ profile specification ]
16 opgprof [ options ] [ profile specification ]
17
19 OProfile is a profiling system for systems running Linux 2.6.31 and
20 greater. OProfile makes use of the hardware performance counters pro‐
21 vided on Intel, AMD, and other processors. OProfile can profile a
22 selected program or process or the whole system. OProfile can also be
23 used to collect cumulative event counts at the application, process, or
24 system level.
25 For a gentle guide to using OProfile, please read the HTML documenta‐
26 tion listed in SEE ALSO.
27
29 operf is a performance profiler tool for Linux.
30
32 ocount is an event counting tool for Linux.
33
35 opreport gives image and symbol-based profile summaries for the whole
36 system or a subset of binary images.
37
39 opannotate can produce annotated source or mixed source and assembly
40 output.
41
43 oparchive produces oprofile archive for offline analysis
44
46 opgprof can produce a gprof-format profile for a single binary.
47
48
50 Various optional profile specifications may be used with the post-pro‐
51 filing tools. A profile specification is some combination of the param‐
52 eters listed below. ( Note: Enclosing part of a profile specification
53 in curly braces { } can be used for differential profiles with opre‐
54 port, but the braces must be surrounded by whitespace.)
55
56
57 archive:archive
58 Path to the archive to inspect, as generated by oparchive
59
60 session:sessionlist
61 A comma-separated list of session names to resolve in. Absence
62 of this tag, unlike all others, means "the current session",
63 equivalent to specifying "session:current".
64
65 session-exclude:sessionlist
66 A comma-separated list of sessions to exclude.
67
68 image:imagelist
69 A comma-separated list of image names to resolve. Each entry may
70 be relative path, glob-style name, or full path, e.g. opreport
71 'image:/usr/bin/operf,*op*,./oprofpp'
72
73 image-exclude:imagelist
74 Same as image:, but the matching images are excluded.
75
76 lib-image:imagelist
77 Same as image:, but only for images that are for a particular
78 primary binary image (namely, an application). This only makes
79 sense to use if you're using --separate. This includes kernel
80 modules and the kernel when using --separate=kernel.
81
82 lib-image-exclude:imagelist
83 Same as <option>lib-image:</option>, but the matching images are
84 excluded.
85
86 event:eventname
87 The symbolic event name to match on, e.g. event:DATA_MEM_REFS.
88
89 count:eventcount
90 The event count to match on, e.g. event:DATA_MEM_REFS
91 count:30000.
92
93 unit-mask:maskvalue
94 The unit mask value of the event to match on, e.g. unit-mask:1.
95
96 cpu:cpulist
97 Only consider profiles for the given numbered CPU (starting from
98 zero). This is only useful when using CPU profile separation.
99
100 tgid:pidlist
101 Only consider profiles for the given task groups. Unless some
102 program is using threads, the task group ID of a process is the
103 same as its process ID. This option corresponds to the POSIX
104 notion of a thread group. This is only useful when using per-
105 process profile separation.
106
107 tid:tidlist
108 Only consider profiles for the given threads. When using recent
109 thread libraries, all threads in a process share the same task
110 group ID, but have different thread IDs. You can use this option
111 in combination with tgid: to restrict the results to particular
112 threads within a process. This is only useful when using per-
113 process profile separation.
114
115
117 No special environment variables are recognized by OProfile.
118
119
121 /usr/share/doc/oprofile/oprofile.html
122 OProfile user guide.
123
124 /usr/share/doc/oprofile/opreport.xsd
125 Schema file for opreport XML output.
126
127 /usr/share/doc/oprofile/ophelp.xsd
128 Schema file for ophelp XML output.
129
130 /usr/share/oprofile/
131 Event description files used by OProfile.
132
133 <session-dir>/samples/operf.log
134 The profiler log file.
135
136 <session-dir>/samples/current
137 The location of the generated sample files.
138
139
141 This man page is current for oprofile-1.3.0.
142
143
145 /usr/share/doc/oprofile/, operf(1), ocount(1), opreport(1), opanno‐
146 tate(1), oparchive(1), opgprof(1), gprof(1), CPU vendor architecture
147 manuals
148
149
151 oprofile is Copyright (C) 1998-2004 University of Manchester, UK, John
152 Levon, and others. OProfile is released under the GNU General Public
153 License, Version 2, or (at your option) any later version.
154
156 John Levon <levon@movementarian.org> is the primary author. See the
157 documentation for other contributors.
158
159
160
1614th Berkeley Distribution Thu 15 November 2018 OPROFILE(1)