[4ba6cc]: docs / man3 / libpfm_intel_x86_arch.3  Maximize  Restore  History

Download this file

59 lines (55 with data), 2.2 kB

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
.TH LIBPFM 4 "September, 2009" "" "Linux Programmer's Manual"
.SH NAME
libpfm_intel_x86_arch - support for Intel X86 architectural PMU
.SH SYNOPSIS
.nf
.B #include <perfmon/pfmlib.h>
.sp
.B PMU name: ix86arch
.B PMU desc: Intel X86 architectural PMU
.sp
.SH DESCRIPTION
The library supports \fbany\fR processor implementing the Intel architectural PMU. This is a
minimal PMU with a variable number of counters but predefined set of events. It is implemented
in all recent processors starting with Intel Core Duo/Core Solo.
It acts as a default PMU support in case the library is run on a very recent processor for which
the specific support has not yet been implemented.
.SH MODIFIERS
The following modifiers are supported on Intel architectural PMU:
.TP
.B u
Measure at user level which includes privilege levels 1, 2, 3. This is a boolean modifier.
.TP
.B k
Measure at kernel level which includes privilege level 0. This is a boolean modifier.
.TP
.B i
Invert the meaning of the event. The counter will now count cycles in which the event is \fBnot\fR
occurring. This is a boolean modifier
.TP
.B e
Enable edge detection, i.e., count only when there is a state transition. This is a boolean modifier.
.TP
.B c
Set the counter mask value. The mask acts as a threshold. The counter will count the number of cycles
in which the number of occurrences of the event is greater or equal to the threshold. This is an integer
modifier with values in the range [0:255].
.TP
.B t
Measure on both threads at the same time assuming hyper-threading is enabled. This modifier requires
at least version 3 of the architectural PMU. This is a boolean modifier.
.SH ENVIRONMENT VARIABLES
It is possible to force activation of the Intel X86 architectural PMU support using the \fBLIBPFM_FORCE_PMU\fR variable.
The PMU name, ix8arch, must be passed. The following additional options may be passed using the syntax below:
.ce
.B LIBPFM_FORCE_PMU=ix86arch,version
Where the components of the string are defined as follows:
.TP
.B version
The desired architectural PMU revision number, which starts at 1. If the number is not supported, the highest know
version will be used.
.SH AUTHORS
.nf
Stephane Eranian <eranian@gmail.com>
.if
.PP

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:





No, thanks