176 lines
5.4 KiB
Groff
176 lines
5.4 KiB
Groff
.TH "XBPS\-REPO" "8" "15/12/2010" "\ \&" "\ \&"
|
|
.\" -----------------------------------------------------------------
|
|
.\" * set default formatting
|
|
.\" -----------------------------------------------------------------
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.\" -----------------------------------------------------------------
|
|
.\" * MAIN CONTENT STARTS HERE *
|
|
.\" -----------------------------------------------------------------
|
|
.SH "NAME"
|
|
xbps-repo \- XBPS command for binary package repositories
|
|
.SH "SYNOPSIS"
|
|
.sp
|
|
\fBxbps\-repo\fR [\fIoptions\fR] \fItarget\fR [\fIarguments\fR]
|
|
.SH "DESCRIPTION"
|
|
.sp
|
|
The xbps\-repo(8) command is used to handle local or remote binary package repositories in the \fBXBPS binary package system\fR\&. 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\&.
|
|
.SH "OPTIONS"
|
|
.PP
|
|
\fB\-c\fR \fIcachedir\fR
|
|
.RS 4
|
|
Sets the
|
|
\fIcache\fR
|
|
directory to store downloaded binary packages from remote repositories\&. By default it\(cqs set to
|
|
\fI/var/cache/xbps\fR
|
|
and it\(cqs always relative to the
|
|
\fIroot\fR
|
|
directory\&. So if you use a
|
|
\fIrootdir\fR
|
|
of
|
|
\fI/blah\fR, it will become
|
|
\fI/blah/cachedir\fR\&.
|
|
.RE
|
|
.PP
|
|
\fB\-d\fR
|
|
.RS 4
|
|
Enables extra debugging output to be shown to stderr.
|
|
.RE
|
|
.PP
|
|
\fB\-r\fR \fIrootdir\fR
|
|
.RS 4
|
|
Sets the
|
|
\fIroot\fR
|
|
directory\&. By default the root directory is set to
|
|
\fI/\fR\&. Please note that the database directory is always set to
|
|
\fI/var/db/xbps\fR
|
|
independently of
|
|
\fIrootdir\fR\&. So if you use a
|
|
\fIrootdir\fR
|
|
of
|
|
\fI/blah\fR, metadata stuff will go into
|
|
\fI/blah/var/db/xbps\fR\&.
|
|
.RE
|
|
.PP
|
|
\fB\-V\fR
|
|
.RS 4
|
|
Shows the current XBPS release version (library and code)\&.
|
|
.RE
|
|
.SH "TARGETS"
|
|
.sp
|
|
Please note that all targets are \fBcase insensitive\fR\&.
|
|
.PP
|
|
\fBadd\fR \fIURI\fR
|
|
.RS 4
|
|
Adds a repository as specified in
|
|
\fIURI\fR
|
|
to the repository pool\&. Local (by specifying a
|
|
\fBdirectory\fR) and remote (by specifiying an
|
|
\fBHTTP/HTTPS/FTP URL\fR) repositories can be specified\&.
|
|
.RE
|
|
.PP
|
|
\fBfind\-files\fR \fIpattern\fR
|
|
.RS 4
|
|
Prints the name for any package registered in the repository pool, that owns
|
|
the file matched by \fIpattern\fR\&. Exact matches and wildcards can be
|
|
specified\&. Please note that this will look in all packages registered
|
|
from all repositories currently registered, so if packages are not in \fIcachedir\fR
|
|
it will have to connect remotely to the repository to fetch the information
|
|
\fIon the fly\fR.
|
|
.RE
|
|
.PP
|
|
\fBgenindex\fR \fI/path/to/local/repo\fR
|
|
.RS 4
|
|
Generates a package index for a local repository as specified in its argument\&. It will look for archives with
|
|
\fB\&.xbps\fR
|
|
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 for old package file will be removed automatically\&.
|
|
.RE
|
|
.PP
|
|
\fBlist\fR
|
|
.RS 4
|
|
Lists all currently registered repositories in repository pool\&.
|
|
.RE
|
|
.PP
|
|
\fBremove\fR \fIURI\fR
|
|
.RS 4
|
|
Removes a repository from repository pool as specified by the
|
|
\fIURI\fR
|
|
argument\&. You have to use the same
|
|
\fIURI\fR
|
|
that was used in the
|
|
\fBadd\fR
|
|
target\&.
|
|
.RE
|
|
.PP
|
|
\fBsearch\fR \fIpattern\fR
|
|
.RS 4
|
|
Search for packages containing the shell
|
|
\fIpattern\fR
|
|
(see fnmatch(3)) in its
|
|
\fBpkgname\fR
|
|
or
|
|
\fBdescription\fR
|
|
values in repository pool\&.
|
|
.RE
|
|
.PP
|
|
\fBshow \fR\fB\fIpkgname\fR\fR
|
|
.RS 4
|
|
Shows information about binary package
|
|
\fIpkgname\fR\&. This will print the size it takes in filesystem, description, maintainer, architecture and other information\&. The first repository in the pool wins\&.
|
|
\fBNOTE: if a remote repository is the winner and binary package is not available in cachedir, it will fetch remotely and \fR\fB\fIon\-the\-fly\fR\fR\fB the info\fR\&.
|
|
.RE
|
|
.PP
|
|
\fBshow\-deps \fR\fB\fIpkgname\fR\fR
|
|
.RS 4
|
|
Shows run time dependencies for binary package
|
|
\fIpkgname\fR\&. The first repository in the pool wins\&.
|
|
.RE
|
|
.PP
|
|
\fBshow\-files \fR\fB\fIpkgname\fR\fR
|
|
.RS 4
|
|
Shows the file list for a binary package
|
|
\fIpkgname\fR
|
|
by searching it in repository pool\&. The first repository in the pool wins\&.
|
|
\fBNOTE: if a remote repository is the winner and binary package is not available in \fR\fBcachedir\fR\fB, it will fetch remotely and \fR\fB\fIon\-the\-fly\fR\fR\fB the info\fR\&.
|
|
.RE
|
|
.PP
|
|
\fBsync\fR
|
|
.RS 4
|
|
Syncs the package index file for all registered remote repositories\&. The new file will be fetched if local and remote size/mtime do not match\&.
|
|
.RE
|
|
.SH "FILES"
|
|
.PP
|
|
\fB/var/db/xbps/repositories\&.plist\fR
|
|
.RS 4
|
|
Registered repository list\&.
|
|
.RE
|
|
.PP
|
|
\fB/var/db/xbps/<remoterepodir>/pkg\-index\&.plist\fR
|
|
.RS 4
|
|
Remote repository package index file\&.
|
|
.RE
|
|
.PP
|
|
\fB/var/cache/xbps\fR
|
|
.RS 4
|
|
xbps
|
|
\fIcache\fR
|
|
directory for downloaded binary packages\&.
|
|
.RE
|
|
.SH "BUGS"
|
|
.sp
|
|
Probably, but I try to make this not happen\&. Use it under your own responsability and enjoy your life\&.
|
|
.sp
|
|
Report bugs in \fIhttp://code\&.google\&.com/p/xbps\fR\&.
|
|
.SH "SEE ALSO"
|
|
.sp
|
|
xbps\-bin(8), xbps\-src(8)
|
|
.sp
|
|
The XBPS project: \fIhttp://code\&.google\&.com/p/xbps\fR
|
|
.sp
|
|
To build binary packages, the xbps\-src(8) shell script is the command designed for this task\&. This must be retrieved from a Mercurial repository, available at \fIhttp://xbps\-src\&.xbps\&.googlecode\&.com/hg/\fR\&.
|
|
.SH "AUTHORS"
|
|
.sp
|
|
The \fBXBPS binary package system\fR has been designed and implemented by Juan Romero Pardines <xtraeme@gmail\&.com>\&.
|