pmc.iaf(3) [freebsd man page]

PMC.IAF(3)						   BSD Library Functions Manual 						PMC.IAF(3)

NAME

     pmc.iaf -- measurement events for Intel fixed function performance counters.

LIBRARY

     Performance Counters Library (libpmc, -lpmc)

SYNOPSIS

     #include <pmc.h>

DESCRIPTION

     Intel fixed-function PMCs are present in CPUs that conform to version 2 or later of the Intel Performance Measurement Architecture.  Each
     fixed-function PMC measures a specific hardware event.  The number of fixed-function PMCs implemented in a CPU can vary.  The number of
     fixed-function PMCs present can be determined at runtime by using function pmc_cpuinfo(3).

     Intel fixed-function PMCs are documented in "Volume 3: System Programming Guide", IA-32 Intel(R) Architecture Software Developer's Manual,
     Order Number 253669-027US, Intel Corporation, July 2008.

   PMC Capabilities
     Fixed-function PMCs support the following capabilities:

     Capability 	  Support
     PMC_CAP_CASCADE	  No
     PMC_CAP_EDGE	  No
     PMC_CAP_INTERRUPT	  Yes
     PMC_CAP_INVERT	  No
     PMC_CAP_READ	  Yes
     PMC_CAP_PRECISE	  No
     PMC_CAP_SYSTEM	  Yes
     PMC_CAP_TAGGING	  No
     PMC_CAP_THRESHOLD	  No
     PMC_CAP_USER	  Yes
     PMC_CAP_WRITE	  Yes

   Class Name Prefix
     These PMCs are named using a class name prefix of ``iaf-''.

   Event Qualifiers (Fixed Function PMCs)
     These PMCs support the following modifiers:

     os      Configure the PMC to count events occurring at ring level 0.

     usr     Configure the PMC to count events occurring at ring levels 1, 2 or 3.

     anythread
	     (Atom CPUs) Configure the PMC to count events on all logical processors sharing a processor core.	The default is to count events on
	     the current logical processor.

     If neither of the ``os'' or ``usr'' qualifiers are specified, the default is to enable both.

   Event Specifiers (Fixed Function PMCs)
     The fixed function PMCs are selectable using the following event names:

     INSTR_RETIRED.ANY
	     (Fixed Function Counter 0) The number of instructions retired.

     CPU_CLK_UNHALTED.CORE
	     (Fixed Function Counter 1) The number of core cycles for which the core is not halted.

     CPU_CLK_UNHALTED.REF
	     (Fixed Function Counter 2) The number of reference cycles for which the core is not halted.

EXAMPLES

     To measure the number of core cycles for which the core was not halted use the event specifier "iaf-cpu-clk-unhalted.core".

     To measure the number of user instructions retired use the event specifier "iaf-instr-retired.any,usr".

     To measure the number of user instructions retired on all logical processors in an Atom CPU, use the event specifier
     "iaf-instr-retired.any,usr,anythread".

SEE ALSO

     pmc(3), pmc.atom(3), pmc.core(3), pmc.core2(3), pmc.k7(3), pmc.k8(3), pmc.p4(3), pmc.p5(3), pmc.p6(3), pmc.soft(3), pmc.tsc(3),
     pmc_cpuinfo(3), pmclog(3), hwpmc(4)

HISTORY

     The pmc library first appeared in FreeBSD 6.0.

AUTHORS

     The Performance Counters Library (libpmc, -lpmc) library was written by Joseph Koshy <jkoshy@FreeBSD.org>.

BSD
								 November 14, 2008							       BSD

Check Out this Related Man Page

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 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 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
								 November 9, 2008							       BSD

Linux and UNIX Man Pages

pmc.iaf(3) [freebsd man page]

Check Out this Related Man Page