Unix/Linux Go Back    


CentOS 7.0 - man page for oprofile (centos section 1)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


OPROFILE(1)									      OPROFILE(1)

NAME
       oprofile - a system-wide profiler

SYNOPSIS
       opcontrol [ 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 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 proces-
       sors, and uses a timer-interrupt based mechanism on CPUs without counters.   OProfile  can
       profile the whole system in high detail.
       For  a  gentle  guide  to using OProfile, please read the HTML documentation listed in SEE
       ALSO.

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

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
       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 for differential profiles with opreport ; 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:cur-
	      rent".

       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/opro-
	      filed,*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 recognised by oprofile.

FILES
       $HOME/.oprofile/
	      Configuration files

       /root/.oprofile/daemonrc
	      Configuration file for opcontrol

       /usr/share/oprofile/
	      Event description files used by OProfile.

       /var/lib/oprofile/samples/oprofiled.log
	      The user-space daemon logfile.

       /dev/oprofile
	      The device filesystem for communication with the Linux kernel module.

       /var/lib/oprofile/samples/
	      The location of the generated sample files.

VERSION
       This man page is current for oprofile-0.9.9.

SEE ALSO
       /usr/share/doc/oprofile/,  opcontrol(1),  opreport(1),  opannotate(1),  oparchive(1), opg-
       prof(1), gprof(1), readprofile(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.

4th Berkeley Distribution		 Tue 10 June 2014			      OPROFILE(1)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 05:42 AM.