Struct Raw 

#[non_exhaustive]
pub struct Raw {
    pub config: u64,
    pub config1: u64,
    pub config2: u64,
}

A raw perf counter for the current CPU.

Most CPUs have additional counters beyond those provided by the kernel. Raw events allow you to access those events. Note that the values needed to configure raw events a liable to change between CPU vendors and even different hardware revisions of the same platform.

The event can be chosen by setting the config field. Most events will only need that, but others may require setting the config1 or config2 fields as well.

To find the config values required for counters consult your CPU manual.

• For Intel CPUs, see the Intel Software Developer Manual, volume 3B.
• For AMD, see the AMD BIOS and Kernel Developer Guide.
• Other vendors should have equivalent documentation.

Example:

use perf_event::events::Raw;
use perf_event::{Builder, Group};

// Raw config values for an ARMv8 PMU.
let INSNS_RETIRED: Raw = Raw::new(0x08);
let CPU_CYCLES: Raw = Raw::new(0x11);

let mut group = Group::new()?;
let raw_insns_retired = group.add(&Builder::new(INSNS_RETIRED).include_kernel())?;
let raw_cpu_cycles = group.add(&Builder::new(CPU_CYCLES).include_kernel())?;

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

config: u64

Raw config of the event

config1: u64

Raw config1 of the event

config2: u64

Raw config2 of the event

Implementations

impl Raw

pub const fn new(config: u64) -> Self

Create a new raw event value with the given config value.

This sets all other config fields to zero. For most events this should be sufficient but in other cases methods are provided to set those fields as well.

pub const fn config(self, config: u64) -> Self

Set config

pub const fn config1(self, config1: u64) -> Self

Set config1

pub const fn config2(self, config2: u64) -> Self

Set config2

Trait Implementations

impl Clone for Raw

fn clone(&self) -> Raw

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Raw

impl Debug for Raw

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Raw

impl Event for Raw

fn update_attrs(self, attr: &mut perf_event_attr)

Update the perf_event_attr struct so that it will record the requested event.

fn update_attrs_with_data( self, attr: &mut perf_event_attr, ) -> Option<Arc<dyn EventData>>

Update the perf_event_attr struct so that it will record the requested event.

impl PartialEq for Raw

fn eq(&self, other: &Raw) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Raw