LIBPFM - Online Linux Manual PageSection : 3
Updated : February, 2014
Source :
Note : Linux Programmer's Manual
NAMElibpfm_perf_event_raw - support for perf_events raw events syntax
SYNOPSIS#include <perfmon/pfmlib.h> PMU name: perf_raw PMU desc: Raw perf_events event syntax
DESCRIPTION The library supports a pseudo PMU model to allow raw encodings of PMU events for the Linux perf_events kernel interface. With this PMU, it is possible to provide the raw hexadecimal encoding of any hardware event for any PMU models. The raw encoding is passed as is to the kernel. All events are encoded as PERF_TYPE_RAW. As such, perf_events generic events, such as cycles, instructions, cannot be encoded by this PMU. The syntax is very simple: rX. X is the hexadecimal 64-bit value for the event. It may include event filters on some PMU models. The hexadecimal number is passed without the 0x prefix, e.g., r01c4. The library's standard perf_events attributes are supported by this PMU model. They are separated with colons as is customary with the library.
MODIFIERSThe following modifiers are supported by this PMU model: u  Measure at user level which includes privilege levels 1, 2, 3. This corresponds to PFM_PLM3. This is a boolean modifier. k  Measure at kernel level which includes privilege level 0. This corresponds to PFM_PLM0. This is a boolean modifier. h  Measure at the hypervisor level. This corresponds to PFM_PLMH. This is a boolean modifier mg  Measure guest execution only. This is a boolean modifier mh  Measure host execution only. This is a boolean modifier period  Specify the the sampling period value. Value can be expressed in decimal or hexadecimal. Value is 64-bit wide. This option is mutually exclusive with freq. The period is expressed in the unit of the event. There is no default value. freq  Specify the the sampling frequency value. Value can be expressed in decimal or hexadecimal. Value is 64-bit wide. This options is mutually exclusive with period. The value is expressed in Hertz. For instance, freq=100, means that the event should be sampled 100 times per second on average. There is no default value. excl  The associated event is the only event measured on the PMU. This applies only to hardware events. This attribute requires admin privileges. Default is off. precise  Enables precise sampling mode. This option is only valid when sampling on events. The options takes an integer argument. It can have the following values: 1=enable precise sampling, 2=enable precise sampling and eliminate skid, 3=enable precise sampling, eliminate skid and bias. Not all events necessarily support precise mode at all levels, this is dependent on the underlying PMU. Eliminating skid is a best effort feature. It may not work for all samples. This option is mutually exclusive with hw_smpl. This options implies using the hardware assist sampling mechanism. hw_smpl  Enables hardware assist sampling. This is a boolean option. It is false by default. On some processors, it is possible to have the hardware record samples in a buffer and then notify the kernel when it is full. Such feature may not be available for all events. Using a hardware buffer does not necessarily eliminate skid and bias, it usually lowers the overhead of interrupt-based sampling by amortizing the interrupt over multiple samples. This option is usually implicit with precise sampling events. cpu  This integer option is used with system-wide events, i.e., events attached to a CPU instead of a thread. The value designate the CPU to attach the event to. It is up to the caller of the library to use the cpu field in the library event encoding argument to create the event. No verification on the validity of the CPU number is made by the library. Default value is -1 for this field. pinned  This boolean option is used with system-wide events, i.e., events attached to a CPU instead of a thread. If set, then the event is marked as pinned. That means it needs to remain on the counters at all time, i.e., it cannot be multiplexed. There can only be as many pinned events as there are counters, yet the library does not check for that, the perf_event subsystem does. The default value for this field is false, i.e., the event is not pinned.
AUTHORSStephane Eranian <eranian@gmail.com> ∞.PP 0
Johanes Gumabo
Data Size   :   9,337 byte
man-libpfm_perf_event_raw.3Build   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   3 / 191,658
Visitor ID   :     :  
Visitor IP   :   3.137.221.114   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36
Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.