man > bts(1)

BTS(1)                                                                                        BTS(1)

NAME
       bts - developers' command line interface to the Debian Bug Tracking System

SYNOPSIS
       bts [options] command [args] [#comment] [.|, command [args] [#comment]] ...

DESCRIPTION
       This is a command line interface to the Debian Bug Tracking System (BTS), intended mainly for
       use by developers. It lets the BTS be manipulated using simple commands that can be run at
       the prompt or in a script, does various sanity checks on the input, and constructs and sends
       a mail to the BTS control address for you. A local cache of web pages and e-mails from the
       BTS may also be created and updated.

       In general, the command line interface is the same as what you would write in a mail to
       control AT bugs.org, just prefixed with "bts". For example:

        % bts severity 69042 normal
        % bts merge 69042 43233
        % bts retitle 69042 blah blah

       A few additional commands have been added for your convenience, and this program is less
       strict about what constitutes a valid bug number. For example, "severity Bug#85942 normal" is
       understood, as is "severity #85942 normal".  (Of course, your shell may regard "#" as a
       comment character though, so you may need to quote it!)

       Also, for your convenience, this program allows you to abbreviate commands to the shortest
       unique substring (similar to how cvs lets you abbreviate commands). So it understands things
       like "bts cl 85942".

       It is also possible to include a comment in the mail sent to the BTS. If your shell does not
       strip out the comment in a command like "bts severity 30321 normal #inflated severity", then
       this program is smart enough to figure out where the comment is, and include it in the email.
       Note that most shells do strip out such comments before they get to the program, unless the
       comment is quoted.  (Something like "bts severity #85942 normal" will not be treated as a
       comment!)

       You can specify multiple commands by separating them with a single dot, rather like
       update-rc.d; a single comma may also be used; all the commands will then be sent in a single
       mail. It is important the dot/comma is surrounded by whitespace so it is not mistaken for
       part of a command.  For example (quoting where necessary so that bts sees the comment):

        % bts severity 95672 normal , merge 95672 95673 \#they are the same!

       The abbreviation "it" may be used to refer to the last mentioned bug number, so you could
       write:

        % bts severity 95672 wishlist , retitle it "bts: please add a --foo option"

       Please use this program responsibly, and do take our users into consideration.

OPTIONS
       bts examines the devscripts configuration files as described below.  Command line options
       override the configuration file settings, though.

       -o, --offline
           Make  bts use cached bugs for the show and bugs commands, if a cache is available for the
           requested data. See the cache command, below for information on setting up a cache.

       --online, --no-offline
           Opposite of --offline; overrides any configuration file directive to work offline.

       -n, --no-action
           Do not send emails but print them to standard output.

       --cache, --no-cache
           Should we attempt to cache new versions of BTS pages when performing show/bugs  commands?
           Default is to cache.

       --cache-mode={min|mbox|full}
           When running a bts cache command, should we only mirror the basic bug (min), or should we
           also  mirror  the mbox version (mbox), or should we mirror the whole thing, including the
           mbox and the boring attachments to the BTS  bug  pages  and  the  acknowledgement  emails
           (full)?  Default is min.

       --cache-delay=seconds
           Time  in  seconds  to delay between each download, to avoid hammering the BTS web server.
           Default is 5 seconds.

       --mbox
           Open a mail reader to read the mbox corresponding to a given bug number for show and bugs
           commands.

       --mailreader=READER
           Specify the command to read the mbox.  Must contain a "%s" string (unquoted!), which will
           be replaced by the name of the mbox file.  The command will be split on white  space  and
           will  not  be passed to a shell.  Default is 'mutt -f %s'.  (Also, %% will be substituted
           by a single % if this is needed.)

       --cc-addr=CC_EMAIL_ADDRESS
           Send carbon copies to a list of users. CC_EMAIL_ADDRESS should be a comma-separated  list
           of email addresses. Multiple options add more CCs.

       --use-default-cc
           Add  the  addresses specified in the configuration file option BTS_DEFAULT_CC to the list
           specified using --cc-addr.  This is the default.

       --no-use-default-cc
           Do not add addresses specified in BTS_DEFAULT_CC to the carbon copy list.

       --sendmail=SENDMAILCMD
           Specify the sendmail command.  The command will be split on white space and will  not  be
           passed  to  a shell.  Default is /usr/sbin/sendmail.  The -t option will be automatically
           added if the command is /usr/sbin/sendmail or /usr/sbin/exim*.   For  other  mailers,  if
           they  require  a  -t  option,  this  must  be  included  in the SENDMAILCMD, for example:
           --sendmail="/usr/sbin/mymailer -t".

       --mutt
           Use mutt for sending of mails. Default is not to use mutt, except for some commands.

           Note that one of $DEBEMAIL or $EMAIL must be set in the environment in order to use  mutt
           to send emails.

       --no-mutt
           Don't use mutt for sending of mails.

       --soap-timeout=SECONDS
           Specify a timeout for SOAP calls as used by the select and status commands.

       --smtp-host=SMTPHOST
           Specify an SMTP host.  If given, bts will send mail by talking directly to this SMTP host
           rather than by invoking a sendmail command.

           The  host  name may be followed by a colon (":") and a port number in order to use a port
           other than the default.  It may also begin with "ssmtp://" or "smtps://" to indicate that
           SMTPS should be used.

           If SMTPS not specified, bts will still try to use STARTTLS if it's advertised by the SMTP
           host.

           Note that one of $DEBEMAIL or $EMAIL must be set in  the  environment  in  order  to  use
           direct SMTP connections to send emails.

           Note  that  when  sending directly via an SMTP host, specifying addresses in --cc-addr or
           BTS_DEFAULT_CC that the SMTP host will not relay will cause the SMTP host to  reject  the
           entire mail.

           Note   also   that   the  use  of  the  reassign  command  may,  when  either  --mutt  or
           --force-interactive mode  is  enabled,  lead  to  the  automatic  addition  of  a  Cc  to
           $newpackage@packages.debian.org.   In  these  cases,  the  note  above regarding relaying
           applies.  The submission interface (port 587) on reportbug.debian.org  does  not  support
           relaying  and,  as  such,  should  not  be  used  as  an  SMTP  server  for bts under the
           circumstances described in this paragraph.

       --smtp-username=USERNAME, --smtp-password=PASSWORD
           Specify the  credentials  to  use  when  connecting  to  the  SMTP  server  specified  by
           --smtp-host.  If the server does not require authentication then these options should not
           be used.

           If  a  username  is specified but not a password, bts will prompt for the password before
           sending the mail.

       --smtp-helo=HELO
           Specify the name to use in the HELO command when connecting to the SMTP server;  defaults
           to the contents of the file /etc/mailname, if it exists.

           Note that some SMTP servers may reject the use of a HELO which either does not resolve or
           does not appear to belong to the host using it.

       --bts-server
           Use a debbugs server other than https://bugs.debian.org.

       -f, --force-refresh
           Download  a  bug  report again, even if it does not appear to have changed since the last
           cache command.  Useful if a --cache-mode=full is requested for the first time  (otherwise
           unchanged bug reports will not be downloaded again, even if the boring bits have not been
           downloaded).

       --no-force-refresh
           Suppress any configuration file --force-refresh option.

       --only-new
           Download only new bugs when caching. Do not check for updates in bugs we already have.

       --include-resolved
           When caching bug reports, include those that are marked as resolved.  This is the default
           behaviour.

       --no-include-resolved
           Reverse the behaviour of the previous option.  That is, do not cache bugs that are marked
           as resolved.

       --no-ack
           Suppress  acknowledgment  mails from the BTS.  Note that this will only affect the copies
           of messages CCed to bugs, not those sent to the control bot.

       --ack
           Do not suppress acknowledgement mails.  This is the default behaviour.

       -i, --interactive
           Before sending an e-mail to the control bot, display the  content  and  allow  it  to  be
           edited, or the sending cancelled.

       --force-interactive
           Similar  to  --interactive, with the exception that an editor is spawned before prompting
           for confirmation of the message to be sent.

       --no-interactive
           Send control e-mails without confirmation.  This is the default behaviour.

       -q, --quiet
           When running bts cache, only display information about newly cached pages,  not  messages
           saying already cached.  If this option is specified twice, only output error messages (to
           stderr).

       --no-conf, --noconf
           Do  not read any configuration files.  This can only be used as the first option given on
           the command-line.

COMMANDS
       For    full    details    about    the    commands,    see     the     BTS     documentation.
       <https://www.debian.org/Bugs/server-control>

       show [options] [bug number | package | maintainer | : ] [opt=val ...]
       show [options] [src:package | from:submitter] [opt=val ...]
       show [options] [tag:tag | usertag:tag ] [opt=val ...]
       show [release-critical | release-critical/... | RC]
           This is a synonym for bts bugs.

       bugs [options] [bug_number | package | maintainer | : ] [opt=val ...]
       bugs [options] [src:package | from:submitter] [opt=val ...]
       bugs [options] [tag:tag | usertag:tag ] [opt=val ...]
       bugs [release-critical | release-critical/... | RC]
           Display the page listing the requested bugs in a web browser using sensible-browser(1).

           Options  may  be specified after the bugs command in addition to or instead of options at
           the  start   of   the   command   line:   recognised   options   at   this   point   are:
           -o/--offline/--online,  -m/--mbox,  --mailreader  and  --[no-]cache.  These are described
           earlier in this manpage.  If either the -o or --offline  option  is  used,  or  there  is
           already an up-to-date copy in the local cache, the cached version will be used.

           The meanings of the possible arguments are as follows:

           (none)  If  nothing  is  specified, bts bugs will display your bugs, assuming that either
                   DEBEMAIL or EMAIL (examined in that  order)  is  set  to  the  appropriate  email
                   address.

           bug_number
                   Display bug number bug_number.

           package Display the bugs for the package package.

           src:package
                   Display the bugs for the source package package.

           maintainer
                   Display the bugs for the maintainer email address maintainer.

           from:submitter
                   Display the bugs for the submitter email address submitter.

           tag:tag Display the bugs which are tagged with tag.

           usertag:tag
                   Display  the  bugs  which are tagged with usertag tag.  See the BTS documentation
                   for more information on usertags.  This will require the  use  of  a  users=email
                   option.

           :       Details  of  the  bug  tracking system itself, along with a bug-request page with
                   more options than this script, can be found  on  https://bugs.debian.org/.   This
                   page itself will be opened if the command 'bts bugs :' is used.

           release-critical, RC
                   Display  the  front  page  of  the  release-critical pages on the BTS.  This is a
                   synonym  for  https://bugs.debian.org/release-critical/index.html.   It  is  also
                   possible  to say release-critical/debian/main.html and the like.  RC is a synonym
                   for release-critical/other/all.html.

           After the argument specifying what to display, you can optionally specify options to  use
           to  format  the page or change what it displayed.  These are passed to the BTS in the URL
           downloaded. For example, pass dist=stable to see bugs affecting the stable version  of  a
           package,  version=1.0  to see bugs affecting that version of a package, or reverse=yes to
           display newest messages first in a bug log.

           If caching has been enabled (that is, --no-cache has not been used, and BTS_CACHE has not
           been set to no), then any page requested by bts show will automatically be cached, and be
           available offline thereafter.  Pages which are automatically cached in this way  will  be
           deleted on subsequent "bts show|bugs|cache" invocations if they have not been accessed in
           30  days.   Warning:  on  a  filesystem  mounted  with the "noatime" option, running "bts
           show|bugs" does not update the cache files' access times;  a  cached  bug  will  then  be
           subject to auto-cleaning 30 days after its initial download, even if it has been accessed
           in the meantime.

           Any  other  bts  commands  following  this on the command line will be executed after the
           browser has been exited.

           The desired browser can be specified and configured by setting  the  BROWSER  environment
           variable.     The    conventions    follow    those    defined   by   Eric   Raymond   at
           http://www.catb.org/~esr/BROWSER/; we here reproduce the relevant part.

           The value of BROWSER may consist of a colon-separated series of  browser  command  parts.
           These  should  be  tried  in  order  until one succeeds. Each command part may optionally
           contain the string %s; if it does, the URL to  be  viewed  is  substituted  there.  If  a
           command  part  does  not contain %s, the browser is to be launched as if the URL had been
           supplied as its first argument. The string %% must be substituted as a single %.

           Rationale: We need to be able to specify multiple browser commands  so  programs  obeying
           this  convention  can  do  the  right thing in either X or console environments, trying X
           first. Specifying multiple commands may also be useful for people who  share  files  like
           .profile  across  multiple systems. We need %s because some popular browsers have remote-
           invocation syntax that requires it. Unless %% reduces to %, it won't be possible to  have
           a literal %s in the string.

           For example, on most Linux systems a good thing to do would be:

           BROWSER='mozilla -raise -remote "openURL(%s,new-window)":links'

       select [key:value ...]
           Uses  the  SOAP  interface  to  output  a  list  of  bugs which match the given selection
           requirements.

           The following keys are allowed, and may be given multiple times.

           package Binary package name.

           source  Source package name.

           maintainer
                   E-mail address of the maintainer.

           submitter
                   E-mail address of the submitter.

           severity
                   Bug severity.

           status  Status of the bug.  One of open, done, or forwarded.

           tag     Tags applied to the bug. If users is specified, may include usertags in  addition
                   to the standard tags.

           owner   Bug's owner.

           correspondent
                   Address of someone who sent mail to the log.

           affects Bugs which affect this package.

           bugs    List of bugs to search within.

           users   Users to use when looking up usertags.

           archive Whether  to  search archived bugs or normal bugs; defaults to 0 (i.e. only search
                   normal bugs). As a special case, if archive is both, both archived and unarchived
                   bugs are returned.

           For example, to select the set of  bugs  submitted  by  jrandomdeveloper AT example.com  and
           tagged wontfix, one would use

           bts select submitter:jrandomdeveloper AT example.com tag:wontfix

           If a key is used multiple times then the set of bugs selected includes those matching any
           of the supplied values; for example

           bts select package:foo severity:wishlist severity:minor

           returns all bugs of package foo with either wishlist or minor severity.

       status [bug | file:file | fields:field[,field ...] | verbose] ...
           Uses  the SOAP interface to output status information for the given bugs (or as read from
           the listed files -- use - to indicate STDIN).

           By default, all populated fields for a bug are displayed.

           If verbose is given, empty fields will also be displayed.

           If fields is given, only those  fields  will  be  displayed.   No  validity  checking  is
           performed on any specified fields.

       clone bug new_ID [new_ID ...]
           The  clone control command allows you to duplicate a bug report. It is useful in the case
           where a single report actually indicates that multiple distinct bugs have occurred.  "New
           IDs"  are  negative numbers, separated by spaces, which may be used in subsequent control
           commands to refer to the newly duplicated bugs.  A new report is generated for  each  new
           ID.

       done bug [version]
           Mark  a  bug  as Done. This forces interactive mode since done messages should include an
           explanation why the bug is being closed.  You should specify which version of the package
           closed the bug, if possible.

       reopen bug [submitter]
           Reopen a bug, with optional submitter.

       archive bug
           Archive a bug that has previously been archived but  is  currently  not.   The  bug  must
           fulfill  all of the requirements for archiving with the exception of those that are time-
           based.

       unarchive bug
           Unarchive a bug that is currently archived.

       retitle bug title
           Change the title of the bug.

       summary bug [messagenum]
           Select a message number that should be used as the summary of a bug.

           If no message number is given, the summary is cleared.

       submitter bug [bug ...] submitter-email
           Change the submitter address of a bug or a number  of  bugs,  with  !  meaning  `use  the
           address on the current email as the new submitter address'.

       reassign bug [bug ...] package [version]
           Reassign  a  bug  or  a  number  of  bugs  to  a different package.  The version field is
           optional; see the explanation at <https://www.debian.org/Bugs/server-control>.

       found bug [version]
           Indicate that a bug was found to exist in a particular package version.  Without version,
           the list of fixed versions is cleared and the bug is reopened.

       notfound bug version
           Remove the record that bug was encountered in the given version of the package  to  which
           it is assigned.

       fixed bug version
           Indicate  that  a  bug  was  fixed in a particular package version, without affecting the
           bug's open/closed status.

       notfixed bug version
           Remove the record that a bug was fixed in the given version of the package to which it is
           assigned.

           This is equivalent to the  sequence  of  commands  "found  bug  version",  "notfound  bug
           version".

       block bug by|with bug [bug ...]
           Note that a bug is blocked from being fixed by a set of other bugs.

       unblock bug by|with bug [bug ...]
           Note that a bug is no longer blocked from being fixed by a set of other bugs.

       merge bug bug [bug ...]
           Merge a set of bugs together.

       forcemerge bug bug [bug ...]
           Forcibly  merge  a  set of bugs together. The first bug listed is the master bug, and its
           settings (those which must be equal in a normal merge) are assigned to  the  bugs  listed
           next.

       unmerge bug
           Unmerge a bug.

       tag bug [+|-|=] tag [tag ...]
       tags bug [+|-|=] tag [tag ...]
           Set  or  unset  a  tag  on  a  bug. The tag may either be the exact tag name or it may be
           abbreviated to any unique tag substring. (So using fixed will  set  the  tag  fixed,  not
           fixed-upstream,  for  example,  but  fix  would  not be acceptable.) Multiple tags may be
           specified as well. The two commands (tag and tags) are identical. At least one  tag  must
           be specified, unless the = flag is used, where the command

             bts tags <bug> =

           will remove all tags from the specified bug.

           Adding/removing  the  security tag will add "team\@security.debian.org" to the Cc list of
           the control email.

           The   list   of    valid    tags    and    their    significance    is    available    at
           <https://www.debian.org/Bugs/Developer#tags>. The current valid tags are:

           patch,  wontfix, moreinfo, unreproducible, fixed, help, security, upstream, pending, d-i,
           confirmed, ipv6, lfs, fixed-upstream, l10n, newcomer, a11y, ftbfs

           There is also a tag for each release of Debian since "potato". Note that this list may be
           out of date, see the website for the most up to date source.

       affects bug [+|-|=] package [package ...]
           Indicates that a bug affects a package other than that against which it is filed, causing
           the bug to be listed by default in the package list of the other  package.   This  should
           generally  be used where the bug is severe enough to cause multiple reports from users to
           be assigned to the wrong package.  At least one package must be specified, unless  the  =
           flag is used, where the command

             bts affects <bug> =

           will remove all indications that bug affects other packages.

       user email
           Specify a user email address before using the usertags command.

       usertag bug [+|-|=] tag [tag ...]
       usertags bug [+|-|=] tag [tag ...]
           Set or unset a user tag on a bug. The tag must be the exact tag name wanted; there are no
           defaults  or  checking  of  tag  names.   Multiple tags may be specified as well. The two
           commands (usertag and usertags) are identical.  At  least  one  tag  must  be  specified,
           unless the = flag is used, where the command

             bts usertags <bug> =

           will remove all user tags from the specified bug.

       claim bug [claim]
           Record  that  you have claimed a bug (e.g. for a bug squashing party).  claim should be a
           unique token allowing the bugs you have claimed to be identified; an  e-mail  address  is
           often used.

           If  no  claim  is  specified, the environment variable DEBEMAIL or EMAIL (checked in that
           order) is used.

       unclaim bug [claim]
           Remove the record that you have claimed a bug.

           If no claim is specified, the environment variable DEBEMAIL or  EMAIL  (checked  in  that
           order) is used.

       severity bug severity
           Change  the  severity  of  a  bug.  Available  severities  are:  wishlist, minor, normal,
           important, serious, grave, critical. The  severity  may  be  abbreviated  to  any  unique
           substring.

       forwarded bug address
           Mark  the bug as forwarded to the given address (usually an email address or a URL for an
           upstream bug tracker).

       notforwarded bug
           Mark a bug as not forwarded.

       package [package ...]
           The following commands will only apply to bugs against the listed packages; this acts  as
           a  safety  mechanism  for  the  BTS.  If no packages are listed, this check is turned off
           again.

       limit [key[:value]] ...
           The following commands will only apply to bugs which meet the specified  criterion;  this
           acts as a safety mechanism for the BTS.  If no values are listed, the limits for that key
           are turned off again.  If no keys are specified, all limits are reset.

           submitter
                   E-mail address of the submitter.

           date    Date the bug was submitted.

           subject Subject of the bug.

           msgid   Message-id of the initial bug report.

           package Binary package name.

           source  Source package name.

           tag     Tags applied to the bug.

           severity
                   Bug severity.

           owner   Bug's owner.

           affects Bugs affecting this package.

           archive Whether  to  search archived bugs or normal bugs; defaults to 0 (i.e. only search
                   normal bugs). As a special case, if archive is both, both archived and unarchived
                   bugs are returned.

           For example, to limit the set of bugs affected by  the  subsequent  control  commands  to
           those submitted by jrandomdeveloper AT example.com and tagged wontfix, one would use

           bts limit submitter:jrandomdeveloper AT example.com tag:wontfix

           If a key is used multiple times then the set of bugs selected includes those matching any
           of the supplied values; for example

           bts limit package:foo severity:wishlist severity:minor

           only  applies the subsequent control commands to bugs of package foo with either wishlist
           or minor severity.

       owner bug owner-email
           Change the "owner" address of a bug, with ! meaning `use the address on the current email
           as the new owner address'.

           The owner of a bug accepts responsibility for dealing with it.

       noowner bug
           Mark a bug as having no "owner".

       subscribe bug [email]
           Subscribe the given email address to the specified bug report.  If no  email  address  is
           specified,  the environment variable DEBEMAIL or EMAIL (in that order) is used.  If those
           are not set, or ! is given as email address, your default address will be used.

           After executing this command, you will be sent a subscription confirmation to  which  you
           have  to  reply.   When  subscribed  to a bug report, you receive all relevant emails and
           notifications.  Use the unsubscribe command to unsubscribe.

       unsubscribe bug [email]
           Unsubscribe the given email address from the specified bug  report.   As  with  subscribe
           above,  if no email address is specified, the environment variables DEBEMAIL or EMAIL (in
           that order) is used.  If those are not set, or ! is given as email address, your  default
           address will be used.

           After  executing  this  command, you will be sent an unsubscription confirmation to which
           you have to reply. Use the subscribe command to, well, subscribe.

       reportspam bug ...
           The reportspam command allows you to report a bug report as containing  spam.   It  saves
           one from having to go to the bug web page to do so.

       spamreport bug ...
           spamreport is a synonym for reportspam.

       cache [options] [maint_email | pkg | src:pkg | from:submitter]
       cache [options] [release-critical | release-critical/... | RC]
           Generate  or  update  a  cache  of bug reports for the given email address or package. By
           default it downloads all bugs belonging to the email address in the DEBEMAIL  environment
           variable  (or  the  EMAIL environment variable if DEBEMAIL is unset). This command may be
           repeated to cache bugs belonging to several people or packages. If multiple  packages  or
           addresses  are  supplied,  bugs  belonging  to any of the arguments will be cached; those
           belonging to more than one of the arguments will only be downloaded once. The cached bugs
           are stored in $XDG_CACHE_HOME/devscripts/bts/  or,  if  XDG_CACHE_HOME  is  not  set,  in
           ~/.cache/devscripts/bts/.

           You can use the cached bugs with the -o switch. For example:

             bts -o bugs
             bts -o show 12345

           Also,  bts will update the files in it in a piecemeal fashion as it downloads information
           from the BTS using the show command. You might thus set up  the  cache,  and  update  the
           whole  thing  once  a week, while letting the automatic cache updates update the bugs you
           frequently refer to during the week.

           Some options affect the behaviour of the cache command.  The  first  is  the  setting  of
           --cache-mode,  which controls how much bts downloads of the referenced links from the bug
           page, including boring bits such as the acknowledgement emails,  emails  to  the  control
           bot,  and  the  mbox  version  of  the  bug  report.   It can take three values: min (the
           minimum), mbox (download the minimum plus the mbox version of the  bug  report)  or  full
           (the  whole works).  The second is --force-refresh or -f, which forces the download, even
           if the cached bug report is up-to-date.  The --include-resolved option indicates  whether
           bug reports marked as resolved should be downloaded during caching.

           Each  of these is configurable from the configuration file, as described below.  They may
           also be specified after the cache command as well as at the start of the command line.

           Finally, -q or --quiet will suppress messages about caches being up-to-date,  and  giving
           the option twice will suppress all cache messages (except for error messages).

           Beware  of caching RC, though: it will take a LONG time!  (With 1000+ RC bugs and a delay
           of 5 seconds between bugs, you're looking  at  a  minimum  of  1.5  hours,  and  probably
           significantly more than that.)

       cleancache package | src:package | maintainer
       cleancache from:submitter | tag:tag | usertag:tag | number | ALL
           Clean  the  cache for the specified package, maintainer, etc., as described above for the
           bugs command, or clean the entire cache if ALL is specified. This is useful  if  you  are
           going  to  have permanent network access or if the database has become corrupted for some
           reason.  Note that for safety, this command does not default to the value of DEBEMAIL  or
           EMAIL.

       listcachedbugs [number]
           List  cached  bug ids (intended to support bash completion). The optional number argument
           restricts the list to those bug ids that start with that number.

       version
           Display version and copyright information.

       help
           Display a short summary of commands, suspiciously similar to parts of this man page.

ENVIRONMENT VARIABLES
       DEBEMAIL
           If this is set, the From: line in the email will be set to use this email address instead
           of your normal email address (as would be determined by mail).

       DEBFULLNAME
           If DEBEMAIL is set, DEBFULLNAME is examined to determine the full name to use; if this is
           not set, bts attempts to determine a name from your passwd entry.

       BROWSER
           If set, it specifies the browser  to  use  for  the  show  and  bugs  options.   See  the
           description above.

CONFIGURATION VARIABLES
       The  two configuration files /etc/devscripts.conf and ~/.devscripts are sourced by a shell in
       that order to set configuration variables.  Command line options  can  be  used  to  override
       configuration  file  settings.   Environment  variable settings are ignored for this purpose.
       The currently recognised variables are:

       BTS_OFFLINE
           If this is set to yes, then it is the same as the --offline command line parameter  being
           used.   Only  has  an  effect on the show and bugs commands.  The default is no.  See the
           description of the show command above for more information.

       BTS_CACHE
           If this is set to no, then it is the same as the --no-cache command line parameter  being
           used.   Only has an effect on the show and bug commands.  The default is yes.  Again, see
           the show command above for more information.

       BTS_CACHE_MODE={min,mbox,full}
           How much of the BTS should we mirror when we are asked  to  cache  something?   Just  the
           minimum,  or  also  the mbox or the whole thing?  The default is min, and it has the same
           meaning as the --cache-mode command line parameter.  Only has an  effect  on  the  cache.
           See the cache command for more information.

       BTS_FORCE_REFRESH
           If  this is set to yes, then it is the same as the --force-refresh command line parameter
           being used.  Only has an effect on the cache command.  The default is no.  See the  cache
           command for more information.

       BTS_MAIL_READER
           If this is set, specifies a mail reader to use instead of mutt.  Same as the --mailreader
           command line option.

       BTS_SENDMAIL_COMMAND
           If  this is set, specifies a sendmail command to use instead of /usr/sbin/sendmail.  Same
           as the --sendmail command line option.

       BTS_ONLY_NEW
           Download only new bugs when caching. Do not check for updates in bugs  we  already  have.
           The default is no.  Same as the --only-new command line option.

       BTS_SMTP_HOST
           If  this  is  set,  specifies  an SMTP host to use for sending mail rather than using the
           sendmail command.  Same as the --smtp-host command line option.

           Note that this option takes priority over BTS_SENDMAIL_COMMAND if both  are  set,  unless
           the --sendmail option is used.

       BTS_SMTP_AUTH_USERNAME, BTS_SMTP_AUTH_PASSWORD
           If  these options are set, then it is the same as the --smtp-username and --smtp-password
           options being used.

       BTS_SMTP_HELO
           Same as the --smtp-helo command line option.

       BTS_INCLUDE_RESOLVED
           If this is set to no, then it is the  same  as  the  --no-include-resolved  command  line
           parameter being used.  Only has an effect on the cache command.  The default is yes.  See
           the cache command for more information.

       BTS_SUPPRESS_ACKS
           If  this  is set to yes, then it is the same as the --no-ack command line parameter being
           used.  The default is no.

       BTS_INTERACTIVE
           If this is  set  to  yes  or  force,  then  it  is  the  same  as  the  --interactive  or
           --force-interactive command line parameter being used.  The default is no.

       BTS_DEFAULT_CC
           Specify  a list of e-mail addresses to which a carbon copy of the generated e-mail to the
           control bot should automatically be sent.

       BTS_SERVER
           Specify  the  name  of   a   debbugs   server   which   should   be   used   instead   of
           https://bugs.debian.org.

SEE ALSO
       Please  see  <https://www.debian.org/Bugs/server-control>  for more details on how to control
       the BTS using emails and <https://www.debian.org/Bugs/> for more information about the BTS.

       querybts(1), reportbug(1), pts-subscribe(1), devscripts.conf(5)

COPYRIGHT
       This program is Copyright (C) 2001-2003 by Joey Hess <joeyh AT debian.org>.  Many  modifications
       have been made, Copyright (C) 2002-2005 Julian Gilbey <jdg AT debian.org> and Copyright (C) 2007
       Josh Triplett <josh AT freedesktop.org>.

       It  is  licensed  under  the  terms  of the GPL, either version 2 of the License, or (at your
       option) any later version.

Debian Utilities                             2026-02-25                                       BTS(1)
bts(1)
NAME SYNOPSIS DESCRIPTION OPTIONS
-o, --offline -n, --no-action --mbox --use-default-cc --no-use-default-cc --mutt --no-mutt --bts-server -f, --force-refresh --no-force-refresh --only-new --include-resolved --no-include-resolved --no-ack --ack -i, --interactive --force-interactive --no-interactive -q, --quiet
COMMANDS
version help
ENVIRONMENT VARIABLES CONFIGURATION VARIABLES SEE ALSO COPYRIGHT

Generated by phpman v4.9.26-5-g7740029 · Markdown · JSON · MCP Author: Che Dong Under GNU General Public License
2026-08-30 17:52 @216.73.217.135
CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
Valid XHTML 1.0 Transitional!Valid CSS!

^_top_^