cargo-run man page

cargo-run — Run the current project


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


Run the main binary of the local package (src/

If neither --bin nor --example are given, then if the project only has one bin target it will be run. Otherwise --bin specifies the bin target to run, and --example specifies the example target to run. At most one of --bin or --example can be provided.

All of the trailing arguments are passed to the binary to run. If you're passing arguments to both Cargo and the binary, the ones after -- go to the binary, the ones before go to Cargo.


-h, --help
Print this message.
--bin NAME
Name of the bin target to run.
--example NAME
Name of the example target to run.
-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.


Run the main binary of the current package

$ cargo run

See Also

cargo(1), cargo-new(1), cargo-init(1), cargo-build(1)

Referenced By

cargo(1), cargo-rustc(1).

May 2016 The Rust package manager Cargo Manual