NAME
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
SYNOPSIS
operf [ options ] ocount [ options ] opreport [ options ] [ profile specification ] opannotate [ options ] [ profile specification ] oparchive [ options ] [ profile specification ] opgprof [ options ] [ profile specification ]
DESCRIPTION
OProfile is a profiling system for systems running Linux 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. For a gentle guide to using OProfile, please read the HTML documentation listed in SEE ALSO.
OPERF
operf is a performance profiler tool for Linux.
OCOUNT
ocount is an event counting tool for Linux.
OPREPORT
opreport gives image and symbol-based profile summaries for the whole system or a subset of binary images.
OPANNOTATE
opannotate can produce annotated source or mixed source and assembly output.
OPARCHIVE
oparchive produces oprofile archive for offline analysis
OPGPROF
opgprof can produce a gprof-format profile for a single binary.
PROFILE SPECIFICATIONS
Various optional profile specifications may be used with the post-
profiling tools. A profile specification is some combination of the
parameters listed below. ( Note: Enclosing part of a profile
specification in curly braces { } can be used for differential profiles
with opreport, but the braces must be surrounded by whitespace.)
archive:archive
Path to the archive to inspect, as generated by oparchive
session:sessionlist
A comma-separated list of session names to resolve in. Absence
of this tag, unlike all others, means "the current session",
equivalent to specifying "session:current".
session-exclude:sessionlist
A comma-separated list of sessions to exclude.
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/operf,*op*,./oprofpp'
image-exclude:imagelist
Same as image:, but the matching images are excluded.
lib-image:imagelist
Same as image:, but only for images that are for a particular
primary binary image (namely, an application). This only makes
sense to use if you're using --separate. This includes kernel
modules and the kernel when using --separate=kernel.
lib-image-exclude:imagelist
Same as <option>lib-image:</option>, but the matching images are
excluded.
event:eventname
The symbolic event name to match on, e.g. event:DATA_MEM_REFS.
count:eventcount
The event count to match on, e.g. event:DATA_MEM_REFS
count:30000.
unit-mask:maskvalue
The unit mask value of the event to match on, e.g. unit-mask:1.
cpu:cpulist
Only consider profiles for the given numbered CPU (starting from
zero). This is only useful when using CPU profile separation.
tgid:pidlist
Only consider profiles for the given task groups. Unless some
program is using threads, the task group ID of a process is the
same as its process ID. This option corresponds to the POSIX
notion of a thread group. This is only useful when using per-
process profile separation.
tid:tidlist
Only consider profiles for the given threads. When using recent
thread libraries, all threads in a process share the same task
group ID, but have different thread IDs. You can use this option
in combination with tgid: to restrict the results to particular
threads within a process. This is only useful when using per-
process profile separation.
ENVIRONMENT
No special environment variables are recognized by OProfile.
FILES
/usr/share/doc/oprofile/oprofile.html
OProfile user guide.
/usr/share/doc/oprofile/opreport.xsd
Schema file for opreport XML output.
/usr/share/doc/oprofile/ophelp.xsd
Schema file for ophelp XML output.
/usr/share/oprofile/
Event description files used by OProfile.
<session-dir>/samples/operf.log
The profiler log file.
<session-dir>/samples/current
The location of the generated sample files.
VERSION
This man page is current for oprofile-1.1.0.
SEE ALSO
/usr/share/doc/oprofile/, operf(1), ocount(1), opreport(1), opannotate(1), oparchive(1), opgprof(1), gprof(1), CPU vendor architecture manuals
COPYRIGHT
oprofile is Copyright (C) 1998-2004 University of Manchester, UK, John Levon, and others. OProfile is released under the GNU General Public License, Version 2, or (at your option) any later version.
AUTHORS
John Levon <levon@movementarian.org> is the primary author. See the documentation for other contributors.
More Linux Commands
manpages/_tracef.3ncurses.html
_tracef(3ncurses) - curses debugging routines (Man Page)....
The trace routines are used for debugging the ncurses libraries, as well as applications which use the ncurses libraries. These functions are normally available
manpages/isnormal.3.html
isnormal(3) - floating-point classification macros (ManPage)
Floating point numbers can have special values, such as infinite or NaN. With the macro fpclassify(x) you can find out what type x is. The macro takes any float
manpages/set_field_opts.3form.html
set_field_opts(3form) - set and get field options (ManPage)
The function set_field_opts sets all the given fields option bits (field option bits may be logically-ORed together). The function field_opts_on turns on the gi
manpages/XF86VidModeGetDotClocks.3.html
XF86VidModeGetDotClocks(3) - Extension library for the XFree
These functions provide an interface to the server extension XFree86-VidModeExtension which allows the video modes to be queried and adjusted dynamically and mo
manpages/sasl_setprop.3.html
sasl_setprop(3) - Set a SASL property - Linux manual page...
sasl_setprop sets the value of a SASL property. For example an application should tell the SASL library about any external negotiated security layer (i.e. TLS).
manpages/field_validation.3form.html
field_validation(3form) - data type validation for fields...
The function set_field_type declares a data type for a given form field. This is the type checked by validation functions. The predefined types are as follows:
manpages/seed48.3.html
seed48(3) - generate uniformly distributed pseudo-random num
These functions generate pseudo-random numbers using the linear congruential algorithm and 48-bit integer arithmetic. The drand48() and erand48() functions retu
manpages/strchrnul.3.html
strchrnul(3) - locate character in string - Linux man page
The strchr() function returns a pointer to the first occurrence of the character c in the string s. The strrchr() function returns a pointer to the last occurre
manpages/Tk_DeleteEventHandler.3.html
Tk_DeleteEventHandler(3) - associate procedure callback with
Tk_CreateEventHandler arranges for proc to be invoked in the future whenever one of the event types specified by mask occurs in the window specified by tkwin. T
manpages/mcprint_sp.3ncurses.html
mcprint_sp(3ncurses) - curses screen-pointer extension......
This implementation can be configured to provide a set of functions which improve the ability to manage multiple screens. This feature can be added to any of th
manpages/term.5.html
term(5) - format of compiled term file. - Linux manual page
STORAGE LOCATION Compiled terminfo descriptions are placed under the directory /usr/share/terminfo. Two configurations are supported (when building the ncurses
manpages/gnutls_psk_set_client_credentials_function.3.html
gnutls_psk_set_client_credentials_function.3................
This function can be used to set a callback to retrieve the username and password for client PSK authentication. The callbacks function form is: int (*callback)
