debian/masqmail-debian

annotate masqmail.templates @ 34:56c0c6807b0e

as I said, the newest standards version is 3.8.4
author meillo@marmaro.de
date Mon, 08 Feb 2010 16:41:27 +0100
parents bf717cdae8fc
children
rev   line source
meillo@22 1 # These templates have been reviewed by the debian-l10n-english
meillo@22 2 # team
meillo@22 3 #
meillo@22 4 # If modifications/additions/rewording are needed, please ask
meillo@22 5 # debian-l10n-english@lists.debian.org for advice.
meillo@22 6 #
meillo@22 7 # Even minor modifications require translation updates and such
meillo@22 8 # changes should be coordinated with translators and reviewers.
meillo@22 9
meillo@0 10 Template: masqmail/manage_config_with_debconf
meillo@0 11 Type: boolean
meillo@0 12 Default: true
meillo@22 13 _Description: Manage masqmail.conf automatically?
meillo@22 14 The /etc/masqmail/masqmail.conf file can be handled automatically by
meillo@22 15 answering a few questions, or entirely manually by the local administrator.
meillo@0 16 .
meillo@0 17 Note that only specific, marked sections of the configuration file will be
meillo@22 18 managed this way if you choose this option; if those markers are missing,
meillo@22 19 you will have to update the file manually, or remove the file.
meillo@0 20
meillo@0 21 Template: masqmail/move_existing_nondebconf_config
meillo@0 22 Type: boolean
meillo@0 23 Default: false
meillo@0 24 _Description: Replace existing /etc/masqmail/masqmail.conf file?
meillo@0 25 The existing /etc/masqmail/masqmail.conf file currently on the system does
meillo@22 26 not contain a marked section for automatic configuration management.
meillo@0 27 .
meillo@22 28 If you choose this option, the existing configuration
meillo@0 29 file will be backed up to /etc/masqmail/masqmail.conf.debconf-backup and a
meillo@22 30 new file written to /etc/masqmail/masqmail.conf. If you do not choose this
meillo@22 31 option, the existing configuration file will not be managed automatically,
meillo@0 32 and no further questions about masqmail configuration will be
meillo@0 33 asked.
meillo@0 34
meillo@0 35 Template: masqmail/host_name
meillo@0 36 Type: string
meillo@0 37 Default:
meillo@0 38 _Description: Masqmail host name:
meillo@0 39 Please enter the name used by masqmail to identify itself to others.
meillo@22 40 This is most likely the machine's hostname. It is used in the SMTP
meillo@22 41 greetings banner and generated Message-ID fields, as well as for
meillo@22 42 expansion of unqualified addresses, and so on.
meillo@0 43
meillo@0 44 Template: masqmail/local_hosts
meillo@0 45 Type: string
meillo@0 46 _Description: Hosts considered local:
meillo@22 47 Please enter a list, separated with semicolons (;), of hosts which are
meillo@22 48 considered "local". Mail to these hosts will be delivered to a
meillo@0 49 mailbox (or Maildir or MDA) on this host.
meillo@0 50 .
meillo@22 51 You will most likely insert "localhost" as well as this host's fully
meillo@22 52 qualified name and short name.
meillo@0 53 .
meillo@22 54 You can also use wildcard expressions containing "*" and "?".
meillo@0 55
meillo@0 56 Template: masqmail/local_nets
meillo@0 57 Type: string
meillo@22 58 _Description: Networks considered local:
meillo@22 59 Please enter a list, separated with semicolons (;), of hosts which are
meillo@22 60 on the local network. That is, they should be always reachable, without a
meillo@0 61 dialup connection. Mail to these hosts will be delivered immediately,
meillo@0 62 without checking for the online status.
meillo@0 63 .
meillo@22 64 You can use wildcard expressions containing "*" and "?", for
meillo@22 65 instance "*.yournet.local".
meillo@0 66 .
meillo@22 67 That field can be left empty if this host is the only host on the
meillo@22 68 network. If you do not want
meillo@22 69 to use Masqmail as an offline MTA and all servers likely to receive
meillo@22 70 outbound mail from this host are always reachable, just use "*"
meillo@22 71 here.
meillo@0 72
meillo@0 73 Template: masqmail/listen_addresses
meillo@0 74 Type: string
meillo@0 75 Default: localhost:25
meillo@0 76 _Description: Interfaces for incoming connections:
meillo@22 77 For security reasons, Masqmail does not listen an all network
meillo@22 78 interfaces by default. If there are no other hosts connected to this
meillo@22 79 host, "localhost:25" is enough for local operation. If there are other
meillo@22 80 hosts that need to send SMTP mail to this host, you should add the
meillo@22 81 address of the relevant network interface, for instance
meillo@22 82 "localhost:25;192.168.1.2:25".
meillo@0 83
meillo@0 84 Template: masqmail/use_syslog
meillo@0 85 Type: boolean
meillo@0 86 Default: false
meillo@22 87 _Description: Use the system log daemon for logging?
meillo@22 88 Masqmail may log via the system log daemon (syslog) or use its
meillo@22 89 own custom logging in /var/log/masqmail/masqmail.log.
meillo@0 90
meillo@0 91 Template: masqmail/online_detect
meillo@0 92 Type: select
meillo@0 93 __Choices: file, pipe
meillo@0 94 Default: file
meillo@0 95 _Description: Online detection method:
meillo@22 96 Masqmail has two methods to determine whether it is online or not:
meillo@22 97 "file" and "pipe".
meillo@22 98 - With "file", it checks for the existence of a file. If it
meillo@22 99 exists, the name of the connection is read from that file.
meillo@22 100 - With "pipe", it calls a program or script, which outputs the name
meillo@22 101 if online or nothing if not. The "guessnet" program is a good
meillo@22 102 candidate for such use.
meillo@0 103
meillo@0 104 Template: masqmail/online_file
meillo@0 105 Type: string
meillo@0 106 Default: /var/run/masqmail-route
meillo@0 107 _Description: File used to determine the online status:
meillo@0 108
meillo@0 109 Template: masqmail/online_pipe
meillo@0 110 Type: string
meillo@0 111 Default:
meillo@0 112 _Description: Name of the program used to determine the online status:
meillo@0 113 Please choose the program to use to determine the online
meillo@22 114 status. This program is called with "mail" as user ID.
meillo@0 115
meillo@0 116 Template: masqmail/mbox_default
meillo@0 117 Type: select
meillo@0 118 Choices: mbox, mda, maildir
meillo@0 119 Default: mbox
meillo@0 120 _Description: Local delivery style:
meillo@22 121 Local mail can be delivered to a mailbox, to a mail delivery
meillo@22 122 agent (MDA) such as procmail
meillo@22 123 or to Maildir-style mailboxes in the users' home directories.
meillo@0 124 .
meillo@22 125 This choice affects the default delivery mechanism. It can be defined
meillo@22 126 on a per-user basis with the "mbox_users", "mda_users" and
meillo@22 127 "maildir_users" options.
meillo@0 128
meillo@0 129 Template: masqmail/mda
meillo@0 130 Type: string
meillo@0 131 Default: /usr/bin/procmail -Y -d ${rcpt_local}
meillo@0 132 _Description: MDA command line (including options):
meillo@0 133 Please choose the path to the mail delivery agent (MDA), including
meillo@22 134 its arguments. You can use variable substitution here,
meillo@22 135 such as ${rcpt_local} for the user name.
meillo@0 136 .
meillo@22 137 Masqmail's manual page describes all available variable substitutions.
meillo@0 138 .
meillo@22 139 This question is meaningful even when choosing another option than
meillo@22 140 MDA delivery, in case MDA is used for a restricted set of users.
meillo@0 141
meillo@0 142 Template: masqmail/alias_local_caseless
meillo@0 143 Type: boolean
meillo@0 144 Default: false
meillo@22 145 _Description: Should alias expansion be case sensitive?
meillo@0 146 Masqmail uses the file /etc/aliases to redirect local addresses.
meillo@22 147 The search for a match in /etc/aliases can be case sensitive or not.
meillo@0 148
meillo@0 149 Template: masqmail/init_smtp_daemon
meillo@0 150 Type: boolean
meillo@0 151 Default: true
meillo@0 152 _Description: Start SMTP listening daemon?
meillo@22 153 Please choose whether you want Masqmail to start as an SMTP listening
meillo@0 154 daemon. You will need this if:
meillo@22 155 - there are other hosts in the local network that may want to send
meillo@22 156 mail via this host;
meillo@22 157 - you use a local mail client that sends mail via SMTP.
meillo@0 158
meillo@0 159 Template: masqmail/init_queue_daemon
meillo@0 160 Type: boolean
meillo@0 161 Default: true
meillo@0 162 _Description: Start SMTP queue running daemon?
meillo@22 163 Please choose this option if you want Masqmail to start as a queue
meillo@0 164 running daemon. You're very likely to need this. It is used for mail
meillo@0 165 that cannot delivered immediately, either because of delivery
meillo@22 166 failures or because the host is not online on the first attempt to send
meillo@0 167 a mail.
meillo@0 168
meillo@0 169 Template: masqmail/queue_daemon_ival
meillo@0 170 Type: string
meillo@0 171 Default: -q10m
meillo@0 172 _Description: Interval for the queue running daemon:
meillo@22 173 Please choose the interval for the queue running daemon.
meillo@0 174 .
meillo@22 175 The format is "-q", followed by a numeric value and one of the letters
meillo@22 176 s, m, h, d, or w, for seconds, minutes, hours, days, or weeks,
meillo@22 177 respectively. For instance, "-q10m" defines a ten-minute interval
meillo@22 178 between runs.
meillo@0 179 .
meillo@22 180 Reasonable values are between five minutes (-q5m) and two hours (-q2h).
meillo@0 181
meillo@0 182 Template: masqmail/init_fetch_daemon
meillo@0 183 Type: boolean
meillo@0 184 Default: false
meillo@0 185 _Description: Start POP3 fetch daemon?
meillo@22 186 Please choose this option if you want Masqmail to start as a fetch
meillo@22 187 daemon. If you do so, it will try to fetch mail from configured POP3
meillo@22 188 servers, detecting the online
meillo@0 189 status first.
meillo@0 190 .
meillo@0 191 No matter what you choose here, you can later select whether you want to fetch
meillo@22 192 mail when the host becomes online.
meillo@0 193
meillo@0 194 Template: masqmail/fetch_daemon_ival
meillo@0 195 Type: string
meillo@0 196 Default: -go5m
meillo@0 197 _Description: Interval for the fetch daemon:
meillo@0 198 Please choose the interval for the fetch daemon.
meillo@0 199 .
meillo@22 200 The format is "-go", followed by a numeric value and one of the letters
meillo@22 201 s, m, h, d, or w, for seconds, minutes, hours, days, or weeks,
meillo@22 202 respectively.
meillo@0 203 .
meillo@22 204 Reasonable values are between two minutes (-go2m) and two hours (-go2h).
meillo@0 205
meillo@0 206 Template: masqmail/ipup_runqueue
meillo@0 207 Type: boolean
meillo@0 208 Default: true
meillo@22 209 _Description: Flush mail queue when online?
meillo@22 210 Please choose whether you want Masqmail to immediately flush its mail
meillo@22 211 queue as soon as the host comes online. This will be done by Masqmail's
meillo@22 212 ip-up script
meillo@0 213 in /etc/ppp/ip-up or in /etc/network/if-up.d/.
meillo@0 214
meillo@0 215 Template: masqmail/ipup_fetch
meillo@0 216 Type: boolean
meillo@0 217 Default: false
meillo@22 218 _Description: Fetch mail when online?
meillo@22 219 Please choose whether you want Masqmail to immediately fetch mail
meillo@22 220 from POP3 servers as soon as the host comes online. This will be done
meillo@22 221 by Masqmail's ip-up script in /etc/ppp/ip-up or in /etc/network/if-up.d/.
meillo@0 222
meillo@0 223 Template: masqmail/ifup_ifaces
meillo@0 224 Type: string
meillo@0 225 Default: all
meillo@22 226 _Description: List of interfaces used for Masqmail online detection:
meillo@0 227 Please choose a list of network interfaces which will trigger queue
meillo@0 228 runs and/or fetching mails when going up. The list will be used in
meillo@0 229 the /etc/ppp/ip-up and /etc/network/if-up.d/ scripts, when the
meillo@0 230 interface goes up.
meillo@0 231 .
meillo@22 232 A reasonable choice is for instance "ppp0" for a home computer connected
meillo@22 233 by PPP or "ppp0 eth0" for
meillo@0 234 a notebook.
meillo@0 235 .
meillo@22 236 Other possible choices are "all" to listen on all network interfaces, or
meillo@22 237 "none" for not listening on any interface.
meillo@0 238