xbps/bin/xbps-rindex/xbps-rindex.8

.Dd April 21, 2014
.Os Void Linux
.Dt xbps-rindex 8
.Sh NAME
.Nm xbps-rindex
.Nd XBPS utility to manage local binary package repositories
.Sh SYNOPSYS
.Nm xbps-rindex
.Op OPTIONS
.Ar MODE
.Op ARGUMENTS
.Sh DESCRIPTION
The
.Nm
utility creates, updates and removes obsolete binary packages stored
in local repositories.
.Sh OPTIONS
.Bl -tag -width -x
.It Fl f -force
Forcefully register binary package into the local repository, overwriting existing entry.
This flag is only useful with the
.Em add
mode.
.It Fl h -help
Show the help usage.
.It Fl V -version
Show the XBPS version.
.It Sy --signedby Ar string
This is required to sign a repository, a description of the person signing the repository, i.e name and email.
.It Sy --privkey Ar key
Path to the private RSA key to sign the repository. If unset, defaults to
.Sy ~/.ssh/id_rsa .
.Sh MODE
.Pp
.Bl -tag -width x
.It Sy -a, --add Ar 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. Multiple binary packages can be specified as arguments.
.It Sy -c, --clean Ar repository
Removes obsolete entries found in the local repository.
.It Sy -r, --remove-obsoletes Ar repository
Removes obsolete packages from
.Ar repository .
Packages that are not currently registered in repository's index will
be removed (out of date, invalid archives, etc).
.It Sy -s, --sign Ar repository
Signs a repository with your specified RSA key. If
.Fl --privkey
argument not set, it defaults to
.Sy ~/.ssh/id_rsa .
.Sh ENVIRONMENT
.Bl -tag -width XBPS_TARGET_ARCH
.It Sy XBPS_ARCH
Overrides
.Xr uname 2
machine result with this value. Useful to install packages with a fake
architecture.
.It Sy XBPS_TARGET_ARCH
Sets the target architecture to this value. This variable differs from
.Sy 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).
.It Sy 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.
.Sh SEE ALSO
.Xr xbps-checkvers 8 ,
.Xr xbps-create 8 ,
.Xr xbps-dgraph 8 ,
.Xr xbps-install 8 ,
.Xr xbps-pkgdb 8 ,
.Xr xbps-query 8 ,
.Xr xbps-reconfigure 8 ,
.Xr xbps-remove 8 ,
.Xr xbps-uchroot 8
.Sh AUTHORS
.An Juan Romero Pardines <xtraeme@gmail.com>
.Sh BUGS
Probably, but I try to make this not happen. Use it under your own
responsability and enjoy your life.
.Pp
Report bugs in https://github.com/voidlinux/xbps/issues
Xref xbps-uchroot(8) 2014-04-21 14:28:09 +05:30			`.Dd April 21, 2014`
man: s/Void GNU\/Linux/Void Linux/g 2012-11-06 14:25:56 +05:30			`.Os Void Linux`
xbps-rindex: added a manual page. 2012-11-03 15:00:26 +05:30			`.Dt xbps-rindex 8`
			`.Sh NAME`
			`.Nm xbps-rindex`
xbps-rindex: remove -c --clean mode and adapt to the new libxbps API. - Removed -c --clean mode. It's not too useful and adds a considerable amount of gratuitous code. It takes almost the same time than adding all pkgs from scratch. - When creating the repository data always add the meta plist at the 2nd position in the archive, to optimize its access. - Misc improvements. 2013-10-07 13:53:14 +05:30			`.Nd XBPS utility to manage local binary package repositories`
xbps-rindex: added a manual page. 2012-11-03 15:00:26 +05:30			`.Sh SYNOPSYS`
			`.Nm xbps-rindex`
			`.Op OPTIONS`
			`.Ar MODE`
			`.Op ARGUMENTS`
			`.Sh DESCRIPTION`
			`The`
			`.Nm`
manpages: tweaks. 2012-11-05 14:09:10 +05:30			`utility creates, updates and removes obsolete binary packages stored`
xbps-rindex: added a manual page. 2012-11-03 15:00:26 +05:30			`in local repositories.`
			`.Sh OPTIONS`
man: use the same width. 2012-11-06 15:03:29 +05:30			`.Bl -tag -width -x`
xbps-rindex: added -f --force flag to forcefully register a pkg with -a --add. 2013-05-02 14:16:30 +05:30			`.It Fl f -force`
			`Forcefully register binary package into the local repository, overwriting existing entry.`
			`This flag is only useful with the`
			`.Em add`
			`mode.`
xbps-rindex: added a manual page. 2012-11-03 15:00:26 +05:30			`.It Fl h -help`
			`Show the help usage.`
			`.It Fl V -version`
			`Show the XBPS version.`
xbps-rindex: remove -c --clean mode and adapt to the new libxbps API. - Removed -c --clean mode. It's not too useful and adds a considerable amount of gratuitous code. It takes almost the same time than adding all pkgs from scratch. - When creating the repository data always add the meta plist at the 2nd position in the archive, to optimize its access. - Misc improvements. 2013-10-07 13:53:14 +05:30			`.It Sy --signedby Ar string`
			`This is required to sign a repository, a description of the person signing the repository, i.e name and email.`
			`.It Sy --privkey Ar key`
			`Path to the private RSA key to sign the repository. If unset, defaults to`
			`.Sy ~/.ssh/id_rsa .`
xbps-rindex: added a manual page. 2012-11-03 15:00:26 +05:30			`.Sh MODE`
			`.Pp`
man: use the same width. 2012-11-06 15:03:29 +05:30			`.Bl -tag -width x`
xbps-rindex: remove -c --clean mode and adapt to the new libxbps API. - Removed -c --clean mode. It's not too useful and adds a considerable amount of gratuitous code. It takes almost the same time than adding all pkgs from scratch. - When creating the repository data always add the meta plist at the 2nd position in the archive, to optimize its access. - Misc improvements. 2013-10-07 13:53:14 +05:30			`.It Sy -a, --add Ar 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. Multiple binary packages can be specified as arguments.`
xbps-rindex(8): fix #19. An ATF test-case will be imported later. 2013-11-02 16:04:55 +05:30			`.It Sy -c, --clean Ar repository`
			`Removes obsolete entries found in the local repository.`
xbps-rindex: added a manual page. 2012-11-03 15:00:26 +05:30			`.It Sy -r, --remove-obsoletes Ar repository`
			`Removes obsolete packages from`
			`.Ar repository .`
			`Packages that are not currently registered in repository's index will`
xbps-rindex: -a does not remove outdated binpkgs anymore; use -r instead. 2012-12-15 15:43:32 +05:30			`be removed (out of date, invalid archives, etc).`
xbps-rindex: remove -c --clean mode and adapt to the new libxbps API. - Removed -c --clean mode. It's not too useful and adds a considerable amount of gratuitous code. It takes almost the same time than adding all pkgs from scratch. - When creating the repository data always add the meta plist at the 2nd position in the archive, to optimize its access. - Misc improvements. 2013-10-07 13:53:14 +05:30			`.It Sy -s, --sign Ar repository`
Added support for the long awaited feature: RSA signed repositories. 2013-10-05 15:08:04 +05:30			`Signs a repository with your specified RSA key. If`
			`.Fl --privkey`
			`argument not set, it defaults to`
			`.Sy ~/.ssh/id_rsa .`
xbps-{install,query,rindex}.8: document environment var: XBPS_TARGET_ARCH. 2013-02-20 16:12:06 +05:30			`.Sh ENVIRONMENT`
			`.Bl -tag -width XBPS_TARGET_ARCH`
Added XBPS_ARCH environment var to override uname(2) machine result. 2014-01-09 16:11:25 +05:30			`.It Sy XBPS_ARCH`
xbps-{install,query,rindex}.8: document environment var: XBPS_TARGET_ARCH. 2013-02-20 16:12:06 +05:30			`Overrides`
			`.Xr uname 2`
Added XBPS_ARCH environment var to override uname(2) machine result. 2014-01-09 16:11:25 +05:30			`machine result with this value. Useful to install packages with a fake`
xbps-{install,query,rindex}.8: document environment var: XBPS_TARGET_ARCH. 2013-02-20 16:12:06 +05:30			`architecture.`
Added XBPS_ARCH environment var to override uname(2) machine result. 2014-01-09 16:11:25 +05:30			`.It Sy XBPS_TARGET_ARCH`
			`Sets the target architecture to this value. This variable differs from`
			`.Sy 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).`
			`.It Sy 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.`
xbps-rindex: added a manual page. 2012-11-03 15:00:26 +05:30			`.Sh SEE ALSO`
bin/*: update manpages with Xref xbps-checkvers(8). 2014-04-07 15:52:55 +05:30			`.Xr xbps-checkvers 8 ,`
xbps-rindex: added a manual page. 2012-11-03 15:00:26 +05:30			`.Xr xbps-create 8 ,`
			`.Xr xbps-dgraph 8 ,`
			`.Xr xbps-install 8 ,`
			`.Xr xbps-pkgdb 8 ,`
			`.Xr xbps-query 8 ,`
			`.Xr xbps-reconfigure 8 ,`
Xref xbps-uchroot(8) 2014-04-21 14:28:09 +05:30			`.Xr xbps-remove 8 ,`
			`.Xr xbps-uchroot 8`
xbps-rindex: added a manual page. 2012-11-03 15:00:26 +05:30			`.Sh AUTHORS`
			`.An Juan Romero Pardines <xtraeme@gmail.com>`
			`.Sh BUGS`
			`Probably, but I try to make this not happen. Use it under your own`
			`responsability and enjoy your life.`
			`.Pp`
xbps-xxx.8: update issues url. 2013-12-17 20:08:56 +05:30			`Report bugs in https://github.com/voidlinux/xbps/issues`