-.TH OPROFILE 1 "Mon 27 August 2012" "oprofile 0.9.8"
+.TH OPROFILE 1 "Tue 21 July 2015" "oprofile 1.1.0"
.UC 4
.SH NAME
-oprofile \- a system-wide profiler
+oprofile \- a statistical profiler for Linux systems, capable of profiling all running code
+at low overhead; also included is a set of post-profiling analysis tools, as well as a simple
+event counting tool
.SH SYNOPSIS
.br
-.B opcontrol
+.B operf
+[
+.I options
+]
+.br
+.B ocount
[
.I options
]
.br
.SH DESCRIPTION
OProfile is a profiling system for systems running Linux
-2.6 and greater. Profiling runs transparently in the background and profile
-data can be collected at any time. OProfile makes use of the hardware
-performance counters provided on Intel, AMD, and other processors,
-and uses a timer-interrupt based mechanism on CPUs without counters.
-OProfile can profile the whole system in high detail.
+2.6.31 and greater. OProfile makes use of the hardware
+performance counters provided on Intel, AMD, and other processors.
+OProfile can profile a selected program or process or the whole system.
+OProfile can also be used to collect cumulative event counts at the
+application, process, or system level.
.br
For a gentle guide to using OProfile, please read the HTML documentation
listed in SEE ALSO.
.br
-.SH OPCONTROL
-.B opcontrol
-is used for starting and stopping the OProfile daemon, and providing set-up
-parameters.
+.SH OPERF
+.B operf
+is a performance profiler tool for Linux.
+.SH OCOUNT
+.B ocount
+is an event counting tool for Linux.
.SH OPREPORT
.B opreport
gives image and symbol-based profile summaries for the whole system or
can produce a gprof-format profile for a single binary.
.SH PROFILE SPECIFICATIONS
-All of the post-profiling tools can take profile specifications,
-which is some combination of the following parameters. Enclosing
-part of a profile specification in curly braces { } can be used
+Various optional profile specifications may be used with the
+post-profiling tools. A profile specification is some combination of the parameters
+listed below. (
+.BR Note :
+Enclosing part of a profile specification in curly braces { } can be used
for differential profiles with
-.B opreport
-; the braces
+.BR opreport ,
+but the braces
.B must
-be surrounded by whitespace.
+be surrounded by whitespace.)
.TP
.BI "archive:"archive
.BI "image:"imagelist
A comma-separated list of image names to resolve. Each entry may be relative
path, glob-style name, or full path, e.g.
-opreport 'image:/usr/bin/oprofiled,*op*,./oprofpp'
+opreport 'image:/usr/bin/operf,*op*,./oprofpp'
.br
.TP
.BI "image-exclude:"imagelist
This is only useful when using per-process profile separation.
.SH ENVIRONMENT
-No special environment variables are recognised by oprofile.
+No special environment variables are recognized by OProfile.
.SH FILES
.TP
-.I $HOME/.oprofile/
-Configuration files
+.I /usr/local/share/doc/oprofile/oprofile.html
+OProfile user guide.
+.TP
+.I /usr/local/share/doc/oprofile/opreport.xsd
+Schema file for opreport XML output.
.TP
-.I /root/.oprofile/daemonrc
-Configuration file for opcontrol
+.I /usr/local/share/doc/oprofile/ophelp.xsd
+Schema file for ophelp XML output.
.TP
.I /usr/local/share/oprofile/
Event description files used by OProfile.
.TP
-.I /var/lib/oprofile/samples/oprofiled.log
-The user-space daemon logfile.
-.TP
-.I /dev/oprofile
-The device filesystem for communication with the Linux kernel module.
+.I <session-dir>/samples/operf.log
+The profiler log file.
.TP
-.I /var/lib/oprofile/samples/
+.I <session-dir>/samples/current
The location of the generated sample files.
.SH VERSION
.TP
-This man page is current for oprofile-0.9.8.
+This man page is current for oprofile-1.1.0.
.SH SEE ALSO
.BR /usr/local/share/doc/oprofile/,
-.BR opcontrol(1),
+.BR operf(1),
+.BR ocount(1),
.BR opreport(1),
.BR opannotate(1),
.BR oparchive(1),
.BR opgprof(1),
.BR gprof(1),
-.BR readprofile(1),
.BR "CPU vendor architecture manuals"
.SH COPYRIGHT
projects / platform / upstream / oprofile.git / blobdiff