Skip site navigation (1)Skip section navigation (2)

FreeBSD Man Pages

Man Page or Keyword Search:
Man Architecture
Apropos Keyword Search (all sections) Output format
home | help
PMCCONTROL(8)		FreeBSD	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
	     denoting 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>

FreeBSD	10.1		       December	15, 2003		  FreeBSD 10.1

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | DIAGNOSTICS | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<http://www.freebsd.org/cgi/man.cgi?query=pmccontrol&sektion=8&manpath=FreeBSD+7.0-RELEASE>

home | help