|
Packit |
577717 |
.TH LIBPFM 3 "September, 2009" "" "Linux Programmer's Manual"
|
|
Packit |
577717 |
.SH NAME
|
|
Packit |
577717 |
libpfm_intel_x86_arch - support for Intel X86 architectural PMU
|
|
Packit |
577717 |
.SH SYNOPSIS
|
|
Packit |
577717 |
.nf
|
|
Packit |
577717 |
.B #include <perfmon/pfmlib.h>
|
|
Packit |
577717 |
.sp
|
|
Packit |
577717 |
.B PMU name: ix86arch
|
|
Packit |
577717 |
.B PMU desc: Intel X86 architectural PMU
|
|
Packit |
577717 |
.sp
|
|
Packit |
577717 |
.SH DESCRIPTION
|
|
Packit |
577717 |
The library supports \fbany\fR processor implementing the Intel architectural PMU. This is a
|
|
Packit |
577717 |
minimal PMU with a variable number of counters but predefined set of events. It is implemented
|
|
Packit |
577717 |
in all recent processors starting with Intel Core Duo/Core Solo.
|
|
Packit |
577717 |
|
|
Packit |
577717 |
It acts as a default PMU support in case the library is run on a very recent processor for which
|
|
Packit |
577717 |
the specific support has not yet been implemented.
|
|
Packit |
577717 |
.SH MODIFIERS
|
|
Packit |
577717 |
The following modifiers are supported on Intel architectural PMU:
|
|
Packit |
577717 |
.TP
|
|
Packit |
577717 |
.B u
|
|
Packit |
577717 |
Measure at user level which includes privilege levels 1, 2, 3. This corresponds to \fBPFM_PLM3\fR.
|
|
Packit |
577717 |
This is a boolean modifier.
|
|
Packit |
577717 |
.TP
|
|
Packit |
577717 |
.B k
|
|
Packit |
577717 |
Measure at kernel level which includes privilege level 0. This corresponds to \fBPFM_PLM0\fR.
|
|
Packit |
577717 |
This is a boolean modifier.
|
|
Packit |
577717 |
.TP
|
|
Packit |
577717 |
.B i
|
|
Packit |
577717 |
Invert the meaning of the event. The counter will now count cycles in which the event is \fBnot\fR
|
|
Packit |
577717 |
occurring. This is a boolean modifier
|
|
Packit |
577717 |
.TP
|
|
Packit |
577717 |
.B e
|
|
Packit |
577717 |
Enable edge detection, i.e., count only when there is a state transition. This is a boolean modifier.
|
|
Packit |
577717 |
.TP
|
|
Packit |
577717 |
.B c
|
|
Packit |
577717 |
Set the counter mask value. The mask acts as a threshold. The counter will count the number of cycles
|
|
Packit |
577717 |
in which the number of occurrences of the event is greater or equal to the threshold. This is an integer
|
|
Packit |
577717 |
modifier with values in the range [0:255].
|
|
Packit |
577717 |
.TP
|
|
Packit |
577717 |
.B t
|
|
Packit |
577717 |
Measure on both threads at the same time assuming hyper-threading is enabled. This modifier requires
|
|
Packit |
577717 |
at least version 3 of the architectural PMU. This is a boolean modifier.
|
|
Packit |
577717 |
|
|
Packit |
577717 |
.SH AUTHORS
|
|
Packit |
577717 |
.nf
|
|
Packit |
577717 |
Stephane Eranian <eranian@gmail.com>
|
|
Packit |
577717 |
.if
|
|
Packit |
577717 |
.PP
|