Chapter 5. Using plug-ins

5.1. Generic Plugin Actions

While each plug-in differs slightly in its actions and requirements, there are some actions that are common to all plug-ins:

The ability to add logs to existing Bugzilla tickets with the --bug-id=<BUG_ID> switch. As well as the Bugzilla ID of the bug, this option also requires a set of valid Bugzilla credentials to be passed to the client. These credentials can be entered manually (--username=<USERNAME> --password=<PASSWORD>) or stored in the configuration file.
The ability to create a new Bugzilla ticket and attach logs to it automatically with the --new-bug switch. Again, this action requires valid Bugzilla credentials. It also requires the --arch=<ARCH> and --rel-version=<REL_VERSION> parameters to be set, either manually or in the configuration file.
The ability to provide an http proxy if the client is being run behind a proxy server using the either the -y <HTTP_PROXY> or --http-proxy=<HTTP_PROXY> option.

A full print-out of these options is included below:

options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -y HTTP_PROXY, --http-proxy=HTTP_PROXY
                        http proxy

  Attach logs to bug id:
    --bug-id=BUG_ID     Bugzilla id

  Attach logs to new bug:
    --new-bug           Create new bug
    --arch=ARCH         Architecture ("i386" or "x86_64" or "i686")
    --rel-version=REL_VERSION
                        Release version

  Bugzilla information:
    --username=USERNAME
                        Bugzilla username
    --password=PASSWORD
                        Bugzilla password
    --bugzilla-url=BZ_URL
                        Bugzilla URL, default is https://bugzilla.redhat.com/