XBPS-FBULK(1)

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

💖 NAME 💖

okay so bestie, meet xbps-fbulk — the XBPS utility that does a fast bulk build of void-packages ✨ this one's straight out of the General Commands Manual, and it is lowkey iconic for churning through package builds 🌸

🌈 SYNOPSIS 🌈

xbps-fbulk [OPTIONS] /path/to/void-packages [pkgN pkg+N ...]

🦋 DESCRIPTION 🦋

The xbps-fbulk utility iterates all srcpkg directories in the void-packages repository or processes the pkgN arguments, and then runs xbps-src show-build-deps to build a dependency tree on the fly 💅

As the dependency tree is built, terminal dependencies are built and packaged on the fly ✨

As these builds complete, additional dependencies may be satisfied and be added to the build order. Ultimately the entire tree is built 🎀

Only one attempt is made to build any given package, no matter how many other packages depend on it. fr fr, no duplicate attempts 👑

When using system mode only installed packages that are in manual mode (see xbps-pkgdb(1)) will be processed. This is useful to keep up a running system up-to-date 🫶

🍓 OPTIONS 🍓

  • -j, --jobs X — set number of parallel builds running at the same time. By default set to 1 💅
  • -l, --logdir logdir — set the log directory. By default set to fbulk-log.<pid> 🎀
  • -d, --debug — enables extra debugging shown to stderr 🔥
  • -s, --system — system build mode. If set, only packages that were installed manually in your system will be processed 👑
  • -h, --help — show the help message 🌸
  • -v, --verbose — enables verbose messages ✨
  • -V, --version — show the version information 💖

🧚 FILES 🧚

  • logdir/run — packages that are being built 🛠️
  • logdir/good — packages that were built successfully ✅
  • logdir/bad — packages that failed to build 💀
  • logdir/skipped — packages that were not built because they had to be skipped (unsupported architecture, broken or restricted) 🙈
  • logdir/deps — packages that were not built due to failed or missing dependencies 😭

⭐ EXIT STATUS ⭐

A descriptive error message will be printed to stderr. no cap, that's the vibe check 💅

💜 NOTES 💜

The masterdir in the void-packages repository must be fully populated for chroot operations, and some options need to be set in etc/conf to make xbps-fbulk work correctly:

  • XBPS_CHROOT_CMD=uchroot — the xbps-uchroot(1) utility is required because xbps-fbulk builds packages in temporary masterdirs that are mounted with overlayfs 🌀

Make sure the user running xbps-fbulk has rights to execute xbps-uchroot(1) and the kernel supports the overlay filesystem, introduced in 4.0 👑

bestie this part is serious: masterdir fully populated, etc/conf set right, rights to run xbps-uchroot(1), and overlayfs support in the kernel — otherwise it's giving broken vibes 😭

🌟 SEE ALSO 🌟

🌸 AUTHORS 🌸

The xbps-fbulk utility was originally written by Matthew Dillon <dillon@backplane.com> for the DragonFlyBSD project 🐉

Juan Romero Pardines <xtraeme@gmail.com> adapted it for xbps and added some new features ✨

💀 BUGS 💀

Probably, but I try to make this not happen. Use it under your own responsibility and enjoy your life 🫶

Report bugs at https://github.com/void-linux/xbps/issues 🐛

sign-off bestie: this page is from Debian, dated April 20, 2020, and it's XBPS-FBULK(1) — slay, bye 💖🎀

📦 where this page comes from