1RC-ALERT(1) General Commands Manual RC-ALERT(1)
2
6 rc-alert - check for installed packages with release-critical bugs
7
9 rc-alert [inclusion options] [--debtags [tag[,tag ...]]] [--popcon]
10 [package ...]
11 rc-alert --help|--version
12
14 rc-alert downloads the list of release-critical bugs from the Debian
15 BTS webpages, and then outputs a list of packages installed on the sys‐
16 tem, or given on the command-line, which are in that list.
17 If the directory $XDG_CACHE_HOME/devscripts/rc-alert exists or the
19 --cache option is given, then the (sizable) downloaded list will be
20 cached, and will only be downloaded again on a second invocation if it
21 has changed.
22
24 --cache
25 Force the creation of the $XDG_CACHE_HOME/devscripts/rc-alert
26 cache directory.
27 --help, -h
29 Show a summary of options.
30 --version, -v
32 Show version and copyright information.
33 It is also possible to filter the list of bugs reported based on the
35 tags and distributions associated with the package. The filtering
36 options are:
37 --include-tags, -f
39 A list of tags which the bug must have, in the format used for
40 output. For example, to include bugs tagged security or help
41 wanted, use "SH".
42 --include-tag-op, -t
44 If set to and, a bug must have all of the tags specified by
45 --include-tags.
46 --exclude-tags
48 A list of tags which the bug must not have, in the same format
49 as --include-tags.
50 --exclude-tag-op
52 If set to and, a bug must have none of the tags specified by
53 --exclude-tags. By default, the bug will be excluded if any tag
54 matches.
55 --include-dists, -d
57 A list of distributions which the bug must apply to, in the for‐
58 mat used for output. For example, to include bugs affecting
59 testing or unstable, use "TU".
60 --include-dist-op, -o
62 If set to and, a bug must apply to all of the specified distri‐
63 butions in order to be included.
64 --exclude-dists
66 A list of distributions to which the bug must not apply, in the
67 same format as --include-dists.
68 --exclude-dist-op
70 If set to and, a bug must apply to all of the specified distri‐
71 butions in order to be excluded. By default the bug will be
72 excluded if it applies to any of the listed distributions.
73 It is also possible to only list bugs which have specific debtags set.
75 Note that you need to have debtags installed and also that it's not
76 mandatory for maintainers to set proper debtags. The produced list will
77 thus probably be incomplete.
78 --debtags
80 Match packages based on the listed tags. Each package is matched
81 only if it has all the listed tags; in the case of multiple tags
82 within the same facet, a package is matched if it has any of the
83 listed tags within the facet.
84 --debtags-database
86 Use a non-standard debtags database. The default is
87 /var/lib/debtags/packages-tags.
88 Popularity-contest collects data about installation and usage of Debian
90 packages. You can additionally sort the bugs by the popcon rank of the
91 related packages.
92 --popcon
94 Sort bugs by the popcon rank of the package the bug belongs to.
95 --pc-vote
97 By default, packages are sorted according to the number of peo‐
98 ple who have the package installed. This option enables sorting
99 by the number of people regularly using the package instead.
100 This option has no effect in combination with --pc-local.
101 --pc-local
103 Instead of requesting remote data the information from the last
104 popcon run is used (/var/log/popularity-contest).
105
107 --include-dists OS
108 The bug must apply to at least one of oldstable or stable
109 --include-dists TU --include-dist-op and
111 The bug must apply to both testing and unstable
112 --include-dists O --include-tags S --exclude-tags +
114 The bug must apply to oldstable and be tagged security but not
115 patch
116 --exclude-dists SOT --include-tags R
118 The bug must apply to only unstable or experimental (or both)
119 and be tagged unreproducible
120 --debtags implemented-in::perl,role::plugin,implemented-in::python
122 The bug must apply to packages matching the specified debtags,
123 i.e. the match will only include packages that have the
124 'role::plugin' tag and that have either of the tags 'imple‐
125 mented-in::perl' or 'implemented-in::python'.
126 --popcon --pc-local
128 Read /var/log/popularity-contest and sort bugs by your personal
129 popcon ranking (which is basically the atime of your packages'
130 binaries).
131
133 It is not possible to say "does not apply only to unstable"
134
136 debtags(1) popbugs(1) popularity-contest(8)
137
139 rc-alert was written by Anthony DeRobertis and modified by Julian
140 Gilbey <jdg@debian.org> and Adam D. Barratt <adam@adam-barratt.org.uk>
141 for the devscripts package. Debtags and popcon functionality was added
142 by Jan Hauke Rahm <info@jhr-online.de>.
143DEBIAN Debian Utilities RC-ALERT(1)