| .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" |
| .TP |
| \fB\-l\fR, \fB\-\-list\fR List a summary for the given GLSA(s) or set and whether they affect the system\. |
| .TP |
| \fB\-d\fR, \fB\-\-dump\fR, \fB\-\-print\fR Show all information about the GLSA(s) or set\. |
| .TP |
| \fB\-t\fR, \fB\-\-test\fR Test if this system is affected by the GLSA(s) or set and output the GLSA ID(s)\. |
| .TP |
| \fB\-p\fR, \fB\-\-pretend\fR Show the necessary steps to remediate the system\. |
| .TP |
| \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\. |
| .TP |
| \fB\-i\fR, \fB\-\-inject\fR Inject the given GLSA(s) into the glsa_injected file\. |
| .TP |
| \fB\-n\fR, \fB\-\-nocolor\fR Removes color from output\. |
| .TP |
| \fB\-h\fR, \fB\-\-help\fR Show this help message\. |
| .TP |
| \fB\-V\fR, \fB\-\-version\fR Show information about \fBglsa\-check\fR\. |
| .TP |
| \fB\-v\fR, \fB\-\-verbose\fR Print more messages\. |
| .TP |
| \fB\-c\fR, \fB\-\-cve\fR Show CVE IDs in listing mode\. |
| .TP |
| \fB\-q\fR, \fB\-\-quiet\fR Be less verbose and do not send empty mail\. |
| .TP |
| \fB\-m\fR, \fB\-\-mail\fR Send a mail with the given GLSAs to the administrator\. |
| .TP |
| \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\. |
| .TP |
| \fBglsa\-check \-t 201801\-01\fR Test the system against the specific GLSA 201801\-01\. |
| .SH "EXIT VALUES" |
| .TP |
| \fB0\fR Success |
| .TP |
| \fB1\fR Syntax or usage error |
| .TP |
| \fB2\fR Missing permissions, solution, etc |
| .TP |
| \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 |