blob: 23b5e9d94df684a73aa772f62eb74603aaaf7fc1 [file] [log] [blame]
.TH "GLSA\-CHECK" "1" "September 2019" "Portage VERSION" "Portage"
.
.SH "NAME"
\fBglsa\-check\fR \- Tool to locally monitor and manage GLSAs
.
.SH "SYNOPSIS"
\fBglsa\-check\fR [options] [glsa\-id | all | affected]
.
.SH "DESCRIPTION"
\fBglsa\-check\fR is used to locally monitor and manage Gentoo Linux Security Advisories\. In order for \fBglsa\-check\fR to be effective, it is required that a local repository exists containing GLSA metadata\.
.
.SH "OPTIONS"
\fB\-l\fR, \fB\-\-list\fR List a summary for the given GLSA(s) or set and whether they affect the system\.
.
.P
\fB\-d\fR, \fB\-\-dump\fR, \fB\-\-print\fR Show all information about the GLSA(s) or set\.
.
.P
\fB\-t\fR, \fB\-\-test\fR Test if this system is affected by the GLSA(s) or set and output the GLSA ID(s)\.
.
.P
\fB\-p\fR, \fB\-\-pretend\fR Show the necessary steps to remediate the system\.
.
.P
\fB\-f\fR, \fB\-\-fix\fR (experimental) Attempt to remediate the system based on the instructions given in the GLSA(s) or set\. This will only upgrade (when an upgrade path exists) or remove packages\.
.
.P
\fB\-i\fR, \fB\-\-inject\fR Inject the given GLSA(s) into the glsa_injected file\.
.
.P
\fB\-n\fR, \fB\-\-nocolor\fR Removes color from output\.
.
.P
\fB\-h\fR, \fB\-\-help\fR Show this help message\.
.
.P
\fBV\fR, \fB\-\-version\fR Show information about \fBglsa\-check\fR\.
.
.P
\fB\-v\fR, \fB\-\-verbose\fR Print more messages\.
.
.P
\fB\-c\fR, \fB\-\-cve\fR Show CVE IDs in listing mode\.
.
.P
\fB\-q\fR, \fB\-\-quiet\fR Be less verbose and do not send empty mail\.
.
.P
\fB\-m\fR, \fB\-\-mail\fR Send a mail with the given GLSAs to the administrator\.
.
.P
\fB\-r\fR, \fB\-\-reverse\fR List GLSAs in reverse order
.
.SH "EXAMPLES"
\fBglsa\-check \-t all\fR Test the system against all GLSAs in the GLSA repository\.
.
.P
\fBglsa\-check \-t 201801\-01\fR Test the system against the specific GLSA 201801\-01\.
.
.SH "EXIT VALUES"
\fB0\fR Success
.
.P
\fB1\fR Syntax or usage error
.
.P
\fB2\fR Missing permissions, solution, etc
.
.P
\fB6\fR System is affected by some GLSAs
.
.SH "FILES"
\fB/var/lib/portage/glsa_injected\fR List of GLSA ids that have been injected and will never show up as \'affected\' on this system\. The file must contain one GLSA ID (e\.g\. \'200804\-02\') per line\.
.
.SH "BUGS"
All bugs should be reported to the Portage team via https://bugs\.gentoo\.org