Enum perf_event::events::Hardware

#[repr(u32)]
pub enum Hardware {
    CPU_CYCLES,
    INSTRUCTIONS,
    CACHE_REFERENCES,
    CACHE_MISSES,
    BRANCH_INSTRUCTIONS,
    BRANCH_MISSES,
    BUS_CYCLES,
    STALLED_CYCLES_FRONTEND,
    STALLED_CYCLES_BACKEND,
    REF_CPU_CYCLES,
}

Hardware counters.

These are counters implemented by the processor itself. Such counters vary from one architecture to the next, and even different models within a particular architecture will often change the way they expose this data. This is a selection of portable names for values that can be obtained on a wide variety of systems.

Each variant of this enum corresponds to a particular PERF_COUNT_HW_... value supported by the perf_event_open system call.

Variants

CPU_CYCLES

Total cycles. Be wary of what happens during CPU frequency scaling.

INSTRUCTIONS

Retired instructions. Be careful, these can be affected by various issues, most notably hardware interrupt counts.

CACHE_REFERENCES

Cache accesses. Usually this indicates Last Level Cache accesses but this may vary depending on your CPU. This may include prefetches and coherency messages; again this depends on the design of your CPU.

CACHE_MISSES

Cache misses. Usually this indicates Last Level Cache misses; this is intended to be used in conjunction with the PERF_COUNT_HW_CACHE_REFERENCES event to calculate cache miss rates.

BRANCH_INSTRUCTIONS

Retired branch instructions. Prior to Linux 2.6.35, this used the wrong event on AMD processors.

BRANCH_MISSES

Mispredicted branch instructions.

BUS_CYCLES

Bus cycles, which can be different from total cycles.

STALLED_CYCLES_FRONTEND

Stalled cycles during issue. (since Linux 3.0)

STALLED_CYCLES_BACKEND

Stalled cycles during retirement. (since Linux 3.0)

REF_CPU_CYCLES

Total cycles; not affected by CPU frequency scaling. (since Linux 3.3)

Trait Implementations

impl Clone for Hardware

fn clone(&self) -> Hardware

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Hardware

impl Debug for Hardware

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

Formats the value using the given formatter.

impl Eq for Hardware

impl From<Hardware> for Event

fn from(hw: Hardware) -> Event

Performs the conversion.

impl PartialEq<Hardware> for Hardware

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

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

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl StructuralEq for Hardware

impl StructuralPartialEq for Hardware