SENDBUG(1)                 OpenBSD Reference Manual                 SENDBUG(1)

NAME
     sendbug - report a bug in OpenBSD

SYNOPSIS
     sendbug [-DEPV]

DESCRIPTION
     sendbug is used to submit problem reports (PRs) to the OpenBSD bugs
     database.  A template PR is opened in a text editor with some system in-
     formation already filled in, such as machine architecture, dmesg(8),
     pcidump(8), and acpidump(8).  The pcidump(8) and acpidump(8) output are
     important for ACPI development and can only be included if sendbug is run
     as root.

     Fields enclosed in `<>' should be completed by the user.  Once the PR is
     filled out, the user exits the editor and is presented with a choice:
     a)bort, e)dit, or s)end.  If abort is selected, the report is not deleted
     and the pathname of the report is printed.  If edit is selected, the user
     is given a chance to re-edit the report.

     If send is selected, the report is mailed to the bugs database, with a Cc
     to the author.  An auto-generated reply will be sent confirming the mail
     has been received.  Any follow up mail to the PR should keep the same
     mail subject.

     The bugs database can be queried using the online bug tracking system
     available at http://www.openbsd.org/query-pr.html.  This allows users to
     search for PRs based on either PR number or content.

     The options are as follows:

     -D      Do not attach dmesg(8), pcidump(8), and acpidump(8) output to the
             report.  This information is very helpful in reports, but may
             contain sensitive information about the sender.  This flag helps
             protect users' privacy in those cases.

     -E      The acpidump(8) output includes base64 encoded files.  This flag
             causes sendbug to read a PR from the standard input, decode the
             files, and write them into the current directory.

     -P      Generate and print the template with system information filled
             out.

     -V      Print the version number.

ENVIRONMENT
     EDITOR, VISUAL
             Specifies an editor to use.  If both EDITOR and VISUAL are set,
             VISUAL takes precedence.  If neither EDITOR nor VISUAL are set,
             the default is vi(1).

     PR_FORM
             Filename of PR form to use instead of using the built-in form.
             Such a PR form can be partially pre-completed to make the process
             faster.

     TMPDIR  Specifies a directory for temporary files to be created.  The de-
             fault is /tmp.

FILES
     /tmp/p.XXXXXXXXXX  temporary PR report

SEE ALSO
     crash(8), dmesg(8)

AUTHORS
     sendbug was written from scratch for the public domain by Ray Lai
     <ray@cyth.net>.

CAVEATS
     The content of the PR is not confidential; it is sent out to a public
     mailing list.  Sensitive, security related issues should be sent via
     email to <security@OpenBSD.org>.

OpenBSD 4.7                      June 10, 2009                               2
