bpkg-pkg-purge(1) General Commands Manual bpkg-pkg-purge(1) NAME bpkg-pkg-purge - purge package SYNOPSIS bpkg pkg-purge [options] pkg DESCRIPTION The pkg-purge command removes the package directory and archive from the filesystem and removes the package from the configuration. Only packages in the fetched and unpacked state (bpkg-pkg-status(1)) can be purged plus broken packages if the --force|-f option is specified (see the option's description for details on purging broken packages). If the --keep|-k option is specified, then the package archive is not removed (see the option's description for details on this mode). PKG-PURGE OPTIONS --keep|-k Keep the package archive. Note that in this mode the package is still retained in the configuration's database in the fetched state. --force|-f Purge a broken package. In this mode bpkg will verify that the package directory and archive no longer exist and then remove the package from the configuration. --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. --stdout-format format Representation format to use for printing to stdout. --jobs|-j num Number of jobs to perform in parallel. --no-result Don't print informational messages about the outcome of performing a command or some of its parts. --structured-result fmt Write the result of performing a command in a structured form. --progress Display progress indicators for long-lasting operations, such as network transfers, building, etc. --no-progress Suppress progress indicators for long-lasting operations, such as network transfers, building, etc. --diag-color Use color in diagnostics. --no-diag-color Don't use color in diagnostics. --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-option opt Additional option to be passed to the fetch program. --fetch-timeout sec The fetch and fetch-like (for example, git) program timeout. --pkg-proxy url HTTP proxy server to use when fetching package manifests and archives from remote pkg repositories. --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. --git-capabilities up=pc Protocol capabilities (pc) for a git repository URL prefix (up). --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. --default-options dir The directory to load additional default options files from. --no-default-options Don't load default options files. --keep-tmp Don't remove the bpkg's temporary directory at the end of the command execution and print its path at the verbosity level 2 or higher. DEFAULT OPTIONS FILES See bpkg-default-options-files(1) for an overview of the default options files. For the pkg-purge command the search start directory is the configuration directory. The following options files are searched for in each directory and, if found, loaded in the order listed: bpkg.options bpkg-pkg-purge.options The following pkg-purge command options cannot be specified in the default options files: --directory|-d BUGS Send bug reports to the users@build2.org mailing list. COPYRIGHT Copyright (c) 2014-2024 the build2 authors. Permission is granted to copy, distribute and/or modify this document under the terms of the MIT License. bpkg 0.17.0 June 2024 bpkg-pkg-purge(1)