bpkg-pkg-update(1)

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

💖 bpkg-pkg-update — the bpkg-pkg-update(1) glow-up ✨

okay bestie, welcome to the General Commands Manual section of the bpkg cinematic universe 🎀 this one's called bpkg-pkg-update and it does exactly what it says on the tin: it updates packages. iconic behavior honestly.

🌸 NAME 🌸

bpkg-pkg-update — update package 🦋

⭐ SYNOPSIS ⭐

bpkg pkg-update|update [options] [vars] pkg...
bpkg pkg-update|update [options] [vars] --all|-a
bpkg pkg-update|update [options] [vars] (--all-pattern <pattern>)...

💅 DESCRIPTION 💅

so like, pkg-update updates the packages you name (that's form one), or all the held packages (form two — peep bpkg-pkg-status(1) for the deets on what "held" even means), or all the held packages that match any of the wildcard patterns you throw at it (form three). and yes, you can also drag the dependencies along for the ride: hit it with --immediate|-i for the immediate ones, or --recursive|-r for all of them, recursively, no cap 🔥

under the hood it's not doing some wild sorcery — it's basically just running b update (or one of its update-for-* variants; see --for|-f). 🫶 in that first form, the packages you specify must have already been configured with bpkg-pkg-build(1) or bpkg-pkg-configure(1). no skipping steps, babes.

extra command line variables (vars, usually config.*) can be passed straight to the build system ✨ those variables apply to all the specified packages, but you can also scope them so they only apply to specific packages using the argument grouping mechanism — go read bpkg-argument-grouping(1) for the full tea 💜

🎀 PKG-UPDATE OPTIONS 🎀

  • --all|-a — update all held packages. every single one. the whole squad. 👑
  • --all-pattern pattern — update the held packages that match the wildcard pattern. repeat this option to match multiple patterns, queen 🌈 heads up tho: you may need to quote the pattern so your shell doesn't expand it before bpkg even sees it 😭
  • --immediate|-i — also update immediate dependencies 🧚
  • --recursive|-r — also update all dependencies, recursively. down the whole tree, we go 💀
  • --for|-f operation — instead of the default update build system operation, do the update-for-operation variant, where operation is normally install or test ⭐
  • --directory|-d dir — assume the configuration is in dir rather than in the current working directory 🍓

🌈 COMMON OPTIONS 🌈

these are the shared ones — the full-length director's cut lives in bpkg-common-options(1) 📖

  • -v — print the essential underlying commands being executed.
  • -V — print all the underlying commands being executed. every last one. we're nosy today 🙈
  • --quiet|-q — run quietly, only printing error messages 🤫
  • --verbose level — set the diagnostics verbosity to level, somewhere between 0 and 6 💅
  • --stdout-format format — the representation format to use when printing to stdout.
  • --jobs|-j num — how many 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.
  • --structured-result fmt — write the result of performing a command in a structured form.
  • --progress — display progress indicators for long-lasting operations, like network transfers, building, etc. ⏳
  • --no-progress — suppress those progress indicators for long-lasting operations, like 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 — an additional option to pass to the build program.
  • --fetch path — the fetch program to be used to download resources.
  • --fetch-option opt — an additional option to pass to the fetch program.
  • --fetch-timeout sec — the fetch and fetch-like (for example, git) program timeout ⏰
  • --pkg-proxy url — the 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 — an additional common option to pass to the git program.
  • --sha256 path — the sha256 program to be used to calculate SHA256 sums 🔐
  • --sha256-option opt — an additional option to pass to the sha256 program.
  • --tar path — the tar program to be used to extract package archives.
  • --tar-option opt — an additional option to pass to the tar program.
  • --openssl path — the openssl program to be used for crypto operations 🔒
  • --openssl-option opt — an additional option to pass to the openssl program.
  • --auth type — the types of repositories to authenticate.
  • --trust fingerprint — trust a 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 — an additional option to pass 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, periodt.
  • --keep-tmp — don't remove bpkg's temporary directory at the end of the command execution, and print its path at verbosity level 2 or higher. lil souvenir 🎁

🧚 DEFAULT OPTIONS FILES 🧚

peep bpkg-default-options-files(1) for the big-picture overview of default options files 💜

for the pkg-update 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-update.options

and these pkg-update command options cannot be specified in the default options files, bestie:

--directory|-d

💀 BUGS 💀

found a bug? send bug reports to the users@build2.org mailing list 📬

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. slay 💖

and that's the whole page, babe — this was bpkg-pkg-update(1) from bpkg 0.17.0, dated June 2024. mwah, go update something 💅✨

📦 where this page comes from