.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "APT-SHOW-VERSIONS 1p"
.TH APT-SHOW-VERSIONS 1p "2022-10-15" "perl v5.34.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
apt\-show\-versions \- Lists available package versions with distribution
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
apt-show-versions parses the dpkg status file and the \s-1APT\s0 lists for
the installed and available package versions and distribution and
shows upgrade options within the specific distribution of the selected
package.
.PP
This is really useful if you have a mixed stable/testing environment
and want to list all packages which are from testing and can be
upgraded in testing.
.PP
apt-show-versions uses caching for the status information of installed
and available packages. If you run apt-show-versions as root the
cache is updated as needed. If you run as non-root uses the newest
available information, but can't update the cache. If you run as root
with the option \fB\-i\fR the cache is initialized or updated only.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBapt-show-versions\fR [\fB\-h\fR] [[\fB\-p\fR] \fIpackage name\fR] [\fB\-a\fR] [\fB\-b\fR]
.SH "OPTIONS"
.IX Header "OPTIONS"
If you don't give any options the status of all installed packages is
printed.
.IP "\fB\-p\fR \fIpackage\fR, \fB\-\-package\fR=\fIpackage\fR" 4
.IX Item "-p package, --package=package"
Print available and installed versions for specified \fIpackage\fR. You
can also specify a package name without the option \fB\-p\fR. If \fB\-p\fR and
a package name are missing, all installed packages are displayed.
.IP "\fB\-r\fR, \fB\-\-regex\fR" 4
.IX Item "-r, --regex"
interpret \fIpackage\fR from option \fB\-p\fR as a regex.
.IP "\fB\-R\fR, \fB\-\-regex\-all\fR" 4
.IX Item "-R, --regex-all"
like \fB\-\-regex\fR, but also show matching packages which are not installed
.IP "\fB\-u\fR, \fB\-\-upgradeable\fR" 4
.IX Item "-u, --upgradeable"
Print only upgradeable packages
.IP "\fB\-a\fR, \fB\-\-allversions\fR" 4
.IX Item "-a, --allversions"
Print all available versions of the selected packages
.IP "\fB\-b\fR, \fB\-\-brief\fR" 4
.IX Item "-b, --brief"
Print only package_name/distribution for upgradeable packages
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
Prints out messages about which package files are parsed.
.IP "\fB\-V\fR, \fB\-\-version\fR" 4
.IX Item "-V, --version"
Prints out version of apt-show-versions
.IP "\fB\-i\fR, \fB\-\-initialize\fR" 4
.IX Item "-i, --initialize"
Initialize or update package cache only (as root). Do this every time
when the status of the installed or available packages has
changed. Initialization is done automatically on installation of the
package and via a cron.daily job.
.IP "\fB\-stf\fR \fIfile\fR, \fB\-\-status\-file\fR=\fIfile\fR" 4
.IX Item "-stf file, --status-file=file"
Use \fIfile\fR as the dpkg status file instead of /var/lib/dpkg/status
.IP "\fB\-ld\fR \fIdirectory\fR, \fB\-\-list\-dir\fR=\fIdirectory\fR" 4
.IX Item "-ld directory, --list-dir=directory"
Use \fIdirectory\fR as path to apt's list files instead of
/var/state/apt/lists/ or /var/lib/apt/lists/
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
Prints out command-line help.
.SH "EXIT CODES"
.IX Header "EXIT CODES"
.ie n .IP "0" 4
.el .IP "\f(CW0\fR" 4
.IX Item "0"
No error
.ie n .IP "1" 4
.el .IP "\f(CW1\fR" 4
.IX Item "1"
Wrong usage
.ie n .IP "2" 4
.el .IP "\f(CW2\fR" 4
.IX Item "2"
apt-show-versions has been called with exactly one package and upgradeable
option set, but package is uptodate. As no output has been requested, this
case gets signaled using the exit code.
.ie n .IP "255" 4
.el .IP "\f(CW255\fR" 4
.IX Item "255"
Unspecified error
.SH "EXAMPLES"
.IX Header "EXAMPLES"
If you want to know for all your installed packages whether they are
uptodate or upgradeable, use:
.PP
.Vb 1
\&    apt\-show\-versions
.Ve
.PP
If you want to have a list of all upgradeable packages:
.PP
.Vb 1
\&    apt\-show\-versions \-u
.Ve
.PP
To get a list of all available versions of libc6:
.PP
.Vb 1
\&    apt\-show\-versions \-a \-p libc6
.Ve
.PP
To get information about several packages:
.PP
.Vb 1
\&    apt\-show\-versions dpkg apt
\&
\&    apt\-show\-versions \-r ^texlive
.Ve
.PP
To upgrade all packages in testing:
.PP
.Vb 1
\&    apt\-get install \`apt\-show\-versions \-u \-b | grep testing\`
.Ve
.SH "AUTHOR"
.IX Header "AUTHOR"
Christoph Martin, martin@uni\-mainz.de
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBapt\fR\|(8), \fBdpkg\fR\|(1)