cargo-uninstall(1)

1CARGO-UNINSTALL(1)          General Commands Manual         CARGO-UNINSTALL(1)
2
3
4

NAME

6       cargo-uninstall - Remove a Rust binary
7

SYNOPSIS

9       cargo uninstall [options] [spec...]
10

DESCRIPTION

12       This command removes a package installed with cargo-install(1). The
13       spec argument is a package ID specification of the package to remove
14       (see cargo-pkgid(1)).
15
16       By default all binaries are removed for a crate but the --bin and
17       --example flags can be used to only remove particular binaries.
18
19       The installation root is determined, in order of precedence:
20
21       •  --root option
22
23       •  CARGO_INSTALL_ROOT environment variable
24
25       •  install.root Cargo config value
26           <https://doc.rust-lang.org/cargo/reference/config.html>
27
28       •  CARGO_HOME environment variable
29
30       •  $HOME/.cargo
31

OPTIONS

33   Install Options
34       -p, --package spec...
35           Package to uninstall.
36
37       --bin name...
38           Only uninstall the binary name.
39
40       --root dir
41           Directory to uninstall packages from.
42
43   Display Options
44       -v, --verbose
45           Use verbose output. May be specified twice for "very verbose"
46           output which includes extra output such as dependency warnings and
47           build script output. May also be specified with the term.verbose
48           config value
49           <https://doc.rust-lang.org/cargo/reference/config.html>.
50
51       -q, --quiet
52           Do not print cargo log messages. May also be specified with the
53           term.quiet config value
54           <https://doc.rust-lang.org/cargo/reference/config.html>.
55
56       --color when
57           Control when colored output is used. Valid values:
58
59           •  auto (default): Automatically detect if color support is
60               available on the terminal.
61
62           •  always: Always display colors.
63
64           •  never: Never display colors.
65
66           May also be specified with the term.color config value
67           <https://doc.rust-lang.org/cargo/reference/config.html>.
68
69   Common Options
70       +toolchain
71           If Cargo has been installed with rustup, and the first argument to
72           cargo begins with +, it will be interpreted as a rustup toolchain
73           name (such as +stable or +nightly). See the rustup documentation
74           <https://rust-lang.github.io/rustup/overrides.html> for more
75           information about how toolchain overrides work.
76
77       --config KEY=VALUE or PATH
78           Overrides a Cargo configuration value. The argument should be in
79           TOML syntax of KEY=VALUE, or provided as a path to an extra
80           configuration file. This flag may be specified multiple times. See
81           the command-line overrides section
82           <https://doc.rust-lang.org/cargo/reference/config.html#command-line-overrides>
83           for more information.
84
85       -h, --help
86           Prints help information.
87
88       -Z flag
89           Unstable (nightly-only) flags to Cargo. Run cargo -Z help for
90           details.
91

ENVIRONMENT

93       See the reference
94       <https://doc.rust-lang.org/cargo/reference/environment-variables.html>
95       for details on environment variables that Cargo reads.
96

EXIT STATUS

98       •  0: Cargo succeeded.
99
100       •  101: Cargo failed to complete.
101

EXAMPLES

103        1. Uninstall a previously installed package.
104
105               cargo uninstall ripgrep
106