cargo-bench man page

cargo-bench — Execute benchmarks of a package

Synopsis

cargo bench [Options] [--] [<ARGS>...]

Description

Execute all benchmarks of a local package.

All of the trailing arguments are passed to the benchmark binaries generated for filtering benchmarks and generally providing options configuring how they run.

If the --package argument is given, then SPEC is a package id specification which indicates which package should be built. If it is not given, then the current package is built. For more information on SPEC and its format, see the "cargo help pkgid" command.

The --jobs argument affects the building of the benchmark executable but does not affect how many jobs are used when running the benchmarks.

Compilation can be customized with the 'bench' profile in the manifest.

Options

-h, --help

Print this message.

--lib

Benchmark only this package's library.

--bin NAME

Benchmark only the specified binary.

--example NAME

Benchmark only the specified example.

--test NAME

Benchmark only the specified test target.

--bench NAME

Benchmark only the specified bench target.

--no-run

Compile, but don't run benchmarks.

-p SPEC, --package SPEC ...

Package to benchmarks for.

-j IN, --jobs IN

Number of parallel jobs, defaults to # of CPUs.

--release

Build artifacts in release mode, with optimizations.

--features FEATURES

Space-separated list of features to also build.

--all-features

Build all available features.

--no-default-features

Do not build the default feature.

--target TRIPLE

Build for the target triple.

--manifest-path PATH

Path to the manifest to compile.

-v, --verbose

Use verbose output.

-q, --quiet

No output printed to stdout.

--color WHEN

Coloring: auto, always, never.

Examples

Execute all the benchmarks of the current package

$ cargo bench

Execute the BENCH benchmark

$ cargo bench --bench BENCH

See Also

cargo(1), cargo-build(1), cargo-test(1)

Referenced By

cargo(1).

May 2016 The Rust package manager Cargo Manual