1bugzilla(1) User Commands bugzilla(1)
2
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 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 --bugzilla=BUGZILLA
27 bugzilla XMLRPC URI. default: https://bugzilla.redhat.com/xml‐
28 rpc.cgi
29 --bztype=BZTYPE
31 Bugzilla type. Autodetected if not set. Available types:
32 Bugzilla3 Bugzilla32 Bugzilla34 Bugzilla36 RHBugzilla3 Novell‐
33 Bugzilla
34 --user=USER
36 username
37 --password=PASSWORD
39 password
40 --cookiefile=COOKIEFILE
42 cookie file to use for bugzilla authentication
43 --verbose
45 give more info about what's going on
46 --debug
48 output bunches of debugging info
49
51 --help, -h
52 show this help message and exit
53 --products, -p
55 Get a list of products
56 --components=PRODUCT, -c PRODUCT
58 List the components in the given product
59 --component_owners=PRODUCT, -o PRODUCT
61 List components (and their owners)
62 --versions=PRODUCT, -v PRODUCT
64 List the versions for the given product
65
67 --help, -h
68 show this help message and exit
69 --bug_id=BUG_ID, -b BUG_ID
71 specify individual bugs by IDs, separated with commas
72 --product=PRODUCT, -p PRODUCT
74 product name, comma-separated (list with 'bugzilla info -p')
75 --version=VERSION, -v VERSION
77 product version
78 --component=COMPONENT, -c COMPONENT
80 component name(s), comma-separated (list with 'bugzilla info -c
81 PRODUCT')
82 --components_file=COMPONENTS_FILE
84 list of component names from a file, one component per line
85 (list with 'bugzilla info -c PRODUCT')
86 --long_desc=LONG_DESC, -l LONG_DESC
88 search inside bug comments
89 --target_milestone=TARGET_MILESTONE, -m TARGET_MILESTONE
91 search for a target milestone
92 --short_desc=SHORT_DESC, -s SHORT_DESC
94 search bug summaries
95 --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 --severity=SEVERITY, -x SEVERITY
103 search severities, comma-separated
104 --priority=PRIORITY, -z PRIORITY
106 search priorities, comma-separated
107 --emailtype=EMAILTYPE, -E EMAILTYPE
109 Email: specify searching option for emails, ie. substring,not‐
110 substring,exact,... [Default: substring]
111 --cc=CC, -o CC
113 Email: search cc lists for given address
114 --reporter=REPORTER, -r REPORTER
116 Email: search reporter email for given address
117 --assigned_to=ASSIGNED_TO, -a ASSIGNED_TO
119 Email: search for bugs assigned to this address
120 --qa_contact=QA_CONTACT, -q QA_CONTACT
122 Email: search for bugs which have QA Contact assigned to this
123 address
124 --url=URL, -u URL
126 search keywords field for given url
127 --url_type=URL_TYPE, -U URL_TYPE
129 specify searching option for urls, ie. anywords,allwords,nowords
130 --keywords=KEYWORDS, -k KEYWORDS
132 search keywords field for specified words
133 --keywords_type=KEYWORDS_TYPE, -K KEYWORDS_TYPE
135 specify searching option for keywords, ie. anywords,all‐
136 words,nowords
137 --status_whiteboard=STATUS_WHITEBOARD, -w STATUS_WHITEBOARD
139 search Status Whiteboard field for specified words
140 --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 --booleantype=BOOLEANTYPE, -B BOOLEANTYPE
147 specify searching option for booleans, ie. substring,notsub‐
148 string,exact,... [Default: substring]
149 --boolean_query=BOOLEAN_QUERY
151 Boolean:Create your own query. Format: BooleanName-Condition-
152 Parameter &/| ... . ie, keywords-substring-Partner & keywords-
153 notsubstring-OtherQA
154 --blocked=BLOCKED
156 Boolean:search for bugs that block this bug ID
157 --dependson=DEPENDSON
159 Boolean:search for bugs that depend on this bug ID
160 --flag=FLAG
162 Boolean:search for bugs that have certain flag states present
163 --qa_whiteboard=QA_WHITEBOARD
165 Boolean:search for bugs that have certain QA Whiteboard text
166 present
167 --devel_whiteboard=DEVEL_WHITEBOARD
169 Boolean:search for bugs that have certain Devel Whiteboard text
170 present
171 --alias=ALIAS
173 Boolean:search for bugs that have the provided alias
174 --fixed_in=FIXED_IN
176 search Status Whiteboard field for specified words
177 --from-url=FROM_URL
179 Use the query given by a query.cgi URL. (Use quotes!)
180 --full, -f
182 output detailed bug info
183 --ids, -i
185 output only bug IDs
186 --extra, -e
188 output additional bug information (keywords, Whiteboards, etc.)
189 --oneline
191 one line summary of the bug (useful for scripts)
192 --raw raw output of the bugzilla contents
194 --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 --product=PRODUCT, -p PRODUCT
204 REQUIRED: product name (list with 'bugzilla info -p')
205 --version=VERSION, -v VERSION
207 REQUIRED: product version
208 --component=COMPONENT, -c COMPONENT
210 REQUIRED: component name (list with 'bugzilla info -c PRODUCT')
211 --comment=COMMENT, -l COMMENT
213 REQUIRED: initial bug comment
214 --summary=SHORT_DESC, -s SHORT_DESC
216 REQUIRED: bug summary
217 --os=OP_SYS, -o OP_SYS
219 OPTIONAL: operating system (default: Linux)
220 --arch=REP_PLATFORM, -a REP_PLATFORM
222 OPTIONAL: arch this bug occurs on (default: All)
223 --severity=BUG_SEVERITY
225 OPTIONAL: bug severity (default: medium)
226 --priority=PRIORITY
228 OPTIONAL: bug priority (default: medium)
229 --url=BUG_FILE_LOC, -u BUG_FILE_LOC
231 OPTIONAL: URL for further bug info
232 --cc=CC
234 OPTIONAL: add emails to initial CC list
235 --full, -f
237 output detailed bug info
238 --ids, -i
240 output only bug IDs
241 --extra, -e
243 output additional bug information (keywords, Whiteboards, etc.)
244 --oneline
246 one line summary of the bug (useful for scripts)
247 --raw raw output of the bugzilla contents
249 --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 --comment=COMMENT, -l COMMENT
259 Add a comment
260 --close=RESOLUTION, -k RESOLUTION
262 Close with the given resolution
263 --private, -p
265 Mark as private
266 --status=STATUS, -s STATUS
268 Change status of bug
269 --assignee=ASSIGNEE
271 Assign bugzilla to assignee
272 --flag=FLAG, -f FLAG
274 Update bugzilla flags with requested type, ie fedora-cvs? (Use a
275 new option for each flag)
276 --cc=CC
278 Add an email to the cc list
279 --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>
305version 0.6.1 April 16, 2010 bugzilla(1)