perfcnt

A library to program performance counters in rust.

Documentation

• API Documentation
• See the examples/ directory for more code-snippets on how to use the library to create counters.

Provided Programs

• perfcnt-list: Lists all architecture specific events available on the current machine (currently only supports Intel x86).

Known limitations

• Linux support without breakpoints and tracepoints
• No Windows or MacOS X support
• Missing raw AMD and ARM aarch64 events

lib.rs:

Example usage:

use perfcnt::{AbstractPerfCounter, PerfCounter};
use perfcnt::linux::{PerfCounterBuilderLinux, HardwareEventType};

let mut pc: PerfCounter =
    PerfCounterBuilderLinux::from_hardware_event(HardwareEventType::CacheMisses)
        .finish().expect("Could not create the counter");
pc.start().expect("Can not start the counter");
pc.stop().expect("Can not start the counter");
let res = pc.read().expect("Can not read the counter");
println!("Measured {} cache misses.", res);