dependencies: avoid Package-is-not-iterable in graph_reverse_depends doctest
[gentoolkit.git] / man / glsa-check.1
1 .TH "glsa-check" "1" "0.3" "Marius Mauch" "gentoolkit"
2 .SH "NAME"
3 .LP 
4 glsa\-check \- Gentoo: Tool to locally monitor and manage GLSAs
5 .SH "SYNTAX"
6 .LP 
7 glsa\-check <\fIoption\fP> [\fIglsa\-list\fP]
8
9 [\fIglsa\-list\fR] can contain an arbitrary number of GLSA ids, filenames containing GLSAs or the special identifiers 'all' and 'affected'
10 .SH "DESCRIPTION"
11 .LP 
12 This tool is used to locally monitor and manage Gentoo Linux Security Advisories.
13 Please read:
14 .br 
15 http://www.gentoo.org/security
16 .br 
17 before reporting a bug.
18 .LP 
19 Note: In order for this tool to be effective, you must regularly sync your local portage tree.
20 .SH "OPTIONS"
21 .LP 
22 .TP 
23 .B \-l, \-\-list
24 list the a summary for all GLSAs in glsa\-list and whether they affect the system
25 .TP 
26 .B \-d, \-\-dump, \-\-print
27 show all information about the GLSAs in glsa\-list
28 .TP 
29 .B \-t, \-\-test
30 test if this system is affected by the GLSAs in glsa\-list and output the GLSA IDs
31 .TP 
32 .B \-p, \-\-pretend
33 show the necessary steps to apply the GLSAs in glsa\-list
34 .TP 
35 .B \-f, \-\-fix
36 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)
37 .TP 
38 .B \-i, \-\-inject
39 inject the given GLSA into the glsa_injected file
40 .TP 
41 .B \-n, \-\-nocolor
42 disable colors (option)
43 .TP 
44 .B \-h, \-\-help
45 show this help message
46 .TP 
47 .B \-V, \-\-version
48 some information about this tool
49 .TP 
50 .B \-v, \-\-verbose
51 print more messages (option)
52 .TP 
53 .B \-c, \-\-cve
54 show CVE ids in listing mode (option)
55 .TP 
56 .B \-q, \-\-quiet
57 be less verbose and do not send empty mail (option)
58 .TP 
59 .B \-m, \-\-mail
60 send a mail with the given GLSAs to the administrator
61 .SH "FILES"
62 .LP 
63 .TP 
64 .B /var/lib/portage/glsa_injected
65 List of GLSA ids that have been injected and will never show up as 'affected' on this system.
66 The file must contain one GLSA id (e.g. '200804\-02') per line.