bugzilla-submit
1
Oct 30, 2003
bugzilla-submit
post bugs to a Bugzilla instance
bugzilla-submit
--status bug_status
--url bug_file_loc
--product product
--version version
--component component
--summary short_desc
--hardware rep_platform
--os op_sys
--priority priority
--severity bug_severity
--assigned-to assigned-to
--cc cc
--keywords keywords
--depends-on dependson
--blocked blocked
--description comment
--no-read
bugzilla-url
DESCRIPTION
bugzilla-submit is a command-line tool
for posting bug reports to any instance of Bugzilla. It accepts on
standard input text resembling an RFC-822 message. The headers of
that message, and its body, are used to set error-report field values.
More field values are merged in from command-line options. If required
fields have not been set, bugzilla-submit
tries to compute them. Finally, the resulting error report is
validated. If all required fields are present, and there are no
illegal fields or values, the report is shipped off to the Mozilla
instance specified by the single positional argument. Login/password
credentials are read from the calling user's ~/.netrc
file.
The program accepts the following options to set or override fields:
-b. --bug-status
Set the bug_status field, overriding the Status header from
standard input if present. (The stock Bugzilla web presentation
identifies this field as Status
.)
-u, --url
Set the bug_file_loc field, overriding the URL header from
standard input if present. (The stock Bugzilla web presentation
identifies this field as URL
.)
-p, --product
Set the product field, overriding the Product header from
standard input if necessary.
-v, --version
Set the version field, overriding the Version header
from standard input if necessary.
-c, --component
Set the component field, overriding the Component header
from standard input if necessary.
-s, --summary
Set the short_desc field, overriding the Summary header
from standard input if necessary. (The stock Bugzilla web presentation
identifies this field as Summary
.)
-H, --hardware
Set the rep_platform field, overriding the Hardware header
from standard input if necessary. (The stock Bugzilla web presentation
identifies this field as Hardware
.)
-o, --os
Set the op_sys field, overriding the Operating-System header
from standard input if necessary. (The stock Bugzilla web presentation
identifies this field as OS
.)
-r, --priority
Set the priority field, overriding the Priority header
from standard input if necessary.
-x, --severity
Set the severity field, overriding the Severity header
from standard input if necessary.
-d, --description
Set the comment field, overriding the Description header
from standard input if necessary. (The stock Bugzilla web presentation
identifies this field as Description
.) If there is a
message body and no Description field and this option is not
specified, the message body is used as a description.
-a, --assigned-to
Set the optional assigned_to field, overriding the Assigned-To
header from standard input if necessary.
-C, --cc
Set the optional cc field, overriding the Cc
header from standard input if necessary.
-k, --keywords
Set the optional keywords field, overriding the Keywords
header from standard input if necessary.
-D, --depends-on
Set the optional dependson field, overriding the Depends-On
header from standard input if necessary.
-B, --assigned-to
Set the optional blocked field, overriding the Blocked
header from standard input if necessary.
-n, --no-stdin
Suppress reading fields from standard input.
-h, --help
Print usage help and exit.
This program will try to deduce OS and Hardware if those are not
specified. If it fails, validation will fail before shipping the
report.
There is expected to be a single positional argument following
any options. It should be the URL of the Bugzilla instance to which
the bug is to be submitted.
FILES
~/.netrc
Must contain an entry in which the machine field is
the Bugzilla instance URL, the login field is your ID on that host, and the
password field is the right password. The URL in the machine field
must be enclosed in double quotes.
AUTHORS
Christian Reis <kiko@async.com.br>, Eric S. Raymond
<esr@thyrsus.com>.