/papi-sys

PAPI bindings for Rust generated with Bindgen

Primary LanguageRustApache License 2.0Apache-2.0

papi-sys

Usage

First, add the following to your Cargo.toml:

[dependencies]
papi-sys = "0.3.0"

Next, add this to your crate root:

extern crate papi-sys;

Before building, ensure that PAPI is installed on your system.

What is papi-sys?

The purpose of this crate is to provide 1:1 bindings for papi.h. PAPI is a library that provides a consistent interface to hardware performance counters. Visit the PAPI website for more information.

Note that this crate does not provide a high-level interface to PAPI.

Environment Variables

There are two environment variables to specify custom PAPI library dependency:

  • PAPI_PREFIX: requires to generate bindings.rs
  • LD_LIBRARY_PATH: requires to link dynamic library libpapi.so

Let's assume you installed PAPI in /opt/papi/5.7.0/, then you can test by

$ PAPI_PREFIX=/opt/papi/5.7.0/ LD_LIBRARY_PATH=/opt/papi/5.7.0/lib:$LD_LIBRARY_PATH cargo test

Platforms

The following platforms are currently tested:

  • x86_64-unknown-linux-gnu, rustc >= 1.36, gcc >= 4.8, clang >= 3.8