NAME

xbps-rindex — XBPS utility to manage local binary package repositories

SYNOPSIS

DESCRIPTION

The xbps-rindex utility creates, updates and removes obsolete binary packages stored in local repositories.

OPTIONS

-d, --debug

Enables extra debugging shown to stderr.

--compression none | gzip | bzip2 | xz | lz4 | zstd

Set the repodata compression format. If unset, defaults to zstd.

-C --hashcheck

Check not only for file existence but for the correct file hash while cleaning. This flag is only useful with the clean mode.

-f --force

Forcefully register binary package into the local repository, overwriting existing entry. Or forcefully create a package signature, even if there's an existing one already. This flag is only useful with the add or sign-pkg modes.

-h --help

Show the help message.

-V --version

Show the version information.

--signedby string

This is required to sign a repository, a description of the person signing the repository, i.e name and email.

--privkey key

Path to the private RSA key to sign the repository. If unset, defaults to ~/.ssh/id_rsa.

MODE

-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, 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.

-r, --remove-obsoletes /path/to/repository

Removes obsolete packages from repository. Packages that are not currently registered in repository's index will be removed (out of date, invalid archives, etc). Absolute path to the local repository is expected.

-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 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 --privkey argument 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.

ENVIRONMENT

XBPS_ARCH

Overrides uname(2) machine result with this value. Useful to install packages with a fake architecture.

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

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)

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