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.

--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 of 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 remove 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.

--buffer-size=num
    Set kernel buffer to num samples.

--ctrN-event=[name|none]
    Set counter N to measure symbolic event name, or to the string 'none' to disable the counter.

--ctrN-count=val
    Number of events between samples for counter N.

--ctrN-unit-mask=val
    Set unit mask for counter N (e.g. --ctr0-unit-mask=0xf).

--ctrN-kernel=[0|1]
    Count events in kernel mode when 1, do not count when 0 (default 1).

--ctrN-user=[0|1]
    Count events in user mode when 1, do not count when 0 (default 1).

--pid-filter=pid
    Only profile process pid (only available for 2.4 version). Set to 'none' to enable profiling of all PIDs again.

--pgrp-filter=pgrp
    Only profile process tty group pgrp (only available for 2.4 version). Set to 'none' to enable profiling of all PIDs again.

--separate=[none,library,kernel,all]
    Separate samples based on the given separator. 'library' per-application dynamically linked libraries samples files. 'kernel' per-application modules and kernel samples files, 'kernel' imply 'library'. 'all' imply all the above options and 'none' turns off separation.

--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.

ENVIRONMENT
No special environment variables are recognised by opreport.

FILES

/home/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.6.

SEE ALSO
oprofile(1)