FreeBSD Manual Pages
PMCCONTROL(8) BSD System Manager's Manual PMCCONTROL(8) NAME pmccontrol -- control hardware performance monitoring counters SYNOPSIS pmccontrol [-c cpu | -d pmc | -e pmc] ... pmccontrol -l pmccontrol -L pmccontrol -s DESCRIPTION The pmccontrol utility controls the operation of the system's hardware performance monitoring counters. OPTIONS The pmccontrol utility processes options in command line order, 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 sys- tem. -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 de- noting a specified PMC, or the string "*" denoting 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 The pmccontrol utility exits 0 on success, and >0 if an error occurs. 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 BSD
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | DIAGNOSTICS | SEE ALSO | HISTORY | AUTHORS
Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pmccontrol&sektion=8&manpath=FreeBSD+7.0-RELEASE>