Man pages sections > man1 > cargo-bench

cargo-bench - Execute benchmarks of a package



cargo-bench - Execute benchmarks of a package


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


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.


-h, --help
Print this message.
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.
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.
Build artifacts in release mode, with optimizations.
--features FEATURES
Space-separated list of features to also build.
Build all available 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.


Execute all the benchmarks of the current package
$ cargo bench
Execute the BENCH benchmark
$ cargo bench --bench BENCH


cargo(1), cargo-build(1), cargo-test(1) This work is dual-licensed under Apache 2.0 and MIT terms. See COPYRIGHT file in the cargo source distribution.
May 2016 The Rust package manager