reportbug - reports a bug to a debbugs server Linux Man Page

-h, --help

Show summary of options.

-v, --version

Show the version of reportbug and exit.

-a, --af

Instead of spawning an editor to revise the bug report, use the af mail reader to edit and send it.

-A FILENAME, --attach=FILENAME

Attach a file to the bug report; both text and binary files are acceptable. This routine will create a MIME attachment with the file included; in some cases (usually text files), it is probably better to use --include. (Please note that Debian's bug tracking system has limited support for MIME attachments.)

-b, --no-query-bts

Don't check the Debian bug tracking system to see if this problem has already been reported; useful for offline use or if you're really sure it's a bug.

--query-bts

Check the Debian bug tracking system to see if this problem has already been reported (default).

-B SYSTEM, --bts=SYSTEM

Instead of the Debian bug server (or the bug server specified in /etc/reportbug.conf, use the server specified by SYSTEM. You can specify help to get a list of supported servers.

--body=BODY

Use the specified BODY as the body of the message. The body text will be wrapped at 70 columns, and the normal reportbug headers and footers will be added as appropriate. The editor prompt and any "special" prompting will be bypassed.

--body-file=BODYFILE

The contents of the (assumed to be) text file BODYFILE will be used as the message body. This file is assumed to be properly formatted (i.e. reasonable line lengths, etc.). The usual headers and footers will be added, and the editor step and "special" prompts will be skipped. (BODYFILE may also be a named pipe; using a device special file may lead to unusual results.)

-c, --no-config-files

Omit configuration files from the bug report without asking. By default, you are asked if you want to include them; in some cases, doing so may cause sensitive information to be sent via email.

--configure

Rerun the reportbug first time configuration routine, and write a new .reportbugrc file. This will erase any pre-existing settings in the file; however, a backup will be written as .reportbugrc~.

--check-available

Check for newer releases of the package at packages.debian.org (default).

--no-check-available

Do not check for newer releases of the package at packages.debian.org.

-d, --debug

Don't send a real bug report to Debian; send it to yourself instead. This is primarily used for testing by the maintainer.

-e EDITOR, --editor=EDITOR

Specify the editor to use, overriding any EDITOR or VISUAL environment variable setting.

--email=ADDRESS

Set the email address your report should appear to be sent from (i.e. the address that appears in the From: header). This should be the actual Internet email address on its own (i.e. without a real name or comment part). This setting will override the EMAIL and DEBEMAIL environment variables, but not REPORTBUGEMAIL.

--exit-prompt

Display a prompt before exiting; this is useful if reportbug is run in a transient terminal (i.e. from its Debian menu entry).

-f FILENAME, --filename=FILENAME

Report a bug in the package containing FILENAME so you don't have to figure out what package the file belongs to. The path will be searched for an exact path for FILENAME before attempting to broaden the search to all files.

--path

If the -f option is also specified, only search the path for the specified FILENAME. Specifying an absolute path with the -f option (i.e. one beginning with a /) overrides this behavior.

-g, --gnupg, --gpg

Attach a digital signature to the bug report using GnuPG (the GNU Privacy Guard). (This argument will be ignored if you are using an MUA to edit and send your report.)

-G, --gnus

Use the GNUS mail and news reader to send your report, rather than using the editor.

-H HEADER, --header=HEADER

Add a custom RFC 2822 header to your email; for example, to send a carbon copy of the report to debian-68k@lists.linux-m68k.org you could use -H 'X-Debbugs-CC: debian-68k@lists.linux-m68k.org'

-i FILE, --include=FILE

Include the specified file as part of the body of the message to be edited. Can be used multiple times to add multiple files; text-only please! From a suggestion by Michael Alan Dorman in the bug bug list. (See also the --attach option.)

-I, --no-check-installed

Do not check whether the package is installed before filing a report. This is generally only useful when filing a report on a package you know is not installed on your system.

--check-installed

Check if the specified package is installed when filing reports. (This is the default behavior of reportbug.)

-j JUSTIFICATION, --justification=JUSTIFICATION

Bugs in Debian that have "serious", "grave", or "critical" severities must meet certain criteria to be classified as such. This option allows you to specify the justification for a release-critical bug, instead of being prompted for it.

-k, --kudos

Send appreciative email to the recorded maintainer address, rather than filing a bug report. (You can also send kudos to packagename@packages.debian.org, for packages in the Debian archive; however, this option uses the Maintainer address from the control file, so it works with other package sources too.)

-K KEYID, --keyid=KEYID

Private key to use for PGP/GnuPG signatures. If not specified, the first key in the secret keyring that matches your email address will be used.

--license

Show reportbug's copyright and license information on standard output.

--list-cc=ADDRESS

Send a carbon copy of the report to the specified list after a report number is assigned; this is the equivalent to the option -H 'X-Debbugs-CC: ADDRESS'. This option will only work as intended with debbugs systems.

-m, --maintonly

Only send the bug to the package maintainer; the bug tracking system will not send a copy to the bug report distribution lists.

--mode=MODE

Set the operating mode for reportbug. reportbug currently has four operating modes: novice (the default), standard, advanced, and expert.
novice mode is designed to minimize prompting about things that "ordinary users" would be unlikely to know or care about, shifting the triage burden onto the maintainer.  Checking for new versions is only done for the stable distribution in this mode.  It is currently the default mode.
standard mode is more-or-less equivalent to the prompting that was provided by reportbug 1.50 and earlier; it includes a relatively large number of prompts and tries to encourage users to not file frivolous or duplicative bug reports.
advanced mode is like standard mode, but may include shortcuts suitable for more advanced users of Debian, without being as close to the metal (and potential flamage) as expert mode.  (Currently, the only differences from standard mode are that it assumes familiarity with the "incoming" queue; it allows the reporting of bugs on "dependency" packages; and it does not prompt where to insert the report text in the editor.)
expert mode is designed to minimize prompts that are designed to discourage frivolous or unnecessary bug reports, "severity inflation," and the like.  In expert mode, reportbug assumes the user is thoroughly familiar with Debian policies.  In practice, this means that reporters are no longer required to justify setting a high severity on a bug report, and certain automated cleanups of the message are bypassed.  Individuals who do not regularly contribute to the Debian project are highly discouraged from using expert mode, as it can lead to flamage from maintainers when used improperly.

-M, --mutt

Instead of spawning an editor to revise the bug report, use the mutt mail reader to edit and send it.

--mta='<MTA>'

Specify an alternate MTA, instead of /usr/sbin/sendmail (the default). Any smtphost setting will override this one.

--mua='<MUA> <option>'

Instead of spawning an editor to revise the bug report, use the specified MUA (mail user agent) to edit and send it. The option should be used to tell your mail reader to interpret the report as a draft message. For examples of how this works, see how the --mutt, --nmh and --af options are processed.

-n, --nmh, --mh

Instead of spawning an editor to revise the bug report, use the comp command (part of the nmh and mh mail systems) to edit and send it.

-o FILE, --output=FILE

Instead of sending an email, redirect it to the specified filename.

-O, --offline

Disable all external queries. Currently has the same effect as --no-check-available --no-query-bts.

-p, --print

Instead of sending an email, print the bug report to standard output, so you can redirect it to a file or pipe it to another program.
This option only outputs a template for a bug report; you will need to fill in the long description.

--paranoid

Show the contents of the message before it is sent, including all headers. Automatically disabled if in template mode.

--no-paranoid

Don't show the full contents of the message before it is sent (default).

--pgp

Attach a digital signature to the bug report using PGP (Pretty Good Privacy). Please note, however, that the Debian project is phasing out the use of PGP in favor of GnuPG. (This argument will be ignored if using an MUA to edit and send your report.)

--proxy=PROXY, --http_proxy=PROXY

Specify the WWW proxy server to use to handle the query of the bug tracking system. You should only need this parameter if you are behind a firewall. The PROXY argument should be formatted as a valid HTTP URL, including (if necessary) a port number; for example, http://192.168.1.1:3128/.

-q, --quiet

Suppress diagnostic messages to standard error.

-Q, --query-only

Do not submit a bug report; just query the BTS. Option ignored if you specify --no-bts-query.

--query-source

Query on all binary packages built by the same source, not just the binary package specified. (Default behavior as of reportbug 2.0)

--no-query-source

Only query on the binary package specified on the command line.

--realname=NAME

Set the real name (human-readable name) to use for your report.

--report-quiet

Register the bug in the bug tracking system, but don't send a report to the package maintainer or anyone else. Don't do this unless you're the maintainer of the package in question, or you really know what you are doing.

--reply-to=ADDRESS, --replyto=ADDRESS

Set the Reply-To address header in your report.

-s SUBJECT, --subject=SUBJECT

Set the subject of the bug report (i.e. a brief explanation of the problem, less than 60 characters). If you do not specify this switch, you will be prompted for a subject.

-S SEVERITY, --severity=SEVERITY

Specify a severity level, from critical, grave, serious, important, normal, minor, and wishlist.

--smtphost=HOST[:PORT]

Use the mail transport agent (MTA) at HOST to send your report, instead of your local /usr/sbin/sendmail program. This should generally be your ISP's outgoing mail server; you can also use 'localhost' if you have a working mail server running on your machine. If the PORT is omitted, the standard port for SMTP, port 25, is used.

--tls

If using SMTP, use Transport Layer Security (TLS) encryption to secure the connection to the mail server. Some SMTP servers may require this option.

--smtpuser=USERNAME

If using SMTP, use the specified USERNAME for authentication.

--smtppasswd=PASSWORD

If using SMTP, use the specified PASSWORD for authentication. If the password isn't specified on the command line or in the configuration file, a prompt will be displayed asking for it.
Use of this option is insecure on multiuser systems. Instead, you should set this option in .reportbugrc and ensure it is only readable by your user (e.g. with chmod 600 $HOME/.reportbugrc).

-t TYPE, --type=TYPE

Specify the type of report to be submitted; currently accepts either gnats or debbugs.

-T TAG, --tag=TAG

Specify a tag to be filed on this report. Multiple tags can be specified using multiple -T or --tag arguments.
Alternatively, you can specify the 'tag' none to bypass the tags prompt without specifying any tags; this will also ignore any tags specified on the command line.

--template

Output a template report to standard output.

-v, --verify

Verify the integrity of the package (if installed) using debsums before reporting.

-V VERSION, --package-version=VERSION

Specify the version of the package the problem was found in. This is probably most useful if you are reporting a bug in a package that is uninstallable or installed on a different system.

-x, --no-cc

Don't send a blind carbon copy (BCC) of the bug report to the submitter (i.e. yourself).

-z, --no-compress

Don't compress configuration files by removing comments and blank lines.