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

160 lines
5.1 KiB
Groff
Raw Normal View History

xbps-{bin,repo}: add -B flag to set default repo if xbps.conf not found. (cherry picked from commit 75eac1a1426040a833e0b10e208f2e55fa359532)
2012-09-24 15:33:47 +05:30
.Dd September 24, 2012
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
xbps-{bin,repo}: add -B flag to set default repo if xbps.conf not found. (cherry picked from commit 75eac1a1426040a833e0b10e208f2e55fa359532)
2012-09-24 15:33:47 +05:30
.It Fl B Ar repository
If a configuration file cannot be found, this repository will be used as
as primary source to install packages.
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.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-repo(8): new target 'clean': removes obsolete binpkgs from cachedir.
2012-05-05 13:37:47 +05:30
.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.
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: replaced 'genindex' target with 'index-{add,clean}'. See the NEWS file for more information.
2012-07-17 16:01:04 +05:30
.It Sy index-add Ar /path/to/local/repository/foo-1.0.arch.xbps
This will register the binary package into the local repository's index files, and remove
old entry and binary package if any old version exists.
Multiple binary packages can be specified.
.It Sy index-clean Ar /path/to/local/repository
This will remove any obsolete entry found in the local repository's index files.
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.It Sy list
Lists all working repositories in repository pool.
xbps-repo: 'sync' and 'pkg-list' target now accept a repository URI argument. If set, only the matching repository will be used for the task.
2012-06-01 18:32:06 +05:30
.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.
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
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(8): the search target now shows which pkgs are currently installed.
2012-07-31 14:04:10 +05:30
insensitive mode. Multiple patterns can be specified as arguments. Packages that
have the
.Sy *
character as prefix are currently installed.
xbps-repo: new 'remove-obsoletes' target to remove obsolete pkgs in a local repo.
2012-07-22 14:18:29 +05:30
.It Sy remove-obsoletes Ar /path/to/local/repository
Removes obsolete packages from
.Ar repository .
Packages that are not currently registered in repository's index will
be removed.
xbps-repo.8: sync with reality.
2012-02-20 20:32:42 +05:30
.It Sy show Ar pkgname | pkgpattern
Shows information for binary package
.Ar pkgname
or a package matching
.Ar pkgpattern .
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
This will print the size it takes in filesystem, description, maintainer,
xbps-repo.8: sync with reality.
2012-02-20 20:32:42 +05:30
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
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
Shows the file list for the binary package
.Ar pkgname
xbps-repo.8: sync with reality.
2012-02-20 20:32:42 +05:30
or a package matching
.Ar pkgpattern .
The same rules than in the
.Em show
target also apply here.
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.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.
xbps-repo: 'sync' and 'pkg-list' target now accept a repository URI argument. If set, only the matching repository will be used for the task.
2012-06-01 18:32:06 +05:30
.It Sy sync Op repository
Syncs the package index file for all remote repositories or just for
.Ar repository .
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
The index file will be fetched if local and remote size/mtime do not match.
.Sh FILES
xbps-repo.8: update.
2012-06-01 17:53:23 +05:30
.Bl -tag -width /var/db/xbps/<repodir>/index-files.plist -compact
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.It Pa /etc/xbps/xbps.conf
Default XBPS configuration file.
xbps-repo.8: update.
2012-06-01 17:53:23 +05:30
.It Pa /var/db/xbps/<repodir>/index.plist
xbps-repo.8: rewording.
2012-06-05 18:12:03 +05:30
Repository package index file.
xbps-repo.8: update.
2012-06-01 17:53:23 +05:30
.It Pa /var/db/xbps/<repodir>/index-files.plist
xbps-repo.8: rewording.
2012-06-05 18:12:03 +05:30
Repository package files index ile.
xbps-repo(8): rewriten manpage to mdoc(7) macro format.
2011-12-17 23:00:13 +05:30
.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