XBPS-RECONFIGURE(1)

📦 version 0.60.6, in alpine 3.24, nixos 26.05, nixpkgs unstable

💅 xbps-reconfigure(1) — the group-chat edition 🎀

okay so bestie, you know that xbps-reconfigure manual page? yeah. this is it, but make it make sense. it lives in General Commands Manual land and it's literally the XBPS utility to configure installed packages. let's go ✨

🌸 NAME 🌸

xbps-reconfigure — XBPS utility to configure installed packages. that's it. that's the vibe. 👑

🦋 SYNOPSIS 🦋

xbps-reconfigure [OPTIONS] [PKGNAME...]

💖 DESCRIPTION 💖

so xbps-reconfigure configures or reconfigures your packages in the target root directory. and like, "configuring" isn't just a vibe — it's actually two whole steps, bestie:

  • It executes the post ACTION on the package's INSTALL script. (you can peek at that script by running xbps-query --property=install-script pkg — iykyk 🔍)
  • Then it flips the package state to XBPS_PKG_STATE_INSTALLED, but only if step one went off without a hitch. slay. no cap.

and here's the thing — only packages that weren't configured previously get processed. periodt. the exception? you guessed it, if you pass -f. then it's force o'clock. 💀

✨ OPTIONS ✨

  • -a, --all — configures all the packages. literally all of them. 🌈
  • -C, --config dir — specifies a path to the XBPS configuration directory. if the first character isn't /, then it's a relative path of rootdir. sneaky but valid 💅
  • -d, --debug — enables extra debugging shown to stderr. for when you need to see everything 👀
  • -f, --force — forcefully reconfigure the package even if it was configured previously. main character energy, honestly.
  • -h, --help — show the help message. we love a helpful icon.
  • -i, --ignore PKG — ignore PKG when configuring all packages with -a, --all. PKG can be a package name or a package name with version. and yes, you can specify this option multiple times — stack 'em 🫶
  • -r, --rootdir dir — specifies a path for the target root directory.
  • -x, --deps — configure PKGNAME... and its direct dependencies.
  • --fulldeptree — configure the full dependency tree of PKGNAME... when used with -x, --deps. that's direct deps' bigger, cooler sibling 🧚
  • -v, --verbose — enables verbose messages. chatty mode: on 💬
  • -V, --version — show the version information.

🐚 ENVIRONMENT 🐚

  • XBPS_ARCH — overrides the uname(2) machine result with this value. useful to install packages with a fake architecture. fake it till you make it, bestie 🎭
  • XBPS_TARGET_ARCH — sets the target architecture to this value. this variable differs from XBPS_ARCH in that it allows you to install packages partially, because the configuration phase is skipped (the target binaries might not be compatible with the native architecture). so like, that's the whole caveat, don't @ me 😭
  • XBPS_SYSLOG — overrides the xbps.d(5) syslog=true|false configuration option.

🍓 FILES 🍓

  • /etc/xbps.d — default configuration directory.
  • /usr/share/xbps.d — default system configuration directory.
  • /var/db/xbps/.<pkgname>.plist — package files metadata.
  • /var/db/xbps/pkgdb-0.38.plist — default package database (0.38 format). keeps track of installed packages and properties. it's giving record keeper 📓
  • /var/cache/xbps — default cache directory to store downloaded binary packages.

💜 SEE ALSO 💜

xbps-alternatives(1), xbps-checkvers(1), xbps-create(1), xbps-dgraph(1), xbps-digest(1), xbps-fbulk(1), xbps-fetch(1), xbps-install(1), xbps-pkgdb(1), xbps-query(1), xbps-remove(1), xbps-rindex(1), xbps-uchroot(1), xbps-uunshare(1), xbps.d(5)

like, the whole friend group. go read them too 🫶

👑 AUTHORS 👑

Juan Romero Pardines <xtraeme@gmail.com> — the icon who made this happen.

💀 BUGS 💀

probably, but I try to make this not happen. (their words, not mine 😭) use it under your own responsibility and enjoy your life. honestly? iconic disclaimer.

report bugs at https://github.com/void-linux/xbps/issues — please do, they actually want to know 🙈

and that's the whole page, bestie!! this edition came from Debian, dated Feb 9, 2023, and it's the XBPS-RECONFIGURE(1) page — mwah, go configure something 💅🎀✨

📦 where this page comes from