allocates a performance monitoring counter that measures the events
named by argument
and writes the allocated handle to the location pointed to by argument
comprises an PMC event name followed by an optional comma separated
list of keywords and qualifiers.
The allowed syntax for argument
is processor specific and is listed in section
The desired PMC mode is specified by argument
Legal values for the
Allocate a system-scope counting PMC.
Allocate a system-scope sampling PMC.
Allocate a process-scope counting PMC.
Allocate a process-scope sampling PMC.
Mode specific modifiers may be specified using argument
The flags supported at PMC allocation time are:
PMCs allocated with flags
need a log file to be configured before they are started.
For process-scope PMCs, automatically track descendants of attached
For process-scope counting PMCs, generate a log event at every context
switch containing the incremental number of hardware events seen
by the process during the time it was executing on the CPU.
For process-scope counting PMCs, accumulate hardware events seen
when the process was executing on a CPU and generate a log event
when an attached process exits.
For system scope PMCs, the argument
is a non-negative value that specifies the CPU number
that the PMC is to be allocated on.
Process scope PMC allocations should specify the constant
for this argument.
releases the PMC denoted by argument