Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

opcontrol(1) [v7 man page]

OPCONTROL(1)						      General Commands Manual						      OPCONTROL(1)

NAME
opcontrol - control OProfile profiling SYNOPSIS
opcontrol [ options ] DESCRIPTION
opcontrol can be used to start profiling, end a profiling session, dump profile data, and set up the profiling parameters. OPTIONS
--help Show help message. --version Show version. --list-events Shows the monitorable events. --init Load the OProfile module if required and make the OProfile driver interface available. --setup Followed by list options for profiling setup. Store setup in ~root/.oprofile/daemonrc. Optional. --status Show configuration information. --start-daemon Start the oprofile daemon without starting profiling. Not available in 2.2/2.4 kernels. --start Start data collection with either arguments provided by --setup or with information saved in ~root/.oprofile/daemonrc. --dump Force a flush of the collected profiling data to the daemon. --stop Stop data collection. Not available in 2.2/2.4 kernels. --shutdown Stop data collection and kill the daemon. --reset Clear out data from current session, but leaves saved sessions. --save=sessionname Save data from current session to sessionname. --deinit Shut down daemon. Unload the oprofile module and oprofilefs. --session-dir=dir_path Use sample database out of directory dir_path instead of the default location (/var/lib/oprofile). --buffer-size=num Set kernel buffer to num samples. When using a 2.6 kernel buffer watershed need to be tweaked when changing this value. --buffer-watershed=num Set kernel buffer watershed to num samples (2.6 only). When it'll remain only buffer-size - buffer-watershed free entry in the ker- nel buffer data will be flushed to daemon, most usefull value are in the range [0.25 - 0.5] * buffer-size. --cpu-buffer-size=num Set kernel per cpu buffer to num samples (2.6 only). If you profile at high rate it can help to increase this if the log file show excessive count of sample lost cpu buffer overflow. --event=[event|"default"] Specify an event to measure for the hardware performance counters, or "default" for the default event. The event is of the form "CPU_CLK_UNHALTED:30000:0:1:1" where the numeric values are count, unit mask, kernel-space counting, user-space counting, respec- tively. Note that this over-rides all previous events selected; if you want two or more counters used simultaneously, you must specify them on the same opcontrol invocation. --separate=[none,lib,kernel,thread,cpu,all] Separate samples based on the given separator. 'lib' separates dynamically linked library samples per application. 'kernel' sepa- rates kernel and kernel module samples per application; 'kernel' implies 'library'. 'thread' gives separation for each thread and task. 'cpu' separates for each CPU. 'all' implies all of the above options and 'none' turns off separation. --callgraph=#depth Enable callgraph sample collection with a maximum depth. Use 0 to disable callgraph profiling. This option is available on x86 using a 2.6+ kernel with callgraph support enabled. It is also available on PowerPC using a 2.6.17+ kernel. --image=[name,name...|"all"] Only profile the given absolute paths to binaries, or "all" to profile everything (the default). --vmlinux=file vmlinux kernel image. --no-vmlinux Use this when you don't have a kernel vmlinux file, and you don't want to profile the kernel. --verbose Be verbose in the daemon log. This has a high overhead. --kernel-range=start,end Set kernel range vma address in hexadecimal. OPTIONS (specific to Xen) --xen=file Xen image --active-domains=<list> List of domain ids participating in a multi-domain profiling session. If more than one domain is specified in <list> they should be separated using commas. This option can only be used in domain 0 which is the only domain that can coordinate a multi-domain profil- ing session. Including domain 0 in the list of active domains is optional. (e.g. --active-domains=2,5,6 and --active-domains=0,2,5,6 are equivalent) ENVIRONMENT
No special environment variables are recognised by opcontrol. FILES
/root/.oprofile/daemonrc Configuration file for opcontrol /var/lib/oprofile/samples/ The location of the generated sample files. VERSION
This man page is current for oprofile-0.9.6. SEE ALSO
/usr/share/doc/oprofile/, oprofile(1) 4th Berkeley Distribution Tue 06 July 2010 OPCONTROL(1)
Man Page