aboutsummaryrefslogtreecommitdiff
blob: f1041737f126c6c309d1bef3daef2d30e10b8151 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
.TH "GLSA\-CHECK" "1" "August 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 | new | 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\-q\fR, \fB\-\-quiet\fR Be less verbose and do not send empty mail\.
.
.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\.
.
.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 "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