cargo-run man page

cargo-run — Run the current package


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


Run the main binary of the local package (src/

If neither --bin nor --example are given, then if the package 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 Cargo.toml 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