Struct perf_event::events::Cache

pub struct Cache {
    pub which: WhichCache,
    pub operation: CacheOp,
    pub result: CacheResult,
}

A cache event.

A cache event has three identifying characteristics:

• which cache to observe (which)

• what sort of request it's handling (operation)

• whether we want to count all cache accesses, or just misses (result).

For example, to measure the L1 data cache's miss rate:

// A `Cache` value representing L1 data cache read accesses.
const ACCESS: Cache = Cache {
    which: WhichCache::L1D,
    operation: CacheOp::READ,
    result: CacheResult::ACCESS,
};

// A `Cache` value representing L1 data cache read misses.
const MISS: Cache = Cache { result: CacheResult::MISS, ..ACCESS };

// Construct a `Group` containing the two new counters, from which we
// can get counts over matching periods of time.
let mut group = Group::new()?;
let access_counter = Builder::new().group(&mut group).kind(ACCESS).build()?;
let miss_counter = Builder::new().group(&mut group).kind(MISS).build()?;

Fields

which: WhichCache

Which cache is being monitored? (data, instruction, ...)

operation: CacheOp

What operation is being monitored? (read, write, etc.)

result: CacheResult

All accesses, or just misses?

Trait Implementations

impl Clone for Cache

pub fn clone(&self) -> Cache

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Cache

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

Formats the value using the given formatter.

impl Eq for Cache

impl From<Cache> for Event

pub fn from(hw: Cache) -> Event

Performs the conversion.

impl PartialEq<Cache> for Cache

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralEq for Cache

impl StructuralPartialEq for Cache