bpkg-cfg-unlink(1)

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

okay bestie, welcome to the bpkg-cfg-unlink page from the General Commands Manual (that's section 1, iykyk). this is the one where we break up with a configuration. respectfully. ✨

🌸 SYNOPSIS 🌸

bpkg cfg-unlink [options] [dir]
bpkg cfg-unlink [options] --dangling

🦋 DESCRIPTION 🦋

so here's the tea. cfg-unlink does one of two things:

  • Form one — it unlinks the configuration you name from the current configuration. it's giving "we're not linked anymore, bestie" 💅
  • Form two — it removes dangling implicit backlinks. yes, it cleans up the ghosts 👻

if you want the whole lore on what linked configurations even are, go read bpkg-cfg-create(1). it has the background, it ate.

and for form one, you can point at the configuration you're unlinking in any of these ways: as a configuration directory (dir), as a name (--name), as an id (--id), or as a UUID (--uuid). pick your fighter. 🎀

  • --name name — the name of the configuration you wanna unlink. bye girl 👋
  • --id id — the numeric id of the configuration you wanna unlink. numbers, not names, slay 🔢
  • --uuid uuid — the UUID of the configuration you wanna unlink. for when you're feeling ✨official✨
  • --dangling — removes dangling implicit backlinks. the cleanup era begins 🧹
  • --directory, -d dir — assume the configuration is in dir instead of in the current working directory. like, stop looking in the cwd, it's over there → 📁

👑 COMMON OPTIONS 👑

these are the shared ones, and the full deets live in bpkg-common-options(1). but here's the sparknotes version, bestie:

  • -v — print the essential underlying commands being executed. so you can see what's actually going on 👀
  • -V — print all the underlying commands being executed. all of them. the unfiltered version, no cap 🫣
  • --quiet, -q — run quietly, only printing error messages. silence is golden 🔇
  • --verbose level — set the diagnostics verbosity to level, which lives between 0 and 6. crank it up 🌡️
  • --stdout-format format — the representation format to use when printing to stdout. dress it up however you like 🎀
  • --jobs, -j num — the number of jobs to perform in parallel. multitasking queen 👑
  • --no-result — don't print informational messages about the outcome of performing a command or some of its parts. no spoilers 🙈
  • --structured-result fmt — write the result of performing a command in a structured form. organized. unlike my notes 📝
  • --progress — display progress indicators for long-lasting operations, like network transfers, building, etc. watch it cook 🔥
  • --no-progress — suppress those progress indicators for long-lasting operations, like network transfers, building, etc. no bar, just vibes 😌
  • --diag-color — use color in diagnostics. 🌈
  • --no-diag-color — don't use color in diagnostics. monochrome moment 🖤
  • --build path — the build program to be used to build packages. 🔨
  • --build-option opt — an additional option to be passed to the build program. extra lil gift for it 🎁
  • --fetch path — the fetch program to be used to download resources. 🛰️
  • --fetch-option opt — an additional option to be passed to the fetch program. 🎁
  • --fetch-timeout sec — the fetch and fetch-like (for example, git) program timeout. don't wait forever, king ⏰
  • --pkg-proxy url — the HTTP proxy server to use when fetching package manifests and archives from remote pkg repositories. going incognito 🕶️
  • --git path — the git program to be used to fetch git repositories. 🐙
  • --git-option opt — an additional common option to be passed to the git program. 🎁
  • --sha256 path — the sha256 program to be used to calculate SHA256 sums. math girlies rise 🧮
  • --sha256-option opt — an additional option to be passed to the sha256 program. 🎁
  • --tar path — the tar program to be used to extract package archives. 📦
  • --tar-option opt — an additional option to be passed to the tar program. 🎁
  • --openssl path — the openssl program to be used for crypto operations. 🔐
  • --openssl-option opt — an additional option to be passed to the openssl program. 🎁
  • --auth type — the types of repositories to authenticate. show me your ID bestie 🪪
  • --trust fingerprint — trust a repository certificate with a SHA256 fingerprint. i trust u 🫶
  • --trust-yes — assume the answer to all authentication prompts is yes. yes yes yes ✋
  • --trust-no — assume the answer to all authentication prompts is no. nope nope nope 🚫
  • --git-capabilities up=pc — protocol capabilities (pc) for a git repository URL prefix (up). very specific, very iconic 🦋
  • --pager path — the pager program to be used to show long text. scrolling but make it cute 📜
  • --pager-option opt — an 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. not today 📵
  • --keep-tmp — don't remove bpkg's temporary directory at the end of the command execution, and print its path at the verbosity level 2 or higher. keeping it for the memories 😭

🌈 DEFAULT OPTIONS FILES 🌈

want the full overview of how default options files work? that's bpkg-default-options-files(1), go read it, it's a good time.

for the cfg-unlink command specifically, the search start directory is the configuration directory. and in each directory, these options files are searched for and — if found — loaded in this exact order:

bpkg.options
bpkg-cfg-unlink.options
okay but here's the important bit 👇 these cfg-unlink command options cannot be specified in the default options files: - --directory|-d

so don't even try it bestie, the options files said no 🚫

💀 BUGS 💀

found a bug? send those bug reports to the users@build2.org mailing list. they wanna hear it, fr fr 📬

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.

and that's the whole page, bestie!! this was bpkg version 0.17.0, from June 2024, and yes the manual page is literally named bpkg-cfg-unlink(1). unlink slay, periodt 💅💖✨🦋

📦 where this page comes from