19 releases

0.8.0 Mar 3, 2022
0.7.1 Apr 7, 2021
0.7.0 Feb 27, 2021
0.6.0 Jun 18, 2020
0.0.2 Nov 29, 2015

#329 in Hardware support

Download history 308/week @ 2022-12-05 324/week @ 2022-12-12 190/week @ 2022-12-19 481/week @ 2022-12-26 195/week @ 2023-01-02 243/week @ 2023-01-09 209/week @ 2023-01-16 199/week @ 2023-01-23 389/week @ 2023-01-30 354/week @ 2023-02-06 432/week @ 2023-02-13 394/week @ 2023-02-20 212/week @ 2023-02-27 301/week @ 2023-03-06 308/week @ 2023-03-13 389/week @ 2023-03-20

1,242 downloads per month
Used in 7 crates

MIT license

115KB
2.5K SLoC

perfcnt Build Status Crates.io

A library to program performance counters in rust.

Documentation

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);

Dependencies

~4MB
~45K SLoC