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: Mon, 19 Aug 2019 04:51:33
Message-Id: 1566187794.cd5e6d8d4e84bc042c041f75e428410d6cdb5475.zmedico@gentoo
1 commit: cd5e6d8d4e84bc042c041f75e428410d6cdb5475
2 Author: Zac Medico <zmedico <AT> gentoo <DOT> org>
3 AuthorDate: Tue Aug 13 01:02:55 2019 +0000
4 Commit: Zac Medico <zmedico <AT> gentoo <DOT> org>
5 CommitDate: Mon Aug 19 04:09:54 2019 +0000
6 URL: https://gitweb.gentoo.org/proj/portage.git/commit/?id=cd5e6d8d
7
8 glsa-check: install in /usr/bin (bug 463952)
9
10 In order to eliminate the duplicate implementation from gentoolkit,
11 install glsa-check into /usr/bin and add man page from gentoolkit.
12
13 Bug: https://bugs.gentoo.org/463952
14 Signed-off-by: Zac Medico <zmedico <AT> gentoo.org>
15
16 man/glsa-check.1 | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
17 setup.py | 2 +-
18 2 files changed, 67 insertions(+), 1 deletion(-)
19
20 diff --git a/man/glsa-check.1 b/man/glsa-check.1
21 new file mode 100644
22 index 000000000..67527230c
23 --- /dev/null
24 +++ b/man/glsa-check.1
25 @@ -0,0 +1,66 @@
26 +.TH "GLSA-CHECK" "1" "Aug 2019" "Portage VERSION" "Portage"
27 +.SH "NAME"
28 +.LP
29 +glsa\-check \- Gentoo: Tool to locally monitor and manage GLSAs
30 +.SH "SYNTAX"
31 +.LP
32 +glsa\-check <\fIoption\fP> [\fIglsa\-list\fP]
33 +
34 +[\fIglsa\-list\fR] can contain an arbitrary number of GLSA ids, filenames containing GLSAs or the special identifiers 'all' and 'affected'
35 +.SH "DESCRIPTION"
36 +.LP
37 +This tool is used to locally monitor and manage Gentoo Linux Security Advisories.
38 +Please read:
39 +.br
40 +http://www.gentoo.org/security
41 +.br
42 +before reporting a bug.
43 +.LP
44 +Note: In order for this tool to be effective, you must regularly sync your local portage tree.
45 +.SH "OPTIONS"
46 +.LP
47 +.TP
48 +.B \-l, \-\-list
49 +list the a summary for all GLSAs in glsa\-list and whether they affect the system
50 +.TP
51 +.B \-d, \-\-dump, \-\-print
52 +show all information about the GLSAs in glsa\-list
53 +.TP
54 +.B \-t, \-\-test
55 +test if this system is affected by the GLSAs in glsa\-list and output the GLSA IDs
56 +.TP
57 +.B \-p, \-\-pretend
58 +show the necessary steps to apply the GLSAs in glsa\-list
59 +.TP
60 +.B \-f, \-\-fix
61 +try to auto\-apply the GLSAs in in glsa\-list using emerge. This will only upgrade packages to later version, but not remove packages when no upgrade path exists (experimental)
62 +.TP
63 +.B \-i, \-\-inject
64 +inject the given GLSA into the glsa_injected file
65 +.TP
66 +.B \-n, \-\-nocolor
67 +disable colors (option)
68 +.TP
69 +.B \-h, \-\-help
70 +show this help message
71 +.TP
72 +.B \-V, \-\-version
73 +some information about this tool
74 +.TP
75 +.B \-v, \-\-verbose
76 +print more messages (option)
77 +.TP
78 +.B \-c, \-\-cve
79 +show CVE ids in listing mode (option)
80 +.TP
81 +.B \-q, \-\-quiet
82 +be less verbose and do not send empty mail (option)
83 +.TP
84 +.B \-m, \-\-mail
85 +send a mail with the given GLSAs to the administrator
86 +.SH "FILES"
87 +.LP
88 +.TP
89 +.B /var/lib/portage/glsa_injected
90 +List of GLSA ids that have been injected and will never show up as 'affected' on this system.
91 +The file must contain one GLSA id (e.g. '200804\-02') per line.
92
93 diff --git a/setup.py b/setup.py
94 index 156537a31..c71deb97f 100755
95 --- a/setup.py
96 +++ b/setup.py
97 @@ -38,7 +38,7 @@ import sys
98 x_scripts = {
99 'bin': [
100 'bin/ebuild', 'bin/egencache', 'bin/emerge', 'bin/emerge-webrsync',
101 - 'bin/emirrordist', 'bin/portageq', 'bin/quickpkg',
102 + 'bin/emirrordist', 'bin/glsa-check', 'bin/portageq', 'bin/quickpkg',
103 ],
104 'sbin': [
105 'bin/archive-conf', 'bin/dispatch-conf', 'bin/emaint', 'bin/env-update',