xbps/bin/xbps-checkvers/xbps-checkvers.1

123 lines
3.2 KiB
Groff
Raw Permalink Normal View History

.Dd Feb 9, 2023
.Dt XBPS-CHECKVERS 1
.Os
2014-04-07 15:50:09 +05:30
.Sh NAME
.Nm xbps-checkvers
.Nd XBPS utility to check for outdated packages
2015-10-30 11:15:26 +05:30
.Sh SYNOPSIS
.Nm
2014-04-07 15:50:09 +05:30
.Op OPTIONS
.Op FILES...
.Sh DESCRIPTION
The
.Nm
utility checks for outdated packages in a target root directory or in
all registered repositories by comparing the package versions against
the source package versions available in a
2014-09-26 17:54:06 +05:30
.Nm void-packages
2014-04-07 15:50:09 +05:30
tree. By default and unless the
.Fl I, Fl -installed
option is set, it will compare package versions in repositories against
2014-04-07 15:50:09 +05:30
the
2014-09-26 17:54:06 +05:30
.Nm void-packages
2019-06-19 17:00:57 +05:30
tree.
The
2014-04-07 15:50:09 +05:30
.Ar FILES
argument sets extra packages to process with the outdated ones (only processed if missing).
.Sh OPTIONS
.Bl -tag -width -x
.It Fl C, Fl -config Ar dir
Specifies a path to the XBPS configuration directory.
2017-07-11 07:58:13 +05:30
If the first character is not '/' then it's a relative path of
.Ar rootdir .
.It Fl D, Fl -distdir Ar dir
2014-09-26 17:54:06 +05:30
Specifies a full path to the void-packages repository. By default set to
.Nm ~/void-packages .
.It Fl e, Fl -removed
List packages present in repos, but not in distdir.
2020-01-28 02:08:30 +05:30
Srcver is a question mark for them.
.It Fl d, Fl -debug
Enables extra debugging shown to stderr.
2019-06-14 16:29:25 +05:30
.It Fl f, Fl -format Ar format
Format according to the string
.Ar format ,
inspired by
.Xr printf 3 .
.Pp
The following formatting codes may be used:
.Bl -tag -width Ds
.It Cm \en
Newline.
.It Cm \et
Tab.
.It Cm \e0
NULL.
.It Cm \&%%
A plain
.Sq Li \&% .
.It Cm \&%n
The package name.
.It Cm \&%r
2019-06-20 18:55:14 +05:30
The package version from repositories or pkgdb (returns ? if not found).
2019-06-14 16:29:25 +05:30
.It Cm \&%s
2019-06-20 18:55:14 +05:30
The source package version (returns ? if not found).
.It Cm \&%t
The requested template name (this can be a sub package).
.It Cm \&%R
The repository url (returns ? if not found).
2019-06-14 16:29:25 +05:30
.El
.Pp
The default format is
2019-06-19 17:00:57 +05:30
.Dq Cm "%n %r %s %t %R" .
2014-04-07 15:50:09 +05:30
.It Fl h, Fl -help
2015-10-30 11:15:26 +05:30
Show the help message.
.It Fl i, Fl -ignore-conf-repos
Ignore repositories defined in configuration files.
Only repositories specified in the command line via
.Ar --repository
will be used.
.It Fl I, Fl -installed
2014-04-07 15:50:09 +05:30
Check for outdated installed packages rather than in repositories.
2019-06-13 23:39:37 +05:30
.It Fl m, Fl -manual
Only process listed files.
.It Fl R, Fl -repository=uri
Repository to be added to the top of the list. This option can be specified multiple times.
2014-04-07 15:50:09 +05:30
.It Fl r, Fl -rootdir Ar dir
Specifies a full path for the target root directory.
.It Fl s, Fl -show-all
List all packages found in the
2014-09-26 17:54:06 +05:30
.Nm void-packages
tree and prints version available in repository and srcpkgs with the following format:
.Ar pkgname repover srcver .
If any version can't be resolved,
.Em ?
is printed instead.
2014-04-07 15:50:09 +05:30
.It Fl V, Fl -version
2015-10-30 11:15:26 +05:30
Show the version information.
.El
2014-04-07 15:50:09 +05:30
.Sh SEE ALSO
.Xr xbps-alternatives 1 ,
.Xr xbps-create 1 ,
.Xr xbps-dgraph 1 ,
.Xr xbps-digest 1 ,
2015-10-28 14:07:09 +05:30
.Xr xbps-fbulk 1 ,
.Xr xbps-fetch 1 ,
.Xr xbps-install 1 ,
.Xr xbps-pkgdb 1 ,
.Xr xbps-query 1 ,
.Xr xbps-reconfigure 1 ,
.Xr xbps-rindex 1 ,
.Xr xbps-uchroot 1 ,
.Xr xbps-uunshare 1 ,
.Xr xbps.d 5
2014-04-07 15:50:09 +05:30
.Sh AUTHORS
.An Dave Elusive Aq Mt davehome@redthumb.info.tm
.An Juan Romero Pardines Aq Mt xtraeme@gmail.com
.An Duncan Overbruck Aq Mt mail@duncano.de
2014-04-07 15:50:09 +05:30
.Sh BUGS
Probably, but I try to make this not happen. Use it under your own
responsibility and enjoy your life.
2014-04-07 15:50:09 +05:30
.Pp
Report bugs at
.Lk https://github.com/void-linux/xbps/issues