xbps/bin/xbps-repo/xbps-repo.8.txt
Juan RP f859663a4b xbps-repo: made 'genindex' code run ~60% faster than before!
Rather than externalizing the package index plist file to storage every
time a package is registered, only do it one time once all packages
have been processed. Creating an index with 700 pkgs now takes 14s
in a VM, where before it took 39s. As consequence of this, the 'add-pkgidx'
target is no longer relevant or useful, remove it.

--HG--
extra : convert_revision : xtraeme%40gmail.com-20091118053439-ct1chn4hdeir1pdo
2009-11-18 06:34:39 +01:00

98 lines
2.7 KiB
Plaintext

XBPS-REPO(8)
===========
NAME
----
xbps-repo - XBPS command for binary package repositories
SYNOPSYS
--------
*xbps-repo* ['options'] 'target' ['arguments']
DESCRIPTION
-----------
The xbps-repo(1) command is used to handle local or remote binary
package repositories in the *XBPS binary package system*.
You can use it to create a package index for a local repository,
add or remove local and remote repositories, search for packages
and show information about a binary package in repository pool.
OPTIONS
-------
*-r* 'rootdir'::
Sets the 'root' directory. By default the root directory is
set to '/'. Please note that the database directory is always
set to '/var/db/xbps' independently of 'rootdir'. So if you
use a 'rootdir' of '/blah', metadata stuff will go into
'/blah/var/db/xbps'.
*-V*::
Shows the current XBPS release version (library and code).
TARGETS
-------
Please note that all targets are *case insensitive*.
*add* 'URI'::
Adds a repository as specified in 'URI' to the repository pool.
Local (by specifying a *directory*) and remote (by specifiying an
*HTTP/HTTPS/FTP URL*) repositories can be specified.
*genindex* '/path/to/local/repo'::
Generates a package index for a local repository as specified in
its argument. It will look for archives with *.xbps* extension
and will only add it into the index if version is newer than the one
available in the index. The same argument should be used for the *add*
and *remove* targets.
*list*::
Lists all currently registered repositories in repository pool.
*remove* 'URI'::
Removes a repository from repository pool as specified by the
'URI' argument. You have to use the same 'URI' that was used
in the *add* target.
*search* 'pattern'::
Search for packages containing the shell 'pattern' (see fnmatch(3)) in
its *pkgname* or *description* values.
*show 'pkgname'*::
Shows information about binary package 'pkgname'. This will print
the size it takes in filesystem, description, maintainer, architecture
and other information.
*sync 'URI'*::
Syncs the package index file that is available from the repository
specified at 'URI'. The new file will be fetched if it has been
modified since last synchronization.
BUGS
----
Probably, but I try to make this not happen. Use it under your own
responsability and enjoy your life.
Report bugs in '<https://bugs.launchpad.net/xbps>'.
SEE ALSO
--------
*xbps-bin(8)*, *xbps-src(8)*
XBPS utilities: '<https://launchpad.net/xbps>'
To build binary packages, the xbps-src(8) shell script is the command
designed for this task. This must be retrieved from a GIT repository,
available at '<http://repo.or.cz/w/xbps.git>'.
AUTHORS
-------
The *XBPS binary package system* has been designed and implemented by
Juan Romero Pardines <xtraeme@gmail.com>.