emo/xbps
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
f2b05d6438
xbps/bin/xbps-repo/xbps-repo.8

133 lines
4.1 KiB
Groff
Raw Normal View History

xbps-repo: the 'search' target now accepts multiple patterns as arguments.
2011-12-22 14:03:54 +05:30
.Dd December 22, 2011
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.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
Remove asciidoc build dependency, use troff manpages directly.
2010-05-04 01:20:34 +05:30
Sets the
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.Em cache
directory to store downloaded binary packages from remote
repositories. By default set to
.Pa /var/cache/xbps .
.It Fl d
API clean up (part 2), plus misc changes and improvements. - Rename regpkgs_dictionary to regpkgdb_dictionary to better describe what is is. - Change some funcs in plist.c to return a boolean rather than int. - Hide more internal funcs off the API. - Simplify xbps_repository_update_pkg() and remove its second arg. - Hide implementation details in xbps_repository_pool, now to iterate over the pool you have to use xbps_repository_pool_foreach and its struct repository_pool_index. - Introduce xbps_{init,end}, to initialize/destroy some stuff in the library. - Introduce xbps_dbg_printf to printf stuff for debugging purposes. - xbps-{bin,repo}: added -d arg to enable debugging output. - Before checking if a config file needs to be installed or such, check that package contains the "conf_files" array. - Remove obsolete dirs as well while updating packages. - If transaction dictionary is ready remove the "missing_deps" array. Bump XBPS_RELVER to 20101118. --HG-- rename : lib/regpkgs_dictionary.c => lib/regpkgdb_dictionary.c
2010-11-19 18:10:13 +05:30
Enables extra debugging output to be shown to stderr.
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.It Fl o Ar key Op key2,...
xbps-{bin,repo}: new -o flag for the 'show' target, to print specific objs value.
2011-10-29 11:47:54 +05:30
Used currently in the
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.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
Remove asciidoc build dependency, use troff manpages directly.
2010-05-04 01:20:34 +05:30
Sets the
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.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
xbps-bin(8): fix 'find-files' syntax in manpage.
2011-12-22 15:37:54 +05:30
.It Sy find-files Ar pattern Ar [patterns ...]
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
Prints the name of
.Em package(s)
matching the pattern on its file list by looking in all repositories index files.
xbps-repo(8): the 'find-files' target now accepts multiple patterns.
2011-12-22 15:31:28 +05:30
Multiple patterns can be specified as arguments.
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.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
xbps-repo(8): fix wrong sentence.
2011-01-29 22:18:13 +05:30
extension and will only add it into the index if version is newer than the one
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
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 index
Lists all currently registered packages in repository index as specified
in the
.Ar index
argument. If argument is not specified, any package contained in all repositories
will be shown. The argument expects a decimal number starting from 0,
matching the output of the
.Ar list
target.
xbps-repo: the 'search' target now accepts multiple patterns as arguments.
2011-12-22 14:03:54 +05:30
.It Sy search Ar pattern Ar [patterns ...]
Remove asciidoc build dependency, use troff manpages directly.
2010-05-04 01:20:34 +05:30
Search for packages containing the shell
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.Em pattern
(see
.Xr fnmatch 3 )
in its
.Em pkgname
Remove asciidoc build dependency, use troff manpages directly.
2010-05-04 01:20:34 +05:30
or
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.Em description
values in repository pool. Please note that patterns are matched in case
xbps-repo: the 'search' target now accepts multiple patterns as arguments.
2011-12-22 14:03:54 +05:30
insensitive mode. Multiple patterns can be specified as arguments.
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.It Sy show Ar pkgname
Remove asciidoc build dependency, use troff manpages directly.
2010-05-04 01:20:34 +05:30
Shows information about binary package
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.Em pkgname .
This will print the size it takes in filesystem, description, maintainer,
architecture and other information. The first repository in the pool wins.
.It Sy show-deps Ar pkgname
Shows run time dependencies for the binary package
.Ar pkgname .
The first repository in the pool wins.
.It Sy show-files Ar pkgname
Shows the file list for the binary package
.Ar pkgname .
The first repository containing the matching
.Ar pkgname
in the pool wins.
.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
Syncs the package index file for all registered remote repositories.
The index file will be fetched if local and remote size/mtime do not match.
.Sh FILES
.Bl -tag -width /var/db/xbps/<remoterepodir>/index.plist -compact
.It Pa /etc/xbps/xbps.conf
Default XBPS configuration file.
.It Pa /var/db/xbps/<remoterepodir>/index.plist
Remote repository package index 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.
Reference in New Issue Copy Permalink