'\" t
.\"     Title: check-support-status
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 08/23/2022
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "CHECK\-SUPPORT\-STAT" "1" "08/23/2022" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
check-support-status \- check installed packages for security support (debian\-security\-support)
.SH "VERSION"
.sp
Version 1:11+2022.08.23
.SH "SYNOPSIS"
.sp
Search for packages whose support is limited, has already ended or will end earlier than the distribution\(cqs end of life:
.sp
.nf
    check\-support\-status
.fi
.sp
Search for packages with ended support from a custom list, reporting each package only once:
.sp
.nf
    check\-support\-status \e
        \-\-type ended \e
        \-\-status\-db /path/to/status\-db \e
        \-\-list /path/to/security\-support\-ended
.fi
.SH "OPTIONS"
.PP
\fB\-\-list\fR \fIFILE\fR
.RS 4
Use the given file as the database of packages whose support ends at a particular date or that is limited by specific conditions\&. The file format is plain text in columns, separated by one or more whitespace characters\&.
.sp
For
\-\-type earlyend:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
source package name
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
last package version that will be supported
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
the date support will end
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
the rest (optional): details, and/or a URL for further information\&.
.RE
.sp
For
\-\-type ended:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
source package name
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
last package version that is supported
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
the date support was ended
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
the rest (optional): details, and/or a URL for further information\&.
.RE
.sp
For
\-\-type limited:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
source package name
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
the rest (optional): details, and/or a URL for further information\&.
.RE
.sp
If no "\-\-list" is provided, the script is run for limited and date\-defined end of support, using the lists shipped in the package\&.
.sp
By default, check\-support\-status evaluates the status of the packages according to the Debian version where it runs upon\&. This behavior can be modified using the DEBIAN_VERSION environment variable, e\&.g\&.
.sp
.if n \{\
.RS 4
.\}
.nf
DEBIAN_VERSION=9 check\-support\-status
.fi
.if n \{\
.RE
.\}
.RE
.PP
\fB\-\-no\-heading\fR
.RS 4
Skips printing a headline\&.
.RE
.PP
\fB\-\-status\-db\fR \fIFILE\fR
.RS 4
Use the given file to record alerts so each affected package is reported only once\&.
.sp
Default: No records, any affected package will be reported every time\&.
.RE
.PP
\fB\-\-except\fR \fIPACKAGES\fR
.RS 4
Do not alert for the given binary packages (comma\-separated list)\&.
.sp
Default: Alert for all packages (no exceptions)\&.
.RE
.PP
\fB\-\-type\fR \fITYPE\fR
.RS 4
One of the following:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
"earlyend": Alert for packages whose support will end earlier than the distribution\(cqs\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
"ended": Alert for packages where security support has ended\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
"limited": Alert for packages where security support is limited\&.
.RE
.RE
.PP
\fB\-\-version, \-\-Version, \-V\fR
.RS 4
Show the version number and exit\&.
.RE
.SH "BUGS"
.sp
Installations with mixed distributions like half\-stable, half\-testing are not supported\&.
.SH "AUTHOR"
.sp
Christoph Biedl <debian\&.axhn@manchmal\&.in\-ulm\&.de>
.SH "COPYRIGHT & LICENSE"
.sp
.if n \{\
.RS 4
.\}
.nf
Copyright (C) 2014 Christoph Biedl <debian\&.axhn@manchmal\&.in\-ulm\&.de>

This package is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
version 2 as published by the Free Software Foundation\&.

This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE\&.  See the
GNU General Public License for more details\&.

You should have received a copy of the GNU General Public License
along with this program\&. If not, see <http://www\&.gnu\&.org/licenses/>

On Debian systems, the complete text of the GNU General Public
License version 2 can be found in
"/usr/share/common\-licenses/GPL\-2"\&.
.fi
.if n \{\
.RE
.\}