Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

cargo-build (1)

Name

cargo-build - Compile the current project

Synopsis

cargo build [OPTIONS]

Description

CARGO-BUILD(1)                   Cargo Manual                   CARGO-BUILD(1)



NAME
       cargo-build - Compile the current project

SYNOPSIS
       cargo build [OPTIONS]

DESCRIPTION
       Compile a local package and all of its dependencies.

       If  the --package argument is given, then SPEC is a package id specifi-
       cation which indicates which package should be built.   If  it  is  not
       given, then the current package is built.  For more information on SPEC
       and its format, see the "cargo help pkgid" command.

       Compilation can be configured via the use of profiles which are config-
       ured in the manifest.  The default profile for this command is dev, but
       passing the --release flag will use the release profile instead.

OPTIONS
       -h, --help
              Print this message.

       -p SPEC, --package SPEC ...
              Package to build.

       -j IN, --jobs IN
              Number of parallel jobs, defaults to # of CPUs.

       --lib  Build only this package's library.

       --bin NAME
              Build only the specified binary.

       --example NAME
              Build only the specified example.

       --test NAME
              Build only the specified test target.

       --bench NAME
              Build only the specified benchmark target.

       --release
              Build artifacts in release mode, with optimizations.

       --all-features
              Build all available features.

       --features FEATURES
              Space-separated list of features to also build.

       --no-default-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.

EXAMPLES
       Build a local package and all of its dependencies

              $ cargo build

       Build a package with optimizations

              $ cargo build --release


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE    |
       +---------------+----------------------+
       |Availability   | developer/rust/cargo |
       +---------------+----------------------+
       |Stability      | Volatile             |
       +---------------+----------------------+
SEE ALSO
       cargo(1)

COPYRIGHT
       This work is dual-licensed under Apache 2.0 and MIT terms.   See  COPY-
       RIGHT file in the cargo source distribution.



NOTES
       This software was built from source available at https://github.com/or-
       acle/solaris-userland.  The original community  source  was  downloaded
       from  https://static.rust-lang.org/dist/rustc-1.28.0-src.tar.xz

       Further information about this software can be found on the open source
       community website at http://www.rust-lang.org/.



The Rust package manager           May 2016                     CARGO-BUILD(1)