Gentoo Archives: gentoo-portage-dev

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