pmccontrol(8)
NAME
- pmccontrol - control hardware performance monitoring coun
- ters
SYNOPSIS
pmccontrol [-c cpu | -d pmc | -e pmc] ... pmccontrol -l pmccontrol -L pmccontrol -s
DESCRIPTION
- The pmccontrol utility controls the operation of the sys
- tem's hardware
performance monitoring counters.
OPTIONS
- The pmccontrol utility processes options in command line or
- der, so later
options modify the effect of earlier ones. The following - options are
available: - -c cpu Subsequent enable and disable options affect the CPU
- denoted by
- cpu. The argument cpu is either a number denoting a
- CPU number
in the system, or the string ``*'', denoting all - CPUs in the system.
- -d pmc Disable PMC number pmc on the CPU specified by -c,
- preventing it
- from being used till subsequently re-enabled. The
- argument pmc
is either a number denoting a specified PMC, or the - string ``*''
denoting all the PMCs on the specified CPU. - Only idle PMCs may be disabled.
- -e pmc Enable PMC number pmc, on the CPU specified by -c,
- allowing it to
- be used in the future. The argument pmc is either a
- number
denoting a specified PMC, or the string ``*'' denot - ing all the
PMCs on the specified CPU. If PMC pmc is already - enabled, this
option has no effect. - -l List available hardware performance counters and
- their current
- disposition.
- -L List available hardware performance counter classes
- and their
- supported event names.
- -s Print driver statistics maintained by hwpmc(4).
EXAMPLES
- To disable all PMCs on all CPUs, use the command:
- pmccontrol -d*
- To enable all PMCs on all CPUs, use:
- pmccontrol -e*
- To disable PMCs 0 and 1 on CPU 2, use:
- pmccontrol -c2 -d0 -d1
- To disable PMC 0 of CPU 0 only, and enable all other PMCS on
- all other
CPUs, use: - pmccontrol -c* -e* -c0 -d0
DIAGNOSTICS SEE ALSO
pmc(3), pmclog(3), hwpmc(4), pmcstat(8), sysctl(8)
HISTORY
The pmccontrol utility first appeared in FreeBSD 6.0.
AUTHORS
- Joseph Koshy <jkoshy@FreeBSD.org>
- BSD December 15, 2003