XBPS-RINDEX(1)

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

💅 xbps-rindex — the glow-up page for your local binary package repos 🎀

okay bestie, welcome to xbps-rindex(1), from the General Commands Manual fam — this is the little icon that creates, updates and yeets obsolete binary packages living in your local repositories. she's giving librarian-with-a-clipboard energy and honestly? we stan. ✨

🌸 SYNOPSIS 🌸

xbps-rindex [OPTIONS] MODE [ARGUMENTS]

🦋 DESCRIPTION 🦋

The xbps-rindex utility creates, updates and removes obsolete binary packages stored in local repositories. that's it, that's the whole vibe — she keeps your repo tidy so you don't have to. no cap. 💖

✨ OPTIONS ✨

  • -d, --debug — turns on extra debugging output, printed to stderr. loud and proud, we love a transparent queen. 🔍
  • --compression none | gzip | bzip2 | xz | lz4 | zstd — picks the repodata compression format. if you don't set it, it defaults to zstd. so if you're not specifying, zstd is your main character. 👑
  • -C, --hashcheck — while cleaning, check not just that the file exists but that it has the correct file hash too. literally a vibe check for your files. this flag is only useful with the clean mode. 💅
  • -f, --force — forcefully register a binary package into the local repository, overwriting the existing entry. or forcefully create a package signature even if one already exists. this flag is only useful with the add or sign-pkg modes. she does not ask permission. 🫶
  • -h, --help — shows the help message. classic, iconic, always there for you. 🥰
  • -V, --version — shows the version information. 💫
  • --signedby string — this one is required to sign a repository: a description of the person signing the repository, i.e. name and email. put your name on it, bestie, you're the signer. ✍️
  • --privkey key — path to the private RSA key used to sign the repository. if unset, it defaults to ~/.ssh/id_rsa. 🔑

🎀 MODE 🎀

pick a mode, any mode — but like, actually pick one. this is the whole point. 😭
  • -a, --add /path/to/repository/binpkg.xbps ... — registers the binary package into the local repository. the specified binary package is only added to the index if its version is greater than the one currently stored — so if it's not newer, she's not interested. use -f to forcefully register existing packages. multiple binary packages can be specified as arguments. absolute path to the local repository is expected. 🔥
  • -c, --clean /path/to/repository — removes obsolete entries found in the local repository. absolute path to the local repository is expected. spring cleaning but make it rpm-adjacent. 🧹
  • -r, --remove-obsoletes /path/to/repository — removes obsolete packages from the repository. packages that are not currently registered in the repository's index will be removed (out of date, invalid archives, etc). absolute path to the local repository is expected. bye boo 👋💀
  • -s, --sign /path/to/repository — initializes a signed repository with your specified RSA key. note this only adds some metadata to the repository archive to be able to sign packages. if the --privkey argument is not set, it defaults to ~/.ssh/id_rsa. ✨
  • -S, --sign-pkg /path/to/repository/binpkg.xbps ... — signs a binary package archive with your specified RSA key. if the --privkey argument is not set, it defaults to ~/.ssh/id_rsa. if there's an existing signature, it won't be overwritten; use the -f option to force the creation. no sneaky overwrites in this house. 🚫

🌈 ENVIRONMENT 🌈

  • XBPS_ARCH — overrides the uname(2) machine result with this value. useful to install packages with a fake architecture. lowkey cosplay for your CPU. 🎭
  • 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). 🙈
  • XBPS_PASSPHRASE — if this is set, it will use this passphrase for the RSA private key when signing a repository. otherwise it will ask you to enter the passphrase on the terminal. no passphrase stored in plain sight, mwah. 💜

🦋 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-reconfigure(1), xbps-remove(1), xbps-uchroot(1), xbps-uunshare(1), xbps.d(5)

the whole squad, fr fr. go read them, they're all icons. 👑

🌟 AUTHORS 🌟

  • Juan Romero Pardines <xtraeme@gmail.com>
  • Enno Boland <gottox@voidlinux.org>

💀 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 — please do, the maintainers are lovely and they want to know. 🫶

and that's the tea, bestie 🍓 this page came courtesy of Debian, dated Feb 9, 2023, and it's XBPS-RINDEX(1) forever and always — now go forth and let your repo be immaculate. 💅✨🎀

📦 where this page comes from