tail head cat sleep
QR code linking to this page

Manual Pages  — PMCCONTROL

NAME

pmccontrol – control hardware performance monitoring counters

CONTENTS

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 argument cpu. The argument cpu is a number denoting a CPU in the system, or "*", denoting all unhalted 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 a number denoting a specific PMC, or "*" 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 a number denoting a specific PMC, or "*" 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 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 <Mt jkoshy@FreeBSD.org>

PMCCONTROL (8) November 9, 2008

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

The last good thing written in C was Franz Schubert's Symphony #9.
— Erwin Dietrich