NAME

bpkg-pkg-uninstall – uninstall package

SYNOPSIS

bpkg pkg-uninstall|uninstall [options] [vars] (pkg [vars])...
bpkg pkg-uninstall|uninstall [options] [vars] --all|-a

DESCRIPTION

The pkg-uninstall command uninstalls the specified packages (the first form) or all held packages (the second form, see bpkg-pkg-status(1)). Additionally, immediate or all dependencies of these specified packages can be also uninstalled by specifying the --immediate|-i or --recursive|-r options, respectively. Underneath, this command doesn't do much more than run b uninstall.

In the first form the specified packages must have been previously configured with bpkg-pkg-build(1) or bpkg-pkg-configure(1). Additional command line variables (vars, normally config.*) can be passed to the build system by either specifying them before the packages, in which case they apply to the whole configuration, or after a specific package, in which case they apply only to this package. See bpkg-pkg-install(1) for some examples.

PKG-UNINSTALL OPTIONS

--all|-a
Uninstall all held packages.
--immediate|-i
Also uninstall immediate dependencies.
--recursive|-r
Also uninstall all dependencies, recursively.
--directory|-d dir
Assume configuration is in dir rather than in the current working directory.

COMMON OPTIONS

The common options are summarized below with a more detailed description available in bpkg-common-options(1).

-v
Print essential underlying commands being executed.
-V
Print all underlying commands being executed.
--quiet|-q
Run quietly, only printing error messages.
--verbose level
Set the diagnostics verbosity to level between 0 and 6.
--no-result
Don't print informational messages about the outcome of performing a command.
--build path
The build program to be used to build packages.
--build-option opt
Additional option to be passed to the build program.
--fetch path
The fetch program to be used to download resources.
--fetch-timeout sec
The fetch and fetch-like (for example, git) program timeout.
--fetch-option opt
Additional option to be passed to the fetch program.
--git path
The git program to be used to fetch git repositories.
--git-option opt
Additional common option to be passed to the git program.
--sha256 path
The sha256 program to be used to calculate SHA256 sums.
--sha256-option opt
Additional option to be passed to the sha256 program.
--tar path
The tar program to be used to extract package archives.
--tar-option opt
Additional option to be passed to the tar program.
--openssl path
The openssl program to be used for crypto operations.
--openssl-option opt
Additional option to be passed to the openssl program.
--auth type
Types of repositories to authenticate.
--trust fingerprint
Trust repository certificate with a SHA256 fingerprint.
--trust-yes
Assume the answer to all authentication prompts is yes.
--trust-no
Assume the answer to all authentication prompts is no.
--pager path
The pager program to be used to show long text.
--pager-option opt
Additional option to be passed to the pager program.
--options-file file
Read additional options from file.

BUGS

Send bug reports to the users@build2.org mailing list.