mirror of
https://github.com/rust-lang/cargo.git
synced 2025-10-01 11:30:39 +00:00
76918a0e99
We already refer to test targets as "test targets" instead of "tests" in `--test` but not `--tests` or in the error output. This makes it uniformly refer to them as "test targets", making it clearer that these aren't test functions. Fixes #7864
60 lines
2.8 KiB
Plaintext
60 lines
2.8 KiB
Plaintext
Execute all benchmarks of a local package
|
|
|
|
Usage: cargo[EXE] bench [OPTIONS] [BENCHNAME] [-- [ARGS]...]
|
|
|
|
Arguments:
|
|
[BENCHNAME] If specified, only run benches containing this string in their names
|
|
[ARGS]... Arguments for the bench binary
|
|
|
|
Options:
|
|
--no-run Compile, but don't run benchmarks
|
|
--no-fail-fast Run all benchmarks regardless of failure
|
|
--ignore-rust-version Ignore `rust-version` specification in packages
|
|
--message-format <FMT> Error format
|
|
-q, --quiet Do not print cargo log messages
|
|
-v, --verbose... Use verbose output (-vv very verbose/build.rs output)
|
|
--color <WHEN> Coloring: auto, always, never
|
|
--config <KEY=VALUE> Override a configuration value
|
|
-Z <FLAG> Unstable (nightly-only) flags to Cargo, see 'cargo -Z help' for
|
|
details
|
|
-h, --help Print help
|
|
|
|
Package Selection:
|
|
-p, --package [<SPEC>] Package to run benchmarks for
|
|
--workspace Benchmark all packages in the workspace
|
|
--exclude <SPEC> Exclude packages from the benchmark
|
|
--all Alias for --workspace (deprecated)
|
|
|
|
Target Selection:
|
|
--lib Benchmark only this package's library
|
|
--bins Benchmark all binaries
|
|
--bin [<NAME>] Benchmark only the specified binary
|
|
--examples Benchmark all examples
|
|
--example [<NAME>] Benchmark only the specified example
|
|
--tests Benchmark all test targets
|
|
--test [<NAME>] Benchmark only the specified test target
|
|
--benches Benchmark all bench targets
|
|
--bench [<NAME>] Benchmark only the specified bench target
|
|
--all-targets Benchmark all targets
|
|
|
|
Feature Selection:
|
|
-F, --features <FEATURES> Space or comma separated list of features to activate
|
|
--all-features Activate all available features
|
|
--no-default-features Do not activate the `default` feature
|
|
|
|
Compilation Options:
|
|
-j, --jobs <N> Number of parallel jobs, defaults to # of CPUs.
|
|
--profile <PROFILE-NAME> Build artifacts with the specified profile
|
|
--target [<TRIPLE>] Build for the target triple
|
|
--target-dir <DIRECTORY> Directory for all generated artifacts
|
|
--unit-graph Output build graph in JSON (unstable)
|
|
--timings[=<FMTS>] Timing output formats (unstable) (comma separated): html, json
|
|
|
|
Manifest Options:
|
|
--manifest-path <PATH> Path to Cargo.toml
|
|
--frozen Require Cargo.lock and cache are up to date
|
|
--locked Require Cargo.lock is up to date
|
|
--offline Run without accessing the network
|
|
|
|
Run `cargo help bench` for more detailed information.
|