|
|
| |
PMC.K7(3) |
FreeBSD Library Functions Manual |
PMC.K7(3) |
pmc.k7 —
measurement events for AMD Athlon (K7 family) CPUs
Performance Counters Library (libpmc, -lpmc)
AMD K7 PMCs are present in the AMD Athlon series of CPUs and are documented in:
AMD Athlon Processor x86 Code Optimization
Guide, Publication No. 22007,
Advanced Micro Devices, Inc.,
February 2002.
AMD K7 PMCs are 48 bits wide. Each K7 CPU contains 4 PMCs with the following
capabilities:
Capability |
Support |
PMC_CAP_CASCADE |
No |
PMC_CAP_EDGE |
Yes |
PMC_CAP_INTERRUPT |
Yes |
PMC_CAP_INVERT |
Yes |
PMC_CAP_READ |
Yes |
PMC_CAP_PRECISE |
No |
PMC_CAP_SYSTEM |
Yes |
PMC_CAP_TAGGING |
No |
PMC_CAP_THRESHOLD |
Yes |
PMC_CAP_USER |
Yes |
PMC_CAP_WRITE |
Yes |
Event specifiers for AMD K7 PMCs can have the following optional qualifiers:
count= value
- Configure the counter to increment only if the number of configured events
measured in a cycle is greater than or equal to
value.
edge
- Configure the counter to only count negated-to-asserted transitions of the
conditions expressed by the other qualifiers. In other words, the counter
will increment only once whenever a given condition becomes true,
irrespective of the number of clocks during which the condition remains
true.
inv
- Invert the sense of comparison when the
“
count ” qualifier is present, making
the counter to increment when the number of events per cycle is less than
the value specified by the “count ”
qualifier.
os
- Configure the PMC to count events happening at privilege level 0.
unitmask= mask
- This qualifier is used to further qualify a select few events,
“
k7-dc-refills-from-l2 ”,
“k7-dc-refills-from-system ” and
“k7-dc-writebacks ”. Here
mask is a string of the following characters
optionally separated by ‘+ ’
characters:
m
- Count operations for lines in the “Modified” state.
o
- Count operations for lines in the “Owner” state.
e
- Count operations for lines in the “Exclusive”
state.
s
- Count operations for lines in the “Shared” state.
i
- Count operations for lines in the “Invalid” state.
If no “unitmask ”
qualifier is specified, the default is to count events for caches lines
in any of the above states.
usr
- Configure the PMC to count events occurring at privilege levels 1, 2 or
3.
If neither of the “os ” or
“usr ” qualifiers were specified, the
default is to enable both.
The following table shows the mapping between the PMC-independent aliases
supported by Performance Counters Library (libpmc,
-lpmc) and the underlying hardware events used.
The pmc library first appeared in
FreeBSD 6.0.
The Performance Counters Library (libpmc, -lpmc) library
was written by Joseph Koshy
<jkoshy@FreeBSD.org>.
Visit the GSP FreeBSD Man Page Interface. Output converted with ManDoc. |