1REPORTER-BUGZILLA(1) LIBREPORT MANUAL REPORTER-BUGZILLA(1)
2
6 reporter-bugzilla - Reports problem to Bugzilla.
7
9 reporter-bugzilla [-vbf] [-g GROUP]... [-c CONFFILE]... [-F FMTFILE]
10 [-A FMTFILE2] -d DIR
11 Or:
13 reporter-bugzilla [-v] [-c CONFFILE]... [-d DIR] -t[ID] FILE...
15 Or:
17 reporter-bugzilla [-v] [-c CONFFILE]... [-d DIR] -t[ID] -w
19 Or:
21 reporter-bugzilla [-v] [-c CONFFILE]... -h DUPHASH [-p[PRODUCT]]
23
25 The tool reads problem directory DIR. Then it logs in to Bugzilla and
26 tries to find a bug with the same abrt_hash:HEXSTRING in Whiteboard.
27 If such bug is not found, then a new bug is created. Elements of DIR
29 are stored in the bug as part of bug description or as attachments,
30 depending on their type and size.
31 Otherwise, if such bug is found and it is marked as CLOSED DUPLICATE,
33 the tool follows the chain of duplicates until it finds a non-DUPLICATE
34 bug. The tool adds a new comment to found bug.
35 The URL to new or modified bug is printed to stdout and recorded in
37 reported_to element in DIR.
38 Option -t uploads FILEs to the already created bug on Bugzilla site.
40 The bug ID is retrieved from directory specified by -d DIR. If problem
41 data in DIR was never reported to Bugzilla, upload will fail.
42 Option -tID uploads FILEs to the bug with specified ID on Bugzilla
44 site. -d DIR is ignored.
45 Option -w adds bugzilla user to bug’s CC list.
47 Option -r sets the last url from reporter_to element which is prefixed
49 with TRACKER_NAME to URL field. This option is applied only when a new
50 bug is to be filed. The default value is ABRT Server"
51 Configuration file
53 If not specified, CONFFILE defaults to
54 /etc/libreport/plugins/bugzilla.conf and to user’s local
55 ~/.config/libreport/bugzilla.conf. Configuration file lines should have
56 PARAM = VALUE format. The parameters are: User’s local configuration
57 overrides the system wide configuration.
58 Login
60 Login to Bugzilla account.
61 Password
63 Password to Bugzilla account.
64 BugzillaURL
66 Bugzilla HTTP(S) address. (default: https://bugzilla.redhat.com)
67 SSLVerify
69 Use yes/true/on/1 to verify server’s SSL certificate. (default:
70 yes)
71 Product
73 Product bug field value. Useful if you needed different product
74 than specified in /etc/os-release
75 ProductVersion
77 Version bug field value. Useful if you needed different product
78 version than specified in /etc/os-release
79 Parameters can be overridden via $Bugzilla_PARAM environment variables.
81 Formatting configuration files
83 Lines starting with # are ignored.
84 Lines can be continued on the next line using trailing backslash.
86 Format:
88 "%summary
90 summary format"
91 "section
93 element1[,element2]..." The literal text line to be added to
94 Bugzilla comment. Can be empty. (Empty lines are NOT ignored!)
95 Summary format is a line of text, where %element% is replaced by
97 text element's content, and [[...%element%...]] block is used only if
98 %element% exists. [[...]] blocks can nest.
99 Sections can be:
101 - %summary: bug summary format string.
102 - %attach: a list of elements to attach.
103 - text, double colon (::) and the list of comma-separated elements.
104 Elements can be:
106 - problem directory element names, which get formatted as
107 <element_name>: <contents>
108 or
109 <element_name>:
110 :<contents>
111 :<contents>
112 :<contents>
113 - problem directory element names prefixed by "%bare_",
114 which is formatted as-is, without "<element_name>:" and colons
115 - %oneline, %multiline, %text wildcards, which select all corresponding
116 elements for output or attachment
117 - %binary wildcard, valid only for %attach section, instructs to attach
118 binary elements
119 - problem directory element names prefixed by "-",
120 which excludes given element from all wildcards
121 Nonexistent elements are silently ignored.
123 If none of elements exists, the section will not be created.
124 Integration with ABRT events
126 reporter-bugzilla can be used as an ABRT reporter. Example fragment for
127 /etc/libreport/report_event.conf:
128 # Report Python crashes
130 EVENT=report_Bugzilla analyzer=Python
131 reporter-bugzilla -d . -c /etc/libreport/plugins/bugzilla.conf
132
134 -d DIR
135 Path to problem directory.
136 -c CONFFILE
138 Path to configuration file.
139 -b
141 When creating bug, attach binary files too.
142 -f
144 Force reporting even if this problem is already reported.
145 -F CONF_FORMAT_FILE
147 Formatting file for initial comment. Default:
148 /etc/libreport/plugins/bugzilla_format.conf
149 -A CONF_FORMAT_FILE
151 Formatting file for duplicates. Default:
152 /etc/libreport/plugins/bugzilla_format.conf
153 -t[ID]
155 Upload FILEs to the already created bug on Bugzilla site.
156 -w
158 Add bugzilla user to CC list [of bug with this ID]. Applicable only
159 with -t.
160 -h, --duphash DUPHASH
162 Search in Bugzilla by abrt’s DUPHASH and print BUG_ID.
163 -p[PRODUCT], --product[PRODUCT]
165 Specify a Bugzilla’s product (ignored without -h). Default:
166 "Fedora". If only -p or --product without PRODUCT is presented
167 either value from environment variable Bugzilla_Product in the
168 first place or REDHAT_BUGZILLA_PRODUCT value from /etc/os-release
169 is used.
170 -g, --group GROUP
172 When creating a new ticket restrict access to this group only.
173
175 Environment variables take precedence over values provided in the
176 configuration file.
177 Bugzilla_Login
179 Login to Bugzilla account.
180 Bugzilla_Password
182 Password to Bugzilla account.
183 Bugzilla_BugzillaURL
185 Bugzilla HTTP(S) address. (default: https://bugzilla.redhat.com)
186 Bugzilla_SSLVerify
188 Use yes/true/on/1 to verify server’s SSL certificate. (default:
189 yes)
190 Bugzilla_Product
192 Product bug field value. Useful if you needed different product
193 than specified in /etc/os-release
194 Bugzilla_ProductVersion
196 Version bug field value. Useful if you needed different product
197 version than specified in /etc/os-release
198 Bugzilla_PrivateGroups
200 List of Bugzilla group names that will be set to the new bug if
201 Bugzilla_CreatePrivate equals yes
202 Bugzilla_CreatePrivate
204 Use yes/no to control whether the new bug should have set groups
205 listed in Bugzilla_PrivateGroups
206 Bugzilla_DontMatchComponents
208 Comma-separated list of package components (e.g. selinux-policy,
209 anaconda) for which reporter-bugzilla should not use Bugzilla
210 component match when searching for duplicate bug reports.
211 http_proxy
213 the proxy server to use for HTTP
214 HTTPS_PROXY
216 the proxy server to use for HTTPS
217
219 /usr/share/libreport/conf.d/plugins/bugzilla.conf
220 Readonly default configuration files.
221 /etc/libreport/plugins/bugzilla.conf
223 Configuration file.
224 ~/.config/libreport/bugzilla.conf
226 User’s local configuration file.
227 /etc/libreport/plugins/bugzilla_format.conf
229 Configure formating for reporting.
230
232 report_event.conf(5), bugzilla_format.conf(5)
233
235 • ABRT team
236LIBREPORT 2.15.2 06/01/2021 REPORTER-BUGZILLA(1)