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

NAME

6       oprofile - a system-wide profiler
7

SYNOPSIS

9       opcontrol [ options ]
10       opreport [ options ] [ profile specification ]
11       opannotate [ options ] [ profile specification ]
12       oparchive [ options ] [ profile specification ]
13       opgprof [ options ] [ profile specification ]
14

DESCRIPTION

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

OPCONTROL

26       opcontrol  is  used  for starting and stopping the OProfile daemon, and
27       providing set-up parameters.
28

OPREPORT

30       opreport gives image and symbol-based profile summaries for  the  whole
31       system or a subset of binary images.
32

OPANNOTATE

34       opannotate  can  produce  annotated source or mixed source and assembly
35       output.
36

OPARCHIVE

38       oparchive produces oprofile archive for offline analysis
39

OPGPROF

41       opgprof can produce a gprof-format profile for a single binary.
42
43

PROFILE SPECIFICATIONS

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

ENVIRONMENT

111       No special environment variables are recognised by oprofile.
112
113

FILES

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

VERSION

136       This man page is current for oprofile-0.9.9.
137
138

SEE ALSO

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

AUTHORS

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)
Impressum