| = cargo-run(1) |
| :idprefix: cargo_run_ |
| :doctype: manpage |
| :actionverb: Run |
| |
| == NAME |
| |
| cargo-run - Run the current package |
| |
| == SYNOPSIS |
| |
| `cargo run [_OPTIONS_] [-- _ARGS_]` |
| |
| == DESCRIPTION |
| |
| Run a binary or example of the local package. |
| |
| All the arguments following the two dashes (`--`) 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. |
| |
| == OPTIONS |
| |
| === Package Selection |
| |
| include::options-package.adoc[] |
| |
| === Target Selection |
| |
| When no target selection options are given, `cargo run` will run the binary |
| target. If there are multiple binary targets, you must pass a target flag to |
| choose one. |
| |
| *--bin* _NAME_:: |
| Run the specified binary. |
| |
| *--example* _NAME_:: |
| Run the specified example. |
| |
| include::options-features.adoc[] |
| |
| === Compilation Options |
| |
| include::options-target-triple.adoc[] |
| |
| include::options-release.adoc[] |
| |
| === Output Options |
| |
| include::options-target-dir.adoc[] |
| |
| === Display Options |
| |
| include::options-display.adoc[] |
| |
| include::options-message-format.adoc[] |
| |
| === Manifest Options |
| |
| include::options-manifest-path.adoc[] |
| |
| include::options-locked.adoc[] |
| |
| === Common Options |
| |
| include::options-common.adoc[] |
| |
| === Miscellaneous Options |
| |
| include::options-jobs.adoc[] |
| |
| include::section-profiles.adoc[] |
| |
| include::section-environment.adoc[] |
| |
| include::section-exit-status.adoc[] |
| |
| == EXAMPLES |
| |
| . Build the local package and run its main target (assuming only one binary): |
| |
| cargo run |
| |
| . Run an example with extra arguments: |
| |
| cargo run --example exname -- --exoption exarg1 exarg2 |
| |
| == SEE ALSO |
| man:cargo[1], man:cargo-build[1] |