1bugzilla(1) User Commands bugzilla(1)
2
3
4
6 bugzilla - command-line interface to Bugzilla over XML-RPC
7
9 bugzilla [options] [command] [command-options]
10
12 bugzilla is a command-line utility that allows access to the XML-RPC
13 interface provided by Bugzilla.
14
15 command is one of:
16 * login - log into the given bugzilla instance
17 * new - create a new bug
18 * query - search for bugs matching given criteria
19 * modify - modify existing bugs
20 * info - get info about the given bugzilla instance
21
23 --help, -h
24 show this help message and exit
25
26 --bugzilla=BUGZILLA
27 bugzilla XMLRPC URI. default: https://bugzilla.redhat.com/xml‐
28 rpc.cgi
29
30 --bztype=BZTYPE
31 Bugzilla type. Autodetected if not set. Available types:
32 Bugzilla3 Bugzilla32 Bugzilla34 Bugzilla36 RHBugzilla3 Novell‐
33 Bugzilla
34
35 --user=USER
36 username
37
38 --password=PASSWORD
39 password
40
41 --cookiefile=COOKIEFILE
42 cookie file to use for bugzilla authentication
43
44 --verbose
45 give more info about what's going on
46
47 --debug
48 output bunches of debugging info
49
51 --help, -h
52 show this help message and exit
53
54 --products, -p
55 Get a list of products
56
57 --components=PRODUCT, -c PRODUCT
58 List the components in the given product
59
60 --component_owners=PRODUCT, -o PRODUCT
61 List components (and their owners)
62
63 --versions=PRODUCT, -v PRODUCT
64 List the versions for the given product
65
67 --help, -h
68 show this help message and exit
69
70 --bug_id=BUG_ID, -b BUG_ID
71 specify individual bugs by IDs, separated with commas
72
73 --product=PRODUCT, -p PRODUCT
74 product name, comma-separated (list with 'bugzilla info -p')
75
76 --version=VERSION, -v VERSION
77 product version
78
79 --component=COMPONENT, -c COMPONENT
80 component name(s), comma-separated (list with 'bugzilla info -c
81 PRODUCT')
82
83 --components_file=COMPONENTS_FILE
84 list of component names from a file, one component per line
85 (list with 'bugzilla info -c PRODUCT')
86
87 --long_desc=LONG_DESC, -l LONG_DESC
88 search inside bug comments
89
90 --target_milestone=TARGET_MILESTONE, -m TARGET_MILESTONE
91 search for a target milestone
92
93 --short_desc=SHORT_DESC, -s SHORT_DESC
94 search bug summaries
95
96 --bug_status=BUG_STATUS, -t BUG_STATUS
97 comma-separated list of bug statuses to accept [Default:all]
98 [Available:NEW,ASSIGNED,NEEDINFO,ON_DEV,MODI‐
99 FIED,POST,ON_QA,FAILS_QA,PASSES_QA,REOPENED,VERI‐
100 FIED,RELEASE_PENDING,CLOSED]
101
102 --severity=SEVERITY, -x SEVERITY
103 search severities, comma-separated
104
105 --priority=PRIORITY, -z PRIORITY
106 search priorities, comma-separated
107
108 --emailtype=EMAILTYPE, -E EMAILTYPE
109 Email: specify searching option for emails, ie. substring,not‐
110 substring,exact,... [Default: substring]
111
112 --cc=CC, -o CC
113 Email: search cc lists for given address
114
115 --reporter=REPORTER, -r REPORTER
116 Email: search reporter email for given address
117
118 --assigned_to=ASSIGNED_TO, -a ASSIGNED_TO
119 Email: search for bugs assigned to this address
120
121 --qa_contact=QA_CONTACT, -q QA_CONTACT
122 Email: search for bugs which have QA Contact assigned to this
123 address
124
125 --url=URL, -u URL
126 search keywords field for given url
127
128 --url_type=URL_TYPE, -U URL_TYPE
129 specify searching option for urls, ie. anywords,allwords,nowords
130
131 --keywords=KEYWORDS, -k KEYWORDS
132 search keywords field for specified words
133
134 --keywords_type=KEYWORDS_TYPE, -K KEYWORDS_TYPE
135 specify searching option for keywords, ie. anywords,all‐
136 words,nowords
137
138 --status_whiteboard=STATUS_WHITEBOARD, -w STATUS_WHITEBOARD
139 search Status Whiteboard field for specified words
140
141 --status_whiteboard_type=STATUS_WHITEBOARD_TYPE, -W STATUS_WHITE‐
142 BOARD_TYPE
143 specify searching option for Status Whiteboard, ie. any‐
144 words,allwords,nowords
145
146 --booleantype=BOOLEANTYPE, -B BOOLEANTYPE
147 specify searching option for booleans, ie. substring,notsub‐
148 string,exact,... [Default: substring]
149
150 --boolean_query=BOOLEAN_QUERY
151 Boolean:Create your own query. Format: BooleanName-Condition-
152 Parameter &/| ... . ie, keywords-substring-Partner & keywords-
153 notsubstring-OtherQA
154
155 --blocked=BLOCKED
156 Boolean:search for bugs that block this bug ID
157
158 --dependson=DEPENDSON
159 Boolean:search for bugs that depend on this bug ID
160
161 --flag=FLAG
162 Boolean:search for bugs that have certain flag states present
163
164 --qa_whiteboard=QA_WHITEBOARD
165 Boolean:search for bugs that have certain QA Whiteboard text
166 present
167
168 --devel_whiteboard=DEVEL_WHITEBOARD
169 Boolean:search for bugs that have certain Devel Whiteboard text
170 present
171
172 --alias=ALIAS
173 Boolean:search for bugs that have the provided alias
174
175 --fixed_in=FIXED_IN
176 search Status Whiteboard field for specified words
177
178 --from-url=FROM_URL
179 Use the query given by a query.cgi URL. (Use quotes!)
180
181 --full, -f
182 output detailed bug info
183
184 --ids, -i
185 output only bug IDs
186
187 --extra, -e
188 output additional bug information (keywords, Whiteboards, etc.)
189
190 --oneline
191 one line summary of the bug (useful for scripts)
192
193 --raw raw output of the bugzilla contents
194
195 --outputformat=OUTPUTFORMAT
196 Print output in the form given. You can use RPM-style tags that
197 match bug fields, e.g.: '%{bug_id}: %{short_desc}'
198
200 --help, -h
201 show this help message and exit
202
203 --product=PRODUCT, -p PRODUCT
204 REQUIRED: product name (list with 'bugzilla info -p')
205
206 --version=VERSION, -v VERSION
207 REQUIRED: product version
208
209 --component=COMPONENT, -c COMPONENT
210 REQUIRED: component name (list with 'bugzilla info -c PRODUCT')
211
212 --comment=COMMENT, -l COMMENT
213 REQUIRED: initial bug comment
214
215 --summary=SHORT_DESC, -s SHORT_DESC
216 REQUIRED: bug summary
217
218 --os=OP_SYS, -o OP_SYS
219 OPTIONAL: operating system (default: Linux)
220
221 --arch=REP_PLATFORM, -a REP_PLATFORM
222 OPTIONAL: arch this bug occurs on (default: All)
223
224 --severity=BUG_SEVERITY
225 OPTIONAL: bug severity (default: medium)
226
227 --priority=PRIORITY
228 OPTIONAL: bug priority (default: medium)
229
230 --url=BUG_FILE_LOC, -u BUG_FILE_LOC
231 OPTIONAL: URL for further bug info
232
233 --cc=CC
234 OPTIONAL: add emails to initial CC list
235
236 --full, -f
237 output detailed bug info
238
239 --ids, -i
240 output only bug IDs
241
242 --extra, -e
243 output additional bug information (keywords, Whiteboards, etc.)
244
245 --oneline
246 one line summary of the bug (useful for scripts)
247
248 --raw raw output of the bugzilla contents
249
250 --outputformat=OUTPUTFORMAT
251 Print output in the form given. You can use RPM-style tags that
252 match bug fields, e.g.: '%{bug_id}: %{short_desc}'
253
255 --help, -h
256 show this help message and exit
257
258 --comment=COMMENT, -l COMMENT
259 Add a comment
260
261 --close=RESOLUTION, -k RESOLUTION
262 Close with the given resolution
263
264 --private, -p
265 Mark as private
266
267 --status=STATUS, -s STATUS
268 Change status of bug
269
270 --assignee=ASSIGNEE
271 Assign bugzilla to assignee
272
273 --flag=FLAG, -f FLAG
274 Update bugzilla flags with requested type, ie fedora-cvs? (Use a
275 new option for each flag)
276
277 --cc=CC
278 Add an email to the cc list
279
280 --fixed_in=VERSION, -F VERSION
281 "Fixed in version" field
282
284 --help, -h
285 show this help message and exit
286
288 bugzilla query --bug_id 62037
289
291 bugzilla normally returns 0 if the requested command was successful.
292 Otherwise, exit status is 1 if bugzilla is interrupted by the user (or
293 a login attempt fails), 2 if a socket error occurs (e.g. TCP connection
294 timeout), and 3 if the server returns an XML-RPC fault.
295
297 Not everything that's exposed in the Web UI is exposed by XML-RPC, and
298 not everything that's exposed by XML-RPC is used by bugzilla.
299
301 Bugs? In a sub-1.0 release? Preposterous.
302
304 Will Woods <wwoods@redhat.com>
305
306
307
308version 0.6.1 April 16, 2010 bugzilla(1)