bugzilla.1


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

.TH bugzilla 1  "March 25, 2008" "version 0.4" "User Commands"
.SH NAME
bugzilla \- command-line interface to Bugzilla over XML-RPC
.SH SYNOPSIS
.B bugzilla
[\fIoptions\fR] [\fIcommand\fR] [\fIcommand-options\fR]
.SH DESCRIPTION
.PP
.BR bugzilla
is a command-line utility that allows access to the XML-RPC interface provided
by Bugzilla. 
.PP
\fIcommand\fP is one of:
.br
.I \fR * login - log into the given bugzilla instance
.br
.I \fR * new - create a new bug
.br
.I \fR * query - search for bugs matching given criteria
.br
.I \fR * modify - modify existing bugs
.br
.I \fR * info - get info about the given bugzilla instance
.SH "OPTIONS"
These options apply to all commands. They must come before the command name.
.PP
.IP "\fB\-h\fR, \fB\-\-help\fP"
Displays a help message and then quits. If given after the command,
this will give command-specific help.
.IP "\fB\-\-bugzilla\fP=\fIURL\fP"
URL for the XML-RPC interface provided by the bugzilla instance. Typically
something like https://bugzilla.redhat.com/xmlrpc.cgi.
.IP "\fB\-\-user\fP=\fIUSER\fP"
Bugzilla username. If \fIuser\fP and \fIpassword\fP are not specified, 
.BR bugzilla
will try to use cookie authentication instead.
.IP "\fB\-\-password\fP=\fIPASSWORD\fP"
Bugzilla password. If \fIuser\fP and \fIpassword\fP are not specified,
.BR bugzilla
will try to use cookie authentication instead.
.IP "\fB\-\-cookiefile\fP=\fICOOKIEFILE\fP"
Cookie file to use for bugzilla authentication. Default:
.I ~/.bugzillacookies
.IP "\fB\-\-verbose\fP"
Give some extra information about what's going on.
.IP "\fB\-\-debug\fP"
Give lots of noisy debugging info about every step of the process.
.PP
These options apply to the \fIinfo\fP command.
.IP "\fB\-h\fR, \fB\-\-help\fP"
Show usage information for the \fIinfo\fP command.
.IP "\fB\-p\fR, \fB\-\-products\fP"
Show a list of products.
.IP "\fB\-c\fR, \fB\-\-components\fP=\fIPRODUCT\fP"
List the components in the given product.
.IP "\fB\-o\fR, \fB\-\-component_owners\fP=\fIPRODUCT\fP"
List components and their owners.
.IP "\fB\-v\fR, \fB\-\-versions\fP=\fIPRODUCT\fP"
List the versions for the given product.
.SH EXAMPLES
.TP
bugzilla query --bug_id 62037
.SH EXIT STATUS
.BR bugzilla
currently returns 0 for all operations. Sorry about that.
.SH NOTES
Not everything that's exposed in the Web UI is exposed by XML-RPC, and not
everything that's exposed by XML-RPC is used by
.BR bugzilla .
Furthermore, this documentation is woefully incomplete.
.SH BUGS
Bugs? In a sub-1.0 release? Preposterous.
.SH AUTHOR
Will Woods <wwoods@redhat.com>