Linux Certif

Toute la documentation sur la certification Linux LPI

bugzilla

NAME

bugzilla - command-line interface to Bugzilla over XML-RPC

SYNOPSIS

bugzilla [options] [command] [command-options]

DESCRIPTION

bugzilla is a command-line utility that allows access to the XML-RPC interface provided by Bugzilla.

command is one of:
* login - log into the given bugzilla instance
* new - create a new bug
* query - search for bugs matching given criteria
* modify - modify existing bugs
* info - get info about the given bugzilla instance

GLOBAL OPTIONS

--help, -h

show this help message and exit

--bugzilla=BUGZILLA

bugzilla XMLRPC URI. default: https://bugzilla.redhat.com/xmlrpc.cgi

--bztype=BZTYPE

Bugzilla type. Autodetected if not set. Available types: Bugzilla3 Bugzilla32 Bugzilla34 Bugzilla36 RHBugzilla3 NovellBugzilla

--user=USER

username

--password=PASSWORD

password

--cookiefile=COOKIEFILE

cookie file to use for bugzilla authentication

--verbose

give more info about what's going on

--debug

output bunches of debugging info

[oq]INFO[cq] OPTIONS

--help, -h

show this help message and exit

--products, -p

Get a list of products

--components=PRODUCT, -c PRODUCT

List the components in the given product

--component_owners=PRODUCT, -o PRODUCT

List components (and their owners)

--versions=PRODUCT, -v PRODUCT

List the versions for the given product

[oq]QUERY[cq] OPTIONS

--help, -h

show this help message and exit

--bug_id=BUG_ID, -b BUG_ID

specify individual bugs by IDs, separated with commas

--product=PRODUCT, -p PRODUCT

product name, comma-separated (list with 'bugzilla info -p')

--version=VERSION, -v VERSION

product version

--component=COMPONENT, -c COMPONENT

component name(s), comma-separated (list with 'bugzilla info -c PRODUCT')

--components_file=COMPONENTS_FILE

list of component names from a file, one component per line (list with 'bugzilla info -c PRODUCT')

--long_desc=LONG_DESC, -l LONG_DESC

search inside bug comments

--target_milestone=TARGET_MILESTONE, -m TARGET_MILESTONE

search for a target milestone

--short_desc=SHORT_DESC, -s SHORT_DESC

search bug summaries

--bug_status=BUG_STATUS, -t BUG_STATUS

comma-separated list of bug statuses to accept [Default:all] [Available:NEW,ASSIGNED,NEEDINFO,ON_DEV,MODIFIED,POST,ON_QA,FAILS_QA,PASSES_QA,REOPENED,VERIFIED,RELEASE_PENDING,CLOSED]

--severity=SEVERITY, -x SEVERITY

search severities, comma-separated

--priority=PRIORITY, -z PRIORITY

search priorities, comma-separated

--emailtype=EMAILTYPE, -E EMAILTYPE

Email: specify searching option for emails, ie. substring,notsubstring,exact,... [Default: substring]

--cc=CC, -o CC

Email: search cc lists for given address

--reporter=REPORTER, -r REPORTER

Email: search reporter email for given address

--assigned_to=ASSIGNED_TO, -a ASSIGNED_TO

Email: search for bugs assigned to this address

--qa_contact=QA_CONTACT, -q QA_CONTACT

Email: search for bugs which have QA Contact assigned to this address

--url=URL, -u URL

search keywords field for given url

--url_type=URL_TYPE, -U URL_TYPE

specify searching option for urls, ie. anywords,allwords,nowords

--keywords=KEYWORDS, -k KEYWORDS

search keywords field for specified words

--keywords_type=KEYWORDS_TYPE, -K KEYWORDS_TYPE

specify searching option for keywords, ie. anywords,allwords,nowords

--status_whiteboard=STATUS_WHITEBOARD, -w STATUS_WHITEBOARD

search Status Whiteboard field for specified words

--status_whiteboard_type=STATUS_WHITEBOARD_TYPE, -W STATUS_WHITEBOARD_TYPE

specify searching option for Status Whiteboard, ie. anywords,allwords,nowords

--booleantype=BOOLEANTYPE, -B BOOLEANTYPE

specify searching option for booleans, ie. substring,notsubstring,exact,... [Default: substring]

--boolean_query=BOOLEAN_QUERY

Boolean:Create your own query. Format: BooleanName-Condition-Parameter &/| ... . ie, keywords-substring-Partner & keywords-notsubstring-OtherQA

--blocked=BLOCKED

Boolean:search for bugs that block this bug ID

--dependson=DEPENDSON

Boolean:search for bugs that depend on this bug ID

--flag=FLAG

Boolean:search for bugs that have certain flag states present

--qa_whiteboard=QA_WHITEBOARD

Boolean:search for bugs that have certain QA Whiteboard text present

--devel_whiteboard=DEVEL_WHITEBOARD

Boolean:search for bugs that have certain Devel Whiteboard text present

--alias=ALIAS

Boolean:search for bugs that have the provided alias

--fixed_in=FIXED_IN

search Status Whiteboard field for specified words

--from-url=FROM_URL

Use the query given by a query.cgi URL. (Use quotes!)

--full, -f

output detailed bug info

--ids, -i

output only bug IDs

--extra, -e

output additional bug information (keywords, Whiteboards, etc.)

--oneline

one line summary of the bug (useful for scripts)

--raw

raw output of the bugzilla contents

--outputformat=OUTPUTFORMAT

Print output in the form given. You can use RPM-style tags that match bug fields, e.g.: '%{bug_id}: %{short_desc}'

[oq]NEW[cq] OPTIONS

--help, -h

show this help message and exit

--product=PRODUCT, -p PRODUCT

REQUIRED: product name (list with 'bugzilla info -p')

--version=VERSION, -v VERSION

REQUIRED: product version

--component=COMPONENT, -c COMPONENT

REQUIRED: component name (list with 'bugzilla info -c PRODUCT')

--comment=COMMENT, -l COMMENT

REQUIRED: initial bug comment

--summary=SHORT_DESC, -s SHORT_DESC

REQUIRED: bug summary

--os=OP_SYS, -o OP_SYS

OPTIONAL: operating system (default: Linux)

--arch=REP_PLATFORM, -a REP_PLATFORM

OPTIONAL: arch this bug occurs on (default: All)

--severity=BUG_SEVERITY

OPTIONAL: bug severity (default: medium)

--priority=PRIORITY

OPTIONAL: bug priority (default: medium)

--url=BUG_FILE_LOC, -u BUG_FILE_LOC

OPTIONAL: URL for further bug info

--cc=CC

OPTIONAL: add emails to initial CC list

--full, -f

output detailed bug info

--ids, -i

output only bug IDs

--extra, -e

output additional bug information (keywords, Whiteboards, etc.)

--oneline

one line summary of the bug (useful for scripts)

--raw

raw output of the bugzilla contents

--outputformat=OUTPUTFORMAT

Print output in the form given. You can use RPM-style tags that match bug fields, e.g.: '%{bug_id}: %{short_desc}'

[oq]MODIFY[cq] OPTIONS

--help, -h

show this help message and exit

--comment=COMMENT, -l COMMENT

Add a comment

--close=RESOLUTION, -k RESOLUTION

Close with the given resolution

--private, -p

Mark as private

--status=STATUS, -s STATUS

Change status of bug

--assignee=ASSIGNEE

Assign bugzilla to assignee

--flag=FLAG, -f FLAG

Update bugzilla flags with requested type, ie fedora-cvs? (Use a new option for each flag)

--cc=CC

Add an email to the cc list

--fixed_in=VERSION, -F VERSION

"Fixed in version" field

[oq]LOGIN[cq] OPTIONS

--help, -h

show this help message and exit

EXAMPLES

bugzilla query --bug_id 62037

EXIT STATUS

bugzilla normally returns 0 if the requested command was successful. Otherwise, exit status is 1 if bugzilla is interrupted by the user (or a login attempt fails), 2 if a socket error occurs (e.g. TCP connection timeout), and 3 if the server returns an XML-RPC fault.

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 bugzilla.

BUGS

Bugs? In a sub-1.0 release? Preposterous.

AUTHOR

Will Woods <wwoods@redhat.com>