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

Download this file

libpfm_intel_nhm_unc.3    46 lines (42 with data), 1.5 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
.TH LIBPFM 4 "September, 2009" "" "Linux Programmer's Manual"
.SH NAME
libpfm_intel_nhm_unc- support for Intel Nehalem uncore PMU
.SH SYNOPSIS
.nf
.B #include <perfmon/pfmlib.h>
.sp
.B PMU name: nhm_unc
.B PMU desc: Intel Nehalem uncore
.sp
.SH DESCRIPTION
The library supports the Nehalem uncore PMU as implemented by processors
such as Intel Core i7, and Intel Core i5.
The PMU is located at the socket-level and is therefore shared between
the various cores. By construction it can only measure at all privilege
levels.
.SH MODIFIERS
The following modifiers are supported on Intel Nehalem processors:
.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 o
Causes the queue occupancy counter associated with the event to be cleared (zeroed). This is a boolean
modifier.
.SH ENVIRONMENT VARIABLES
It is possible to force activation of the Intel Nehalem uncore PMU support using the \fBLIBPFM_FORCE_PMU\fR variable.
The PMU name, nhm_unc, must be passed. No additional options are supported.
.SH AUTHORS
.nf
Stephane Eranian <eranian@gmail.com>
.if
.PP