'\" t
.\" Title: check-support-status
.\" Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot
.\" Date: 01/30/2024
.\" Manual: \ \&
.\" Source: \ \&
.\" Language: English
.\"
.TH "CHECK\-SUPPORT\-STAT" "1" "01/30/2024" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * 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:13+2024.01.30
.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
.SH "COPYRIGHT & LICENSE"
.sp
.if n \{\
.RS 4
.\}
.nf
Copyright (C) 2014 Christoph Biedl
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
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
.\}