Gentoo Archives: gentoo-commits

From: Zac Medico <zmedico@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] proj/portage:master commit in: man/
Date: Sun, 01 Sep 2019 22:11:21
Message-Id: 1567375655.582e681e3911d3cc09b7729e564c5862db368478.zmedico@gentoo
1 commit: 582e681e3911d3cc09b7729e564c5862db368478
2 Author: Zac Medico <zmedico <AT> gentoo <DOT> org>
3 AuthorDate: Sun Sep 1 22:04:16 2019 +0000
4 Commit: Zac Medico <zmedico <AT> gentoo <DOT> org>
5 CommitDate: Sun Sep 1 22:07:35 2019 +0000
6 URL: https://gitweb.gentoo.org/proj/portage.git/commit/?id=582e681e
7
8 man/glsa-check.1: fix man2html formatting
9
10 Signed-off-by: Zac Medico <zmedico <AT> gentoo.org>
11
12 man/glsa-check.1 | 65 ++++++++++++++++++--------------------------------------
13 1 file changed, 21 insertions(+), 44 deletions(-)
14
15 diff --git a/man/glsa-check.1 b/man/glsa-check.1
16 index 23b5e9d94..4fe1ad506 100644
17 --- a/man/glsa-check.1
18 +++ b/man/glsa-check.1
19 @@ -1,76 +1,53 @@
20 -.TH "GLSA\-CHECK" "1" "September 2019" "Portage VERSION" "Portage"
21 -.
22 +.TH "GLSA-CHECK" "1" "September 2019" "Portage VERSION" "Portage"
23 .SH "NAME"
24 \fBglsa\-check\fR \- Tool to locally monitor and manage GLSAs
25 -.
26 .SH "SYNOPSIS"
27 \fBglsa\-check\fR [options] [glsa\-id | all | affected]
28 -.
29 .SH "DESCRIPTION"
30 \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\.
31 -.
32 .SH "OPTIONS"
33 +.TP
34 \fB\-l\fR, \fB\-\-list\fR List a summary for the given GLSA(s) or set and whether they affect the system\.
35 -.
36 -.P
37 +.TP
38 \fB\-d\fR, \fB\-\-dump\fR, \fB\-\-print\fR Show all information about the GLSA(s) or set\.
39 -.
40 -.P
41 +.TP
42 \fB\-t\fR, \fB\-\-test\fR Test if this system is affected by the GLSA(s) or set and output the GLSA ID(s)\.
43 -.
44 -.P
45 +.TP
46 \fB\-p\fR, \fB\-\-pretend\fR Show the necessary steps to remediate the system\.
47 -.
48 -.P
49 +.TP
50 \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\.
51 -.
52 -.P
53 +.TP
54 \fB\-i\fR, \fB\-\-inject\fR Inject the given GLSA(s) into the glsa_injected file\.
55 -.
56 -.P
57 +.TP
58 \fB\-n\fR, \fB\-\-nocolor\fR Removes color from output\.
59 -.
60 -.P
61 +.TP
62 \fB\-h\fR, \fB\-\-help\fR Show this help message\.
63 -.
64 -.P
65 -\fBV\fR, \fB\-\-version\fR Show information about \fBglsa\-check\fR\.
66 -.
67 -.P
68 +.TP
69 +\fB\-V\fR, \fB\-\-version\fR Show information about \fBglsa\-check\fR\.
70 +.TP
71 \fB\-v\fR, \fB\-\-verbose\fR Print more messages\.
72 -.
73 -.P
74 +.TP
75 \fB\-c\fR, \fB\-\-cve\fR Show CVE IDs in listing mode\.
76 -.
77 -.P
78 +.TP
79 \fB\-q\fR, \fB\-\-quiet\fR Be less verbose and do not send empty mail\.
80 -.
81 -.P
82 +.TP
83 \fB\-m\fR, \fB\-\-mail\fR Send a mail with the given GLSAs to the administrator\.
84 -.
85 -.P
86 +.TP
87 \fB\-r\fR, \fB\-\-reverse\fR List GLSAs in reverse order
88 -.
89 .SH "EXAMPLES"
90 \fBglsa\-check \-t all\fR Test the system against all GLSAs in the GLSA repository\.
91 -.
92 -.P
93 +.TP
94 \fBglsa\-check \-t 201801\-01\fR Test the system against the specific GLSA 201801\-01\.
95 -.
96 .SH "EXIT VALUES"
97 +.TP
98 \fB0\fR Success
99 -.
100 -.P
101 +.TP
102 \fB1\fR Syntax or usage error
103 -.
104 -.P
105 +.TP
106 \fB2\fR Missing permissions, solution, etc
107 -.
108 -.P
109 +.TP
110 \fB6\fR System is affected by some GLSAs
111 -.
112 .SH "FILES"
113 \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\.
114 -.
115 .SH "BUGS"
116 All bugs should be reported to the Portage team via https://bugs\.gentoo\.org