--- name: "Debbugs::Config" section: "3pm" platform: "linux" package: "libdebbugs-perl" version: "2.6.4" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/Debbugs::Config" --- # Debbugs::Config(3pm) ## NAME Debbugs::Config -- Configuration information for debbugs ## SYNOPSIS ``` use Debbugs::Config; ``` \# to get the compatiblity interface ``` use Debbugs::Config qw(:globals); ``` ## DESCRIPTION This module provides configuration variables for all of debbugs. ## CONFIGURATION FILES The default configuration file location is /etc/debbugs/config; this configuration file location can be set by modifying the DEBBUGS\_CONFIG\_FILE env variable to point at a different location. ## CONFIGURATION VARIABLES ### General Configuration - email\_domain $gEmailDomain The email domain of the bts - list\_domain $gListDomain The list domain of the bts, defaults to the email domain - web\_host $gWebHost The web host of the bts; defaults to the email domain - web\_host\_bug\_dir $gWebHostDir The directory of the web host on which bugs are kept, defaults to `''` - web\_domain $gWebDomain Full path of the web domain where bugs are kept including the protocol (http:// or https://). Defaults to the concatenation of 'http://', "web\_host" and "web\_host\_bug\_dir" - html\_suffix $gHTMLSuffix Suffix of html pages, defaults to .html - cgi\_domain $gCGIDomain Full path of the web domain where cgi scripts are kept. Defaults to the concatentation of "web\_domain" and cgi. - mirrors @gMirrors List of mirrors \[What these mirrors are used for, no one knows.\] - package\_pages $gPackagePages Domain where the package pages are kept; links should work in a package\_pages/foopackage manner. Defaults to undef, which means that package links will not be made. Should be prefixed with the appropriate protocol (http/https). - package\_tracking\_domain $gPackageTrackingDomain Domain where the package pages are kept; links should work in a package\_tracking\_domain/foopackage manner. Defaults to undef, which means that package links will not be made. Should be prefixed with the appropriate protocol (http or https). - package\_pages $gUsertagPackageDomain Domain where where usertags of packages belong; defaults to `$gPackagePages` - subscription\_domain $gSubscriptionDomain Domain where subscriptions to package lists happen - cc\_all\_mails\_to\_addr $gCcAllMailsToAddr Address to Cc (well, Bcc) all e-mails to - cve\_tracker $gCVETracker URI to CVE security tracker; in bugreport.cgi, CVE-2001-0002 becomes linked to `$config`{cve\_tracker}CVE-2001-002 Default: https://security-tracker.debian.org/tracker/ ### Project Identification - project $gProject Name of the project Default: 'Something' - project\_title $gProjectTitle Name of this install of Debbugs, defaults to ""project" Debbugs Install" Default: "$config{project} Debbugs Install" - maintainer $gMaintainer Name of the maintainer of this debbugs install Default: 'Local DebBugs Owner's - maintainer\_webpage $gMaintainerWebpage Webpage of the maintainer of this install of debbugs Default: "$config{web\_domain}/~owner" - maintainer\_email $gMaintainerEmail Email address of the maintainer of this Debbugs install Default: 'root@'.$config{email\_domain} - unknown\_maintainer\_email Email address where packages with an unknown maintainer will be sent Default: `$config`{maintainer\_email} - machine\_name The name of the machine that this instance of debbugs is running on (currently used for debbuging purposes and web page output.) Default: **Sys::Hostname::hostname()** ### BTS Mailing Lists - submit\_list - maint\_list - forward\_list - done\_list - request\_list - submitter\_list - control\_list - summary\_list - mirror\_list - strong\_list - bug\_subscription\_domain Domain of list for messages regarding a single bug; prefixed with bug=${bugnum}@ when bugs are actually sent out. Set to undef or '' to disable sending messages to the bug subscription list. Default: list\_domain ### Misc Options - mailer Name of the mailer to use Default: exim - bug Default: bug - ubug Default: ucfirst($config{bug}); - bugs Default: bugs - ubugs Default: ucfirst($config{ubugs}); - remove\_age Age at which bugs are archived/removed Default: 28 - save\_old\_bugs Whether old bugs are saved or deleted Default: 1 - distribution\_aliases Map of distribution aliases to the distribution name Default:\ {experimental =\> 'experimental',\ unstable =\> 'unstable',\ testing =\> 'testing',\ stable =\> 'stable',\ oldstable =\> 'oldstable',\ sid =\> 'unstable',\ lenny =\> 'testing',\ etch =\> 'stable',\ sarge =\> 'oldstable',\ } - distributions List of valid distributions Default: The values of the distribution aliases map. - default\_architectures List of default architectures to use when architecture(s) are not specified Default: i386 amd64 arm ppc sparc alpha - affects\_distribution\_tags List of tags which restrict the buggy state to a set of distributions. The set of distributions that are buggy is the intersection of the set of distributions that would be buggy without reference to these tags and the set of these tags that are distributions which are set on a bug. Setting this to \[\] will remove this feature. Default: @{$config{distributions}} - removal\_unremovable\_tags Bugs which have these tags set cannot be archived Default: \[\] - removal\_distribution\_tags Tags which specifiy distributions to check Default: @{$config{distributions}} - removal\_default\_distribution\_tags For removal/archival purposes, all bugs are assumed to have these tags set. Default: qw(experimental unstable testing); - removal\_strong\_severity\_default\_distribution\_tags For removal/archival purposes, all bugs with strong severity are assumed to have these tags set. Default: qw(experimental unstable testing stable); - removal\_architectures For removal/archival purposes, these architectures are consulted if there is more than one architecture applicable. If the bug is in a package not in any of these architectures, the architecture actually checked is undefined. Default: value of default\_architectures - package\_name\_re The regex which will match a package name Default: '\[a-z0-9\]\[a-z0-9\\.+-\]+' - package\_version\_re The regex which will match a package version Default: '\[A-Za-z0-9:+\\.-\]+' - default\_package This is the name of the default package. If set, bugs assigned to packages without a maintainer and bugs missing a Package: pseudoheader will be assigned to this package instead. Defaults to unset, which is the traditional debbugs behavoir - control\_internal\_requester This address is used by Debbugs::Control as the request address which sent a control request for faked log messages. Default:"Debbugs Internal Request \<$config{maintainer\_email}\>" - control\_internal\_request\_addr This address is used by Debbugs::Control as the address to which a faked log message request was sent. Default: "internal\_control\\@$config{email\_domain}"; - exclude\_from\_control Addresses which are not allowed to send messages to control - default\_severity The default severity of bugs which have no severity set Default: normal - severity\_display A hashref of severities and the informative text which describes them. Default: ``` {critical => "Critical $config{bugs}", grave => "Grave $config{bugs}", normal => "Normal $config{bugs}", wishlist => "Wishlist $config{bugs}", } ``` - show\_severities A scalar list of the severities to show Defaults to the concatenation of the keys of the severity\_display hashlist with ', ' above. - strong\_severities An arrayref of the serious severities which shoud be emphasized Default: \[qw(critical grave)\] - severity\_list An arrayref of a list of the severities Defaults to the keys of the severity display hashref - obsolete\_severities A hashref of obsolete severities with the replacing severity Default: {} - tags An arrayref of the tags used Default: \[qw(patch wontfix moreinfo unreproducible fixed)\] and also includes the distributions. - usertag\_dir Directory which contains the usertags Default: `$config`{spool\_dir}/user - web\_dir $gWebDir Directory where base html files are kept. Should normally be the same as the web server's document root. Default: /var/lib/debbugs/www - template\_dir directory of templates; defaults to /usr/share/debbugs/templates. - simple\_versioning If true this causes debbugs to ignore version information and just look at whether a bug is done or not done. Primarily of interest for debbugs installs which don't track versions. defaults to false. - version\_packages\_dir Location where the version package information is kept; defaults to spool\_dir/../versions/pkg - version\_time\_index Location of the version/time index file. Defaults to spool\_dir/../versions/idx/versions\_time.idx if spool\_dir/../versions exists; otherwise defaults to undef. - version\_index Location of the version index file. Defaults to spool\_dir/../versions/indices/versions.idx if spool\_dir/../versions exists; otherwise defaults to undef. - binary\_source\_map Location of the binary -\> source map. Defaults to spool\_dir/../versions/indices/bin2src.idx if spool\_dir/../versions exists; otherwise defaults to undef. - source\_binary\_map Location of the source -\> binary map. Defaults to spool\_dir/../versions/indices/src2bin.idx if spool\_dir/../versions exists; otherwise defaults to undef. - sendmail Sets the sendmail binary to execute; defaults to /usr/lib/sendmail - sendmail\_arguments Default arguments to pass to sendmail. Defaults to `"qw(-oem -oi)"`. - envelope\_from Envelope from to use for sent messages. If not set, whatever sendmail picks is used. - spam\_scan Whether or not spamscan is being used; defaults to 0 (not being used - spam\_crossassassin\_db Location of the crosassassin database, defaults to spool\_dir/../CrossAssassinDb - spam\_max\_cross Maximum number of cross-posted messages - spam\_spams\_per\_thread Number of spams for each thread (on average). Defaults to 200 - spam\_max\_threads Maximum number of threads to start. Defaults to 20 - spam\_keep\_running Maximum number of seconds to run without restarting. Defaults to 3600. - spam\_mailbox Location to store spam messages; is run through strftime to allow for `%d`,%m,%Y, et al. Defaults to 'spool\_dir/../mail/spam/assassinated.%Y-%m-%d' - spam\_crossassassin\_mailbox Location to store crossassassinated messages; is run through strftime to allow for `%d`,%m,%Y, et al. Defaults to 'spool\_dir/../mail/spam/crossassassinated.%Y-%m-%d' - spam\_local\_tests\_only Whether only local tests are run, defaults to 0 - spam\_user\_prefs User preferences for spamassassin, defaults to `$ENV`{HOME}/.spamassassin/user\_prefs - spam\_rules\_dir Site rules directory for spamassassin, defaults to '/etc/spamassassin' ### CGI Options - libravatar\_uri $gLibravatarUri URI to a libravatar configuration. If empty or undefined, libravatar support will be disabled. Defaults to libravatar.cgi, our internal federated libravatar system. - libravatar\_uri\_options $gLibravatarUriOptions Options to append to the md5\_hex of the e-mail. This sets the default avatar used when an avatar isn't available. Currently defaults to '?d=retro', which causes a bitmap-looking avatar to be displayed for unknown e-mails. Other options which make sense include ?d=404, ?d=wavatar, etc. See the API of libravatar for details. - libravatar\_default\_image Default image to serve for libravatar if there is no avatar for an e-mail address. By default, this is a 1x1 png. \[This will also be the image served if someone specifies avatar=no.\] Default: `$config`{web\_dir}/1x1.png - libravatar\_cache\_dir Directory where cached libravatar images are stored Default: `$config`{web\_dir}/libravatar/ - libravatar\_blacklist Array of regular expressions to match against emails, domains, or images to only show the default image Default: empty array ### Text Fields The following are the only text fields in general use in the scripts; a few additional text fields are defined in text.in, but are only used in db2html and a few other specialty scripts. Earlier versions of debbugs defined these values in /etc/debbugs/text, but now they are required to be in the configuration file. \[Eventually the longer ones will move out into a fully fledged template system.\] - bad\_email\_prefix This prefixes the text of all lines in a bad e-mail message ack. - text\_instructions This gives more information about bad e-mails to receive.in - html\_tail This shows up at the end of (most) html pages In many pages this has been replaced by the html/tail template. - html\_expire\_note This message explains what happens to archive/remove-able bugs