Important Default Behaviour

As in library benchmarks, the environment variables are cleared before running a binary benchmark. This can be changed in the Configuration or via the command-line arguments --env-clear and --envs Gungraun sometimes deviates from the Valgrind defaults which are:

As shown in the table above, the benchmarks run with cache simulation switched on. This adds run time for each benchmark. If you don't need the cache metrics and estimation of cycles, you can easily switch cache simulation off for example with

#![allow(unused)]
fn main() {
extern crate gungraun;
use gungraun::prelude::*;
use gungraun::Callgrind;

BinaryBenchmarkConfig::default().tool(Callgrind::with_args(["--cache-sim=no"]));
}

To switch off cache simulation for all benchmarks in the same file:

extern crate gungraun;
macro_rules! env { ($m:tt) => {{ "/some/path" }} }
use gungraun::prelude::*;
use gungraun::Callgrind;

#[binary_benchmark]
fn bench_binary() -> gungraun::Command {
    gungraun::Command::new(env!("CARGO_BIN_EXE_my-foo"))
}

binary_benchmark_group!(name = my_group, benchmarks = bench_binary);
fn main() {
main!(
    config = BinaryBenchmarkConfig::default()
        .tool(Callgrind::with_args(["--cache-sim=no"])),
    binary_benchmark_groups = my_group
);
}