= cargo-fetch(1)
:idprefix: cargo_fetch_
:doctype: manpage
:actionverb: Fetch
== NAME
cargo-fetch - Fetch dependencies of a package from the network
== SYNOPSIS
`cargo fetch [_OPTIONS_]`
== DESCRIPTION
If a `Cargo.lock` file is available, this command will ensure that all of the
git dependencies and/or registry dependencies are downloaded and locally
available. Subsequent Cargo commands never touch the network after a `cargo
fetch` unless the lock file changes.
If the lock file is not available, then this command will generate the lock
file before fetching the dependencies.
If `--target` is not specified, then all target dependencies are fetched.
See also the link:https://crates.io/crates/cargo-prefetch[cargo-prefetch]
plugin which adds a command to download popular crates. This may be useful if
you plan to use Cargo without a network with the `--offline` flag.
== OPTIONS
=== Fetch options
include::options-target-triple.adoc[]
=== Display Options
include::options-display.adoc[]
=== Manifest Options
include::options-manifest-path.adoc[]
include::options-locked.adoc[]
=== Common Options
include::options-common.adoc[]
include::section-environment.adoc[]
include::section-exit-status.adoc[]
== EXAMPLES
. Fetch all dependencies:
cargo fetch
== SEE ALSO
man:cargo[1], man:cargo-update[1], man:cargo-generate-lockfile[1]