150 lines
4.7 KiB
Groff
150 lines
4.7 KiB
Groff
.Dd June 1, 2012
|
|
.Os Void GNU/Linux
|
|
.Dt xbps-repo 8
|
|
.Sh NAME
|
|
.Nm xbps-repo
|
|
.Nd XBPS command for binary package repositories
|
|
.Sh SYNOPSYS
|
|
.Nm xbps-repo
|
|
.Op options
|
|
.Ar target
|
|
.Op arguments
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
command is able to interact with binary packages stored in local or
|
|
remote repositories. It is able to create a package index for local
|
|
repositories, list repositories, search for packages and show information
|
|
of a binary package in repository pool, among other things.
|
|
.Sh OPTIONS
|
|
.Bl -tag -width Fl
|
|
.It Fl C Ar conffile
|
|
Full path to the XBPS configuration file. By default set to
|
|
.Pa /etc/xbps/xbps.conf .
|
|
.It Fl c Ar cachedir
|
|
Sets the
|
|
.Em cache
|
|
directory to store downloaded binary packages from remote
|
|
repositories. By default set to
|
|
.Pa /var/cache/xbps .
|
|
.It Fl d
|
|
Enables extra debugging output to be shown to stderr.
|
|
.It Fl o Ar key Op key2,...
|
|
Used currently in the
|
|
.Em show
|
|
target. Prints the value of specified key(s) from
|
|
package's properties dictionary. Multiple keys can be specified delimited by
|
|
the comma character.
|
|
.It Fl r Ar rootdir
|
|
Sets the
|
|
.Em root
|
|
directory. By default the root directory is set to
|
|
.Em / .
|
|
Please note that the database directory is always set to
|
|
.Pa /var/db/xbps
|
|
independently of rootdir setting. So if you use a rootdir of
|
|
.Pa /blah ,
|
|
metadata stuff will go into
|
|
.Pa /blah/var/db/xbps .
|
|
.It Fl v
|
|
Shows verbose messages. Useful while installing and removing packages.
|
|
.It Fl V
|
|
Shows the current XBPS release version (version, API, index).
|
|
.Sh TARGETS
|
|
Please note that all targets are case insensitive.
|
|
.Pp
|
|
.Bl -tag -width ident
|
|
.It Sy clean
|
|
Cleans the
|
|
.Em cachedir
|
|
and removes obsolete binary packages, either because they are not available
|
|
anymore in repository pool or because its sha256 hash doesn't match.
|
|
.It Sy find-files Ar pattern Ar [patterns ...]
|
|
Prints the name of
|
|
.Em package(s)
|
|
matching the pattern on its file list by looking in all repositories index files.
|
|
Multiple patterns can be specified as arguments.
|
|
.It Sy genindex Pa /path/to/local/repo
|
|
Generates a package index for a local repository as specified in its argument.
|
|
It will look for archives with the
|
|
.Sy .xbps
|
|
extension and will only add it into the index if version is newer than the one
|
|
available in the index. If a newer package is available, the old package file
|
|
will be removed automatically.
|
|
.It Sy list
|
|
Lists all working repositories in repository pool.
|
|
.It Sy pkg-list Op repository
|
|
Lists all currently registered packages from all repositories, or just from
|
|
.Ar repository .
|
|
If argument is not specified, any package contained in all repositories
|
|
will be shown. The argument expects the repository URI.
|
|
matching the output of the
|
|
.Ar list
|
|
target.
|
|
.It Sy search Ar pattern Ar [patterns ...]
|
|
Search for packages containing the shell
|
|
.Em pattern
|
|
(see
|
|
.Xr fnmatch 3 )
|
|
in its
|
|
.Em pkgname
|
|
or
|
|
.Em description
|
|
values in repository pool. Please note that patterns are matched in case
|
|
insensitive mode. Multiple patterns can be specified as arguments.
|
|
.It Sy show Ar pkgname | pkgpattern
|
|
Shows information for binary package
|
|
.Ar pkgname
|
|
or a package matching
|
|
.Ar pkgpattern .
|
|
This will print the size it takes in filesystem, description, maintainer,
|
|
architecture and other information. If specifying a pkgname, the newest
|
|
version available in repositories will be shown, otherwise the first
|
|
repository matching the pkgpattern will be used.
|
|
.It Sy show-deps Ar pkgname | pkgpattern
|
|
Shows run time dependencies for binary package
|
|
.Ar pkgname
|
|
or a package matching
|
|
.Ar pkgpattern .
|
|
The same rules than in the
|
|
.Em show
|
|
target also apply here.
|
|
.It Sy show-files Ar pkgname | pkgpattern
|
|
Shows the file list for the binary package
|
|
.Ar pkgname
|
|
or a package matching
|
|
.Ar pkgpattern .
|
|
The same rules than in the
|
|
.Em show
|
|
target also apply here.
|
|
.Em NOTE :
|
|
if a remote repository is the winner and binary package is not available in
|
|
.Em cachedir ,
|
|
it will fetch remotely and
|
|
.Em on the fly
|
|
the info from target repository.
|
|
.It Sy sync Op repository
|
|
Syncs the package index file for all remote repositories or just for
|
|
.Ar repository .
|
|
The index file will be fetched if local and remote size/mtime do not match.
|
|
.Sh FILES
|
|
.Bl -tag -width /var/db/xbps/<repodir>/index-files.plist -compact
|
|
.It Pa /etc/xbps/xbps.conf
|
|
Default XBPS configuration file.
|
|
.It Pa /var/db/xbps/<repodir>/index.plist
|
|
Remote repository package index file.
|
|
.It Pa /var/db/xbps/<repodir>/index-files.plist
|
|
Remote repository package files cache file.
|
|
.It Pa /var/cache/xbps
|
|
XBPS cache directory for downloaded binary packages.
|
|
.Sh SEE ALSO
|
|
.Xr xbps-bin 8 ,
|
|
.Xr http://code.google.com/p/xbps
|
|
.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 http://code.google.com/p/xbps.
|