Lines Matching +full:cpu +full:- +full:read
1 .\" Copyright (c) 2003-2008 Joseph Koshy. All rights reserved.
40 The library is implemented using the lower-level facilities offered by
50 .Bl -bullet
53 These PMCs measure events in a whole-system manner, i.e., independent
57 Non-privileged process are allowed to allocate system scope PMCs if the
61 is non-zero.
65 attached to are executing on a CPU.
72 .Bl -bullet
76 The application needs to explicitly read these counters
79 Sampling PMCs cause the CPU to be periodically interrupted
90 The library uses human-readable strings to name the event being
99 Additionally, process-scope PMCs have to be attached to one or more
101 A process-scope PMC may be attached to those target processes
105 Additionally, on some machine architectures, such self-attached PMCs
106 may be read cheaply using specialized instructions supported by the
112 .Bl -bullet
132 .Bl -tag -width "Li PMC_CPU_ARMV7_CORTEX_A15" -compact
218 .Bl -tag -width "Li PMC_CLASS_POWER8" -compact
255 .Bl -tag -width "Li PMC_CAP_INTERRUPT" -compact
264 The ability to interrupt the CPU.
274 The ability to read from performance counters.
276 The ability to restrict counting of hardware events to when the CPU is
289 .Ss CPU Naming Conventions
295 Operations on non-existent CPUs will return an error.
300 .Bl -tag -width 2n
302 .Bl -tag -width 6n -compact
310 .Bl -tag -width 6n -compact
316 flag to a human-readable string.
320 constant to a human-readable string.
322 Return a human-readable name for a CPU type.
324 Return a human-readable string describing a PMC's disposition.
326 Convert a numeric event code to a human-readable string.
330 constant to a human-readable name.
332 Return a human-readable string describing a PMC's current state.
335 .Bl -tag -width 6n -compact
341 .Bl -tag -width 6n -compact
358 .Bl -tag -width 6n -compact
364 Read (write) a value from (to) a PMC.
371 .Bl -tag -width 6n -compact
381 Determine the greatest possible CPU number on the system.
383 Return the number of hardware PMCs present in a given CPU.
385 Return information about the state of a given CPU's PMCs.
390 .Bl -tag -width 6n -compact
397 instruction to directly read the contents of the PMC.
402 .Bl -tag -width ".Dv SIGBUS"
417 .Bl -bullet
419 any process-mode PMC allocated by it loses all its
429 .Bl -enum
454 Once started, the values of counting PMCs may be read using function
457 read and parsed using the
479 Event specifiers spellings are case-insensitive and space characters,
483 .Qq "example-event" ,
490 .Bl -column " PMC_CLASS_TSC " "MANUAL PAGE "
498 Event name aliases are PMC-independent names for commonly used events.
502 .Bl -tag -width indent
505 .It Li branch-mispredicts
511 .It Li dc-misses
513 .It Li ic-misses
519 .It Li unhalted-cycles