emo/xbps
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
77ae94e6a1
xbps/bin/xbps-pkgdb/xbps-pkgdb.1

144 lines
4.0 KiB
Groff
Raw Normal View History

xbps-pkgdb(1): extend discussion of package modes description of implications of the various modes was scattered across xbps-pkgdb(1), xbps-install(1), xbps-remove(1).
2016-09-20 12:43:01 +05:30
.Dd September 20, 2016
Move xbps utils manpages to the section 1 (user commands).
2015-05-16 13:15:35 +05:30
.Dt XBPS-PKGDB 1
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.Sh NAME
.Nm xbps-pkgdb
xbps-pkgdb: new option -m --mode <auto|manual> to change pkg install mode.
2013-02-20 15:05:55 +05:30
.Nd XBPS utility to report/fix issues and modify the package database (pkgdb)
Minor changes to the documentation.
2015-10-30 11:15:26 +05:30
.Sh SYNOPSIS
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.Nm xbps-pkgdb
.Op OPTIONS
.Op PKGNAME...
.Sh DESCRIPTION
The
.Nm
xbps-pkgdb: new option -m --mode <auto|manual> to change pkg install mode.
2013-02-20 15:05:55 +05:30
utility can check/fix issues and modify the package database (pkgdb).
It's able to check for missing dependencies, modified files and symlinks,
xbps-pkgdb: add alternatives check Closes #66
2019-03-13 19:21:37 +05:30
alternatives and more errors that have been fixed in newer versions of xbps.
A mode to update the format to the latest version is also available.
xbps-pkgdb.8: explain exactly what checks are executed currently.
2013-02-20 21:02:53 +05:30
This is the list of things that
.Nm
currently does:
.Bl -tag -width -x
.It Sy METADATA CHECK
Checks that package metadata files have not been modified by comparing original
hash that is recorded when package is installed against current one.
.It Sy FILES CHECK
Checks that all files belonging to a package have not been modified and are
not missing.
xbps-pkgdb(8): check pkg file mtime (iff the obj is available).
2015-02-22 23:15:47 +05:30
For regular files, its modification time and the SHA256 hash are
compared and checked if they differ.
For symbolic links the target file is checked that it has not been modified.
xbps-pkgdb.8: explain exactly what checks are executed currently.
2013-02-20 21:02:53 +05:30
.It Sy DEPENDENCIES CHECK
Checks that all required dependencies for a package are resolved.
xbps-pkgdb: add alternatives check Closes #66
2019-03-13 19:21:37 +05:30
.It Sy ALTERNATIVES CHECK
Checks that all alternatives symlinks for set alternatives groups are correct.
xbps-pkgdb.8: explain exactly what checks are executed currently.
2013-02-20 21:02:53 +05:30
.It Sy OBSOLETE METADATA CHECK
Checks that the package database does not contain obsolete data from previous
XBPS versions and removes them if found.
New pkgdb (0.21) and repo index (1.7) format, see NEWS for info.
2013-03-05 08:38:42 +05:30
.It Sy FORMAT CONVERSION
Updates the pkgdb format to the latest version.
bin/*/*.8: add missing End-List macros (.El).
2014-08-23 12:56:02 +05:30
.El
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.Sh OPTIONS
man: use the same width.
2012-11-06 15:03:29 +05:30
.Bl -tag -width -x
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.It Fl a, Fl -all
Process all registered packages, regardless of its state.
Replaced config/system {repo,preserve,virtualpkg}.d with a single directory. See the NEWS file for more information.
2014-11-06 14:28:04 +05:30
.It Fl C, Fl -config Ar dir
Specifies a path to the XBPS configuration directory.
xbps-pkgdb.1: fix invalid escape
2017-07-11 07:59:19 +05:30
If the first character is not '/' then it's a relative path of
Replaced config/system {repo,preserve,virtualpkg}.d with a single directory. See the NEWS file for more information.
2014-11-06 14:28:04 +05:30
.Ar rootdir .
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.It Fl d, Fl -debug
Enables extra debugging shown to stderr.
.It Fl h, Fl -help
Minor changes to the documentation.
2015-10-30 11:15:26 +05:30
Show the help message.
Implemented feature #77 (Add package repository locked mode) Close #77
2015-03-03 16:41:28 +05:30
.It Fl m, Fl -mode Ar auto|manual|hold|unhold|repolock|repounlock
xbps-pkgdb(1): extend discussion of package modes description of implications of the various modes was scattered across xbps-pkgdb(1), xbps-install(1), xbps-remove(1).
2016-09-20 12:43:01 +05:30
.
.Bl -tag -width -x
.
.It Sy auto , manual
.Sy auto No marks each Ar PKGNAME
as
.Sy automatic -
as if it was installed implicitly as a dependency of another package.
.Sy manual No marks each Ar PKGNAME
as if it was installed explicitly as an operand to
.Xr xbps-install 1 .
Remove PackagesOnHold from xbps.conf; use xbps-pkgdb -m hold|unhold instead. To put a package on hold mode: $ xbps-pkgdb -m hold foo To unhold the package: $ xbps-pkgdb -m unhold foo To list packages on hold mode: $ xbps-query -H This also close #12 from github.
2013-08-12 18:16:54 +05:30
.Sy automatic
xbps-pkgdb(1): extend discussion of package modes description of implications of the various modes was scattered across xbps-pkgdb(1), xbps-install(1), xbps-remove(1).
2016-09-20 12:43:01 +05:30
packages are considered for removal by
.Nm xbps-remove Fl -remove-orphans ;
see also
.Fl -list-manual-pkgs ,
.Fl -list-orphans
in
.Xr xbps-query 1 .
.
.It Sy hold , unhold
Set or unset the
Remove PackagesOnHold from xbps.conf; use xbps-pkgdb -m hold|unhold instead. To put a package on hold mode: $ xbps-pkgdb -m hold foo To unhold the package: $ xbps-pkgdb -m unhold foo To list packages on hold mode: $ xbps-query -H This also close #12 from github.
2013-08-12 18:16:54 +05:30
.Sy hold
xbps-pkgdb(1): extend discussion of package modes description of implications of the various modes was scattered across xbps-pkgdb(1), xbps-install(1), xbps-remove(1).
2016-09-20 12:43:01 +05:30
mode for each
.Ar PKGNAME .
.Nm xbps-install Fl u
does not update packages on
.Sy hold ;
see also
.Fl -list-hold-pkgs
in
Move xbps utils manpages to the section 1 (user commands).
2015-05-16 13:15:35 +05:30
.Xr xbps-query 1 .
xbps-pkgdb(1): extend discussion of package modes description of implications of the various modes was scattered across xbps-pkgdb(1), xbps-install(1), xbps-remove(1).
2016-09-20 12:43:01 +05:30
.
.It Sy repolock , repounlock
Set or unset the
.Sy repolock
mode for each
.Ar PKGNAME .
Implemented feature #77 (Add package repository locked mode) Close #77
2015-03-03 16:41:28 +05:30
A package in
.Sy repolock
mode will only accept updates that are available in the same repository that was used
for installing.
xbps-pkgdb(1): extend discussion of package modes description of implications of the various modes was scattered across xbps-pkgdb(1), xbps-install(1), xbps-remove(1).
2016-09-20 12:43:01 +05:30
See also
.Fl -list-repolock-pkgs
in
.Xr xbps-query 1 .
.El
.
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.It Fl r, Fl -rootdir Ar dir
Specifies a full path for the target root directory.
New pkgdb (0.21) and repo index (1.7) format, see NEWS for info.
2013-03-05 08:38:42 +05:30
.It Fl u, Fl -update
Updates the pkgdb format to the latest version making the necessary conversions
automatically. Usually this is needed only in rare circumstances.
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.It Fl v, Fl -verbose
Enables verbose messages.
.It Fl V, Fl -version
Minor changes to the documentation.
2015-10-30 11:15:26 +05:30
Show the version information.
bin/*/*.8: add missing End-List macros (.El).
2014-08-23 12:56:02 +05:30
.El
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.Sh FILES
bin/*/*.8: sync with reality.
2014-09-11 15:51:33 +05:30
.Bl -tag -width /var/db/xbps/.<pkgname>-files.plist
Replaced config/system {repo,preserve,virtualpkg}.d with a single directory. See the NEWS file for more information.
2014-11-06 14:28:04 +05:30
.It Ar /etc/xbps.d
Default configuration directory.
bin/*/*.8: mention system configuration directory.
2014-12-15 13:54:55 +05:30
.It Ar /usr/share/xbps.d
Default system configuration directory.
bin/*/*.8: sync with reality.
2014-09-11 15:51:33 +05:30
.It Ar /var/db/xbps/.<pkgname>-files.plist
Package files metadata.
.It Ar /var/db/xbps/pkgdb-0.38.plist
Default package database (0.38 format). Keeps track of installed packages and properties.
New pkgdb (0.21) and repo index (1.7) format, see NEWS for info.
2013-03-05 08:38:42 +05:30
.It Ar /var/cache/xbps
Default cache directory to store downloaded binary packages.
bin/*/*.8: add missing End-List macros (.El).
2014-08-23 12:56:02 +05:30
.El
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.Sh SEE ALSO
Move xbps utils manpages to the section 1 (user commands).
2015-05-16 13:15:35 +05:30
.Xr xbps-checkvers 1 ,
.Xr xbps-create 1 ,
xbps-pkgdb.1: fix a mandoc -Wall warning.
2015-05-28 12:43:12 +05:30
.Xr xbps-dgraph 1 ,
New manual page for xbps-fbulk(1).
2015-10-28 14:07:09 +05:30
.Xr xbps-fbulk 1 ,
Move xbps utils manpages to the section 1 (user commands).
2015-05-16 13:15:35 +05:30
.Xr xbps-install 1 ,
.Xr xbps-query 1 ,
.Xr xbps-reconfigure 1 ,
.Xr xbps-remove 1 ,
.Xr xbps-rindex 1 ,
.Xr xbps-uchroot 1 ,
.Xr xbps-uunshare 1 ,
.Xr xbps.d 5
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.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
xbps-xxx.1: responsability -> responsibility.
2015-10-28 14:33:41 +05:30
responsibility and enjoy your life.
xbps-pkgdb: added a manual page.
2012-11-06 14:24:43 +05:30
.Pp
manpages: change URL for bug reporting to new GitHub repo
2018-09-23 21:21:07 +05:30
Report bugs at https://github.com/void-linux/xbps/issues
Reference in New Issue Copy Permalink