forked from rust-lang/cargo
-
Notifications
You must be signed in to change notification settings - Fork 0
/
cargo-install.1
161 lines (161 loc) · 3.95 KB
/
cargo-install.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
.TH "CARGO\-INSTALL" "1" "May 2016" "The Rust package manager" "Cargo Manual"
.hy
.SH NAME
.PP
cargo\-install \- Install a Rust binary
.SH SYNOPSIS
.PP
\f[I]cargo install\f[] [OPTIONS] <CRATE>
.PP
\f[I]cargo install\f[] [OPTIONS] \-\-list
.SH DESCRIPTION
.PP
Install a Rust binary
.PP
This command manages Cargo\[aq]s local set of install binary crates.
Only packages which have [[bin]] targets can be installed, and all
binaries are installed into the installation root\[aq]s \f[I]bin\f[]
folder.
The installation root is determined, in order of precedence, by
\f[B]\-\-root\f[], \f[I]$CARGO_INSTALL_ROOT\f[], the
\f[I]install.root\f[] configuration key, and finally the home directory
(which is either \f[I]$CARGO_HOME\f[] if set or \f[I]$HOME/.cargo\f[] by
default).
.PP
There are multiple sources from which a crate can be installed.
The default location is crates.io but the \f[B]\-\-git\f[] and
\f[B]\-\-path\f[] flags can change this source.
If the source contains more than one package (such as \f[I]crates.io\f[]
or a git repository with multiple crates) the \f[B]\f[] argument is
required to indicate which crate should be installed.
.PP
Crates from crates.io can optionally specify the version they wish to
install via the \f[B]\-\-vers\f[] flags, and similarly packages from git
repositories can optionally specify the branch, tag, or revision that
should be installed.
If a crate has multiple binaries, the \f[B]\-\-bin\f[] argument can
selectively install only one of them, and if you\[aq]d rather install
examples the \f[B]\-\-example\f[] argument can be used as well.
.PP
As a special convenience, omitting the <crate> specification entirely
will install the crate in the current directory.
That is, \f[I]install\f[] is equivalent to the more explicit "install
\-\-path .".
.PP
If the source is crates.io or \f[B]\-\-git\f[] then by default the crate will be built in a temporary target directory.
To avoid this, the target directory can be specified by setting the \f[B]CARGO_TARGET_DIR\f[] environment variable to a relative path.
In particular, this can be useful for caching build artifacts on continuous integration systems.
.PP
The \f[B]\-\-list\f[] option will list all installed packages (and their
versions).
.SH OPTIONS
.SS Query options
.TP
.B \-\-list
List all installed packages (and their versions).
.RS
.RE
.SS Specifying what crate to install
.TP
.B \-\-vers \f[I]VERS\f[]
Specify a version to install from crates.io.
.RS
.RE
.TP
.B \-\-git \f[I]URL\f[]
Git URL to install the specified crate from.
.RS
.RE
.TP
.B \-\-branch \f[I]BRANCH\f[]
Branch to use when installing from git.
.RS
.RE
.TP
.B \-\-tag \f[I]TAG\f[]
Tag to use when installing from git.
.RS
.RE
.TP
.B \-\-rev \f[I]SHA\f[]
Specific commit to use when installing from git.
.RS
.RE
.TP
.B \-\-path \f[I]PATH\f[]
Filesystem path to local crate to install.
.RS
.RE
.SS Built and install options
.TP
.B \-h, \-\-help
Print this message.
.RS
.RE
.TP
.B \-j \f[I]N\f[], \-\-jobs \f[I]N\f[]
Number of parallel jobs, defaults to # of CPUs.
.RS
.RE
.TP
.B \-\-features \f[I]FEATURES\f[]
Space\-separated list of features to activate.
.RS
.RE
.TP
.B \-\-all\-features
Build all available features.
.RS
.RE
.TP
.B \-f, \-\-force
Force overwriting existing crates or binaries
.RS
.RE
.TP
.B \-\-no\-default\-features
Do not build the \f[C]default\f[] feature.
.RS
.RE
.TP
.B \-\-debug
Build in debug mode instead of release mode.
.RS
.RE
.TP
.B \-\-bin \f[I]NAME\f[]
Only install the binary NAME.
.RS
.RE
.TP
.B \-\-example \f[I]EXAMPLE\f[]
Install the example EXAMPLE instead of binaries.
.RS
.RE
.TP
.B \-\-root \f[I]DIR\f[]
Directory to install packages into.
.RS
.RE
.TP
.B \-v, \-\-verbose
Use verbose output.
.RS
.RE
.TP
.B \-q, \-\-quiet
No output printed to stdout.
.RS
.RE
.TP
.B \-\-color \f[I]WHEN\f[]
Coloring: auto, always, never.
.RS
.RE
.SH SEE ALSO
.PP
cargo(1), cargo\-search(1), cargo\-publish(1)
.SH COPYRIGHT
.PP
This work is dual\-licensed under Apache 2.0 and MIT terms.
See \f[I]COPYRIGHT\f[] file in the cargo source distribution.