.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "Debbugs::Config 3pm" .TH Debbugs::Config 3pm "2010-08-06" "perl v5.10.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Debbugs::Config \-\- Configuration information for debbugs .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 1 \& use Debbugs::Config; .Ve .PP # to get the compatiblity interface .PP .Vb 1 \& use Debbugs::Config qw(:globals); .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" This module provides configuration variables for all of debbugs. .SH "CONFIGURATION FILES" .IX Header "CONFIGURATION FILES" The default configuration file location is /etc/debbugs/config; this configuration file location can be set by modifying the \&\s-1DEBBUGS_CONFIG_FILE\s0 env variable to point at a different location. .SH "CONFIGURATION VARIABLES" .IX Header "CONFIGURATION VARIABLES" .SS "General Configuration" .IX Subsection "General Configuration" .ie n .IP "email_domain $gEmailDomain" 4 .el .IP "email_domain \f(CW$gEmailDomain\fR" 4 .IX Item "email_domain $gEmailDomain" The email domain of the bts .ie n .IP "list_domain $gListDomain" 4 .el .IP "list_domain \f(CW$gListDomain\fR" 4 .IX Item "list_domain $gListDomain" The list domain of the bts, defaults to the email domain .ie n .IP "web_host $gWebHost" 4 .el .IP "web_host \f(CW$gWebHost\fR" 4 .IX Item "web_host $gWebHost" The web host of the bts; defaults to the email domain .ie n .IP "web_host_bug_dir $gWebHostDir" 4 .el .IP "web_host_bug_dir \f(CW$gWebHostDir\fR" 4 .IX Item "web_host_bug_dir $gWebHostDir" The directory of the web host on which bugs are kept, defaults to \f(CW\*(Aq\*(Aq\fR .ie n .IP "web_domain $gWebDomain" 4 .el .IP "web_domain \f(CW$gWebDomain\fR" 4 .IX Item "web_domain $gWebDomain" Full path of the web domain where bugs are kept, defaults to the concatenation of \*(L"web_host\*(R" and \*(L"web_host_bug_dir\*(R" .ie n .IP "html_suffix $gHTMLSuffix" 4 .el .IP "html_suffix \f(CW$gHTMLSuffix\fR" 4 .IX Item "html_suffix $gHTMLSuffix" Suffix of html pages, defaults to .html .ie n .IP "cgi_domain $gCGIDomain" 4 .el .IP "cgi_domain \f(CW$gCGIDomain\fR" 4 .IX Item "cgi_domain $gCGIDomain" Full path of the web domain where cgi scripts are kept. Defaults to the concatentation of \*(L"web_host\*(R" and cgi. .ie n .IP "mirrors @gMirrors" 4 .el .IP "mirrors \f(CW@gMirrors\fR" 4 .IX Item "mirrors @gMirrors" List of mirrors [What these mirrors are used for, no one knows.] .ie n .IP "package_pages $gPackagePages" 4 .el .IP "package_pages \f(CW$gPackagePages\fR" 4 .IX Item "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. .ie n .IP "package_pages $gUsertagPackageDomain" 4 .el .IP "package_pages \f(CW$gUsertagPackageDomain\fR" 4 .IX Item "package_pages $gUsertagPackageDomain" Domain where where usertags of packages belong; defaults to \f(CW$gPackagePages\fR .ie n .IP "subscription_domain $gSubscriptionDomain" 4 .el .IP "subscription_domain \f(CW$gSubscriptionDomain\fR" 4 .IX Item "subscription_domain $gSubscriptionDomain" Domain where subscriptions to package lists happen .ie n .IP "cve_tracker $gCVETracker" 4 .el .IP "cve_tracker \f(CW$gCVETracker\fR" 4 .IX Item "cve_tracker $gCVETracker" \&\s-1URI\s0 to \s-1CVE\s0 security tracker; in bugreport.cgi, \s-1CVE\-2001\-0002\s0 becomes linked to http://$config{cve_tracker}CVE\-2001\-002 .Sp Default: security\-tracker.debian.org/tracker/ .SS "Project Identification" .IX Subsection "Project Identification" .ie n .IP "project $gProject" 4 .el .IP "project \f(CW$gProject\fR" 4 .IX Item "project $gProject" Name of the project .Sp Default: 'Something' .ie n .IP "project_title $gProjectTitle" 4 .el .IP "project_title \f(CW$gProjectTitle\fR" 4 .IX Item "project_title $gProjectTitle" Name of this install of Debbugs, defaults to "\*(L"project\*(R" Debbugs Install" .Sp Default: \*(L"$config{project} Debbugs Install\*(R" .ie n .IP "maintainer $gMaintainer" 4 .el .IP "maintainer \f(CW$gMaintainer\fR" 4 .IX Item "maintainer $gMaintainer" Name of the maintainer of this debbugs install .Sp Default: 'Local DebBugs Owner's .ie n .IP "maintainer_webpage $gMaintainerWebpage" 4 .el .IP "maintainer_webpage \f(CW$gMaintainerWebpage\fR" 4 .IX Item "maintainer_webpage $gMaintainerWebpage" Webpage of the maintainer of this install of debbugs .Sp Default: \*(L"$config{web_domain}/~owner\*(R" .ie n .IP "maintainer_email $gMaintainerEmail" 4 .el .IP "maintainer_email \f(CW$gMaintainerEmail\fR" 4 .IX Item "maintainer_email $gMaintainerEmail" Email address of the maintainer of this Debbugs install .Sp Default: 'root@'.$config{email_domain} .IP "unknown_maintainer_email" 4 .IX Item "unknown_maintainer_email" Email address where packages with an unknown maintainer will be sent .Sp Default: \f(CW$config\fR{maintainer_email} .IP "machine_name" 4 .IX Item "machine_name" The name of the machine that this instance of debbugs is running on (currently used for debbuging purposes and web page output.) .Sp Default: qx(hostname \-\-fqdn) .SS "\s-1BTS\s0 Mailing Lists" .IX Subsection "BTS Mailing Lists" .IP "submit_list" 4 .IX Item "submit_list" .PD 0 .IP "maint_list" 4 .IX Item "maint_list" .IP "forward_list" 4 .IX Item "forward_list" .IP "done_list" 4 .IX Item "done_list" .IP "request_list" 4 .IX Item "request_list" .IP "submitter_list" 4 .IX Item "submitter_list" .IP "control_list" 4 .IX Item "control_list" .IP "summary_list" 4 .IX Item "summary_list" .IP "mirror_list" 4 .IX Item "mirror_list" .IP "strong_list" 4 .IX Item "strong_list" .IP "bug_subscription_domain" 4 .IX Item "bug_subscription_domain" .PD 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. .Sp Default: list_domain .SS "Misc Options" .IX Subsection "Misc Options" .IP "mailer" 4 .IX Item "mailer" Name of the mailer to use .Sp Default: exim .IP "bug" 4 .IX Item "bug" Default: bug .IP "ubug" 4 .IX Item "ubug" Default: ucfirst($config{bug}); .IP "bugs" 4 .IX Item "bugs" Default: bugs .IP "ubugs" 4 .IX Item "ubugs" Default: ucfirst($config{ubugs}); .IP "remove_age" 4 .IX Item "remove_age" Age at which bugs are archived/removed .Sp Default: 28 .IP "save_old_bugs" 4 .IX Item "save_old_bugs" Whether old bugs are saved or deleted .Sp Default: 1 .IP "distribution_aliases" 4 .IX Item "distribution_aliases" Map of distribution aliases to the distribution name .Sp Default: {experimental => 'experimental', unstable => 'unstable', testing => 'testing', stable => 'stable', oldstable => 'oldstable', sid => 'unstable', lenny => 'testing', etch => 'stable', sarge => 'oldstable', } .IP "distributions" 4 .IX Item "distributions" List of valid distributions .Sp Default: The values of the distribution aliases map. .IP "default_architectures" 4 .IX Item "default_architectures" List of default architectures to use when architecture(s) are not specified .Sp Default: i386 amd64 arm ppc sparc alpha .IP "affects_distribution_tags" 4 .IX Item "affects_distribution_tags" List of tags which restrict the buggy state to a set of distributions. .Sp 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. .Sp Setting this to [] will remove this feature. .Sp Default: @{$config{distributions}} .IP "removal_unremovable_tags" 4 .IX Item "removal_unremovable_tags" Bugs which have these tags set cannot be archived .Sp Default: [] .IP "removal_distribution_tags" 4 .IX Item "removal_distribution_tags" Tags which specifiy distributions to check .Sp Default: @{$config{distributions}} .IP "removal_default_distribution_tags" 4 .IX Item "removal_default_distribution_tags" For removal/archival purposes, all bugs are assumed to have these tags set. .Sp Default: qw(unstable testing); .IP "removal_strong_severity_default_distribution_tags" 4 .IX Item "removal_strong_severity_default_distribution_tags" For removal/archival purposes, all bugs with strong severity are assumed to have these tags set. .Sp Default: qw(unstable testing stable); .IP "removal_architectures" 4 .IX Item "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. .Sp Default: value of default_architectures .IP "package_name_re" 4 .IX Item "package_name_re" The regex which will match a package name .Sp Default: '[a\-z0\-9][a\-z0\-9\e.+\-]+' .IP "package_version_re" 4 .IX Item "package_version_re" The regex which will match a package version .Sp Default: '[A\-Za\-z0\-9:+\e.\-]+' .IP "default_package" 4 .IX Item "default_package" This is the name of the default package. If set, bugs assigned to packages without a maintainer and bugs missing a Package: psuedoheader will be assigned to this package instead. .Sp Defaults to unset, which is the traditional debbugs behavoir .IP "control_internal_requester" 4 .IX Item "control_internal_requester" This address is used by Debbugs::Control as the request address which sent a control request for faked log messages. .Sp Default:\*(L"Debbugs Internal Request <$config{maintainer_email}>\*(R" .IP "control_internal_request_addr" 4 .IX Item "control_internal_request_addr" This address is used by Debbugs::Control as the address to which a faked log message request was sent. .Sp Default: \*(L"internal_control\e@$config{email_domain}\*(R"; .IP "exclude_from_control" 4 .IX Item "exclude_from_control" Addresses which are not allowed to send messages to control .IP "default_severity" 4 .IX Item "default_severity" The default severity of bugs which have no severity set .Sp Default: normal .IP "severity_display" 4 .IX Item "severity_display" A hashref of severities and the informative text which describes them. .Sp Default: .Sp .Vb 5 \& {critical => "Critical $config{bugs}", \& grave => "Grave $config{bugs}", \& normal => "Normal $config{bugs}", \& wishlist => "Wishlist $config{bugs}", \& } .Ve .IP "show_severities" 4 .IX Item "show_severities" A scalar list of the severities to show .Sp Defaults to the concatenation of the keys of the severity_display hashlist with ', ' above. .IP "strong_severities" 4 .IX Item "strong_severities" An arrayref of the serious severities which shoud be emphasized .Sp Default: [qw(critical grave)] .IP "severity_list" 4 .IX Item "severity_list" An arrayref of a list of the severities .Sp Defaults to the keys of the severity display hashref .IP "obsolete_severities" 4 .IX Item "obsolete_severities" A hashref of obsolete severities with the replacing severity .Sp Default: {} .IP "tags" 4 .IX Item "tags" An arrayref of the tags used .Sp Default: [qw(patch wontfix moreinfo unreproducible fixed)] and also includes the distributions. .IP "usertag_dir" 4 .IX Item "usertag_dir" Directory which contains the usertags .Sp Default: \f(CW$config\fR{spool_dir}/user .IP "template_dir" 4 .IX Item "template_dir" directory of templates; defaults to /usr/share/debbugs/templates. .IP "simple_versioning" 4 .IX Item "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. .IP "version_packages_dir" 4 .IX Item "version_packages_dir" Location where the version package information is kept; defaults to spool_dir/../versions/pkg .IP "version_time_index" 4 .IX Item "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. .IP "version_index" 4 .IX Item "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. .IP "binary_source_map" 4 .IX Item "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. .IP "source_binary_map" 4 .IX Item "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. .IP "sendmail" 4 .IX Item "sendmail" Sets the sendmail binary to execute; defaults to /usr/lib/sendmail .IP "sendmail_arguments" 4 .IX Item "sendmail_arguments" Default arguments to pass to sendmail. Defaults to \f(CW\*(C`qw(\-oem \-oi)\*(C'\fR. .IP "spam_scan" 4 .IX Item "spam_scan" Whether or not spamscan is being used; defaults to 0 (not being used .IP "spam_crossassassin_db" 4 .IX Item "spam_crossassassin_db" Location of the crosassassin database, defaults to spool_dir/../CrossAssassinDb .IP "spam_max_cross" 4 .IX Item "spam_max_cross" Maximum number of cross-posted messages .IP "spam_spams_per_thread" 4 .IX Item "spam_spams_per_thread" Number of spams for each thread (on average). Defaults to 200 .IP "spam_max_threads" 4 .IX Item "spam_max_threads" Maximum number of threads to start. Defaults to 20 .IP "spam_keep_running" 4 .IX Item "spam_keep_running" Maximum number of seconds to run without restarting. Defaults to 3600. .IP "spam_mailbox" 4 .IX Item "spam_mailbox" Location to store spam messages; is run through strftime to allow for \&\f(CW%d\fR,%m,%Y, et al. Defaults to 'spool_dir/../mail/spam/assassinated.%Y\-%m\-%d' .IP "spam_crossassassin_mailbox" 4 .IX Item "spam_crossassassin_mailbox" Location to store crossassassinated messages; is run through strftime to allow for \f(CW%d\fR,%m,%Y, et al. Defaults to \&'spool_dir/../mail/spam/crossassassinated.%Y\-%m\-%d' .IP "spam_local_tests_only" 4 .IX Item "spam_local_tests_only" Whether only local tests are run, defaults to 0 .IP "spam_user_prefs" 4 .IX Item "spam_user_prefs" User preferences for spamassassin, defaults to \f(CW$ENV\fR{\s-1HOME\s0}/.spamassassin/user_prefs .IP "spam_rules_dir" 4 .IX Item "spam_rules_dir" Site rules directory for spamassassin, defaults to \&'/usr/share/spamassassin' .SS "Text Fields" .IX Subsection "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. .PP 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.] .IP "bad_email_prefix" 4 .IX Item "bad_email_prefix" This prefixes the text of all lines in a bad e\-mail message ack. .IP "text_instructions" 4 .IX Item "text_instructions" This gives more information about bad e\-mails to receive.in .IP "html_tail" 4 .IX Item "html_tail" This shows up at the end of (most) html pages .Sp In many pages this has been replaced by the html/tail template. .IP "html_expire_note" 4 .IX Item "html_expire_note" This message explains what happens to archive/remove\-able bugs