bpkg-pkg-disfigure(1)

📦
version 0.17.0 · 2 versions
, in fedora 43, fedora 44, nixos 26.05

💅 bpkg-pkg-disfigure(1) — the manual, but make it make sense

okay bestie, so this is the manual page for bpkg-pkg-disfigure(1), which lives in the General Commands Manual section of the bpkg family. it's the "undo button" of the pkg world and honestly? it ate. let's go 🎀

✨ NAME ✨

bpkg-pkg-disfigure — disfigure package 💀

🌸 SYNOPSIS 🌸

bpkg pkg-disfigure [options] pkg

🦋 DESCRIPTION 🦋

so pkg-disfigure is the girl who takes it all back. it disfigures a package that was previously configured (via bpkg-pkg-build(1) or bpkg-pkg-configure(1)). the vibes go like this:

  • a source code package gets returned to the unpacked state.
  • a system package gets removed from the configuration.

by default, pkg-disfigure will remove the package's build system configuration (config.build) and also clean its output directory. no cap. but you can suppress that behavior with the --keep-config and --keep-out options, respectively — say, if the package is gonna be reconfigured. keeping it cute and reversible, periodt ✨

💖 PKG-DISFIGURE OPTIONS 💖

  • --keep-out — don't clean the package's output directory. leave the mess, bestie 🫶
  • --keep-config — don't remove the package's build system configuration (config.build).
  • --directory|-d _dir_ — assume the configuration is in _dir_ rather than in the current working directory.

👑 COMMON OPTIONS 👑

these are the shared ones, summarized below — the full tea is in bpkg-common-options(1).

  • -v — print essential underlying commands being executed.
  • -V — print all underlying commands being executed. (yes, all of them. it's giving verbose.)
  • --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-disfigure 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-disfigure.options
⚠️ heads up bestie: the following pkg-disfigure command options cannot be specified in the default options files: - --directory|-d

💀 BUGS 💀

found a bug? send bug reports to the users@build2.org mailing list. we listen, we fix, we slay 💅

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.

okay that's the whole page, you're officially a pkg-disfigure girlie now 🫶 this was bpkg 0.17.0, dated June 2024, and it's bpkg-pkg-disfigure(1) — no cap, you got this. bye bestie, go disfigure something (respectfully) ✨💖

📦 where this page comes from