debian/masqmail-debian

annotate masqmail.templates @ 4:bf717cdae8fc

fixed lintian warnings; adjusted lintian overrides
author meillo@marmaro.de
date Wed, 05 Nov 2008 11:42:05 +0100
parents 5ef519035828
children d77a7b699b6d
rev   line source
meillo@0 1 Template: masqmail/manage_config_with_debconf
meillo@0 2 Type: boolean
meillo@0 3 Default: true
meillo@0 4 _Description: Manage masqmail.conf using debconf?
meillo@0 5 The /etc/masqmail/masqmail.conf file can be handled automatically
meillo@0 6 by debconf, or manually by you.
meillo@0 7 .
meillo@0 8 Note that only specific, marked sections of the configuration file will be
meillo@0 9 handled by debconf if you select this option; if those markers are absent,
meillo@0 10 you will have to update the file manually, or move or delete the file.
meillo@0 11
meillo@0 12 Template: masqmail/move_existing_nondebconf_config
meillo@0 13 Type: boolean
meillo@0 14 Default: false
meillo@0 15 _Description: Replace existing /etc/masqmail/masqmail.conf file?
meillo@0 16 The existing /etc/masqmail/masqmail.conf file currently on the system does
meillo@0 17 not contain a marked section for debconf to write its data.
meillo@0 18 .
meillo@0 19 If you select this option, the existing configuration
meillo@0 20 file will be backed up to /etc/masqmail/masqmail.conf.debconf-backup and a
meillo@0 21 new file written to /etc/masqmail/masqmail.conf. If you do not select this
meillo@0 22 option, the existing configuration file will not be managed by debconf,
meillo@0 23 and no further questions about masqmail configuration will be
meillo@0 24 asked.
meillo@0 25
meillo@0 26 Template: masqmail/host_name
meillo@0 27 Type: string
meillo@0 28 Default:
meillo@0 29 _Description: Masqmail host name:
meillo@0 30 Please enter the name used by masqmail to identify itself to others.
meillo@0 31 This is most likely your hostname. It is used in its SMTP greeting
meillo@0 32 banner, for expanding unqualified addresses, the Message ID and so on.
meillo@0 33
meillo@0 34 Template: masqmail/local_hosts
meillo@0 35 Type: string
meillo@0 36 _Description: Hosts considered local:
meillo@0 37 Please enter a list of hosts, separated with semicolons (;), which are
meillo@0 38 considered 'local', ie. mail to these hosts will be delivered to a
meillo@0 39 mailbox (or Maildir or MDA) on this host.
meillo@0 40 .
meillo@0 41 You will most likely insert 'localhost', your hostname in its fully
meillo@0 42 qualified form and just the simple hostname here.
meillo@0 43 .
meillo@0 44 You can also use wildcard expressions like '*' and '?'.
meillo@0 45
meillo@0 46 Template: masqmail/local_nets
meillo@0 47 Type: string
meillo@0 48 _Description: Nets considered local:
meillo@0 49 Please enter a list of hosts, separated with semicolons (;), which are
meillo@0 50 on your local network, ie. they are always reachable, without a
meillo@0 51 dialup connection. Mail to these hosts will be delivered immediately,
meillo@0 52 without checking for the online status.
meillo@0 53 .
meillo@4 54 You can use wildcard expressions like '*' and '?', eg. *.yournet.local
meillo@0 55 .
meillo@0 56 If you have only one box, you can leave this empty. If you do not want
meillo@0 57 to use masqmail as an offline MTA, and the whole internet or another mail
meillo@0 58 server which accepts outgoing mail is at all times
meillo@0 59 reachable to you, just insert '*'.
meillo@0 60
meillo@0 61 Template: masqmail/listen_addresses
meillo@0 62 Type: string
meillo@0 63 Default: localhost:25
meillo@0 64 _Description: Interfaces for incoming connections:
meillo@0 65 Masqmail, for security reasons, does not listen an all network
meillo@0 66 interfaces by default. If there are no other hosts connected to your
meillo@0 67 host, just leave the default 'localhost:25' value. If there are other
meillo@0 68 hosts that may want to send SMTP messages to this host, add the
meillo@0 69 address of your network interface here, eg.:
meillo@0 70 localhost:25;192.168.1.2:25.
meillo@0 71 .
meillo@0 72 Of course you can also replace the '25' with another port number, however
meillo@0 73 this is unusual.
meillo@0 74
meillo@0 75 Template: masqmail/use_syslog
meillo@0 76 Type: boolean
meillo@0 77 Default: false
meillo@0 78 _Description: Use syslogd for logs?
meillo@0 79 You can decide whether masqmail should log via syslog or not. If not,
meillo@0 80 logs will be written to /var/log/masqmail/masqmail.log.
meillo@0 81
meillo@0 82 Template: masqmail/online_detect
meillo@0 83 Type: select
meillo@0 84 __Choices: file, pipe
meillo@0 85 Default: file
meillo@0 86 _Description: Online detection method:
meillo@0 87 Masqmail has different methods to determine whether it is online or not,
meillo@0 88 these are 'file','pipe'.
meillo@0 89 .
meillo@0 90 For 'file', masqmail checks for the existence of a file, and, if it
meillo@0 91 exists, reads from it the name of the connection.
meillo@0 92 .
meillo@0 93 For 'pipe', masqmail calls a program or script, which outputs the name
meillo@0 94 if online or nothing if not. You can use eg. the program guessnet for this.
meillo@0 95
meillo@0 96 Template: masqmail/online_file
meillo@0 97 Type: string
meillo@0 98 Default: /var/run/masqmail-route
meillo@0 99 _Description: File used to determine the online status:
meillo@0 100
meillo@0 101 Template: masqmail/online_pipe
meillo@0 102 Type: string
meillo@0 103 Default:
meillo@0 104 _Description: Name of the program used to determine the online status:
meillo@0 105 Please choose the program to use to determine the online
meillo@0 106 status. Please note that, when this program is called, masqmail has
meillo@0 107 the user id 'mail'.
meillo@0 108
meillo@0 109 Template: masqmail/mbox_default
meillo@0 110 Type: select
meillo@0 111 Choices: mbox, mda, maildir
meillo@0 112 Default: mbox
meillo@0 113 _Description: Local delivery style:
meillo@0 114 Local mail can be delivered to a mailbox, to an MDA (eg. procmail)
meillo@0 115 or to a qmail style Maildir in the users home dir.
meillo@0 116 .
meillo@0 117 You can select the default style here. You can configure this also
meillo@0 118 on a per-user basis with the options mbox_users, mda_users and
meillo@0 119 maildir_users.
meillo@0 120
meillo@0 121 Template: masqmail/mda
meillo@0 122 Type: string
meillo@0 123 Default: /usr/bin/procmail -Y -d ${rcpt_local}
meillo@0 124 _Description: MDA command line (including options):
meillo@0 125 Please choose the path to the mail delivery agent (MDA), including
meillo@0 126 its arguments. You can use substitution values here,
meillo@0 127 eg. ${rcpt_local} for the user name.
meillo@0 128 .
meillo@0 129 For other substitutions please see the man page.
meillo@0 130 .
meillo@0 131 This question is also asked if you did not set mbox_default to mda,
meillo@0 132 since you can use mda for a set of users specially.
meillo@0 133
meillo@0 134 Template: masqmail/alias_local_caseless
meillo@0 135 Type: boolean
meillo@0 136 Default: false
meillo@4 137 _Description: Should alias expansion regard case?
meillo@0 138 Masqmail uses the file /etc/aliases to redirect local addresses.
meillo@0 139 The search for a match in /etc/aliases can be regarding upper/lower
meillo@0 140 case or insensitive to case.
meillo@0 141
meillo@0 142 Template: masqmail/init_smtp_daemon
meillo@0 143 Type: boolean
meillo@0 144 Default: true
meillo@0 145 _Description: Start SMTP listening daemon?
meillo@0 146 Please choose whether you want masqmail to start as an SMTP listening
meillo@0 147 daemon. You will need this if:
meillo@0 148 - there are other hosts in your local network that may want to send
meillo@0 149 mail via this host
meillo@0 150 - you use a mail client that sends mail via SMTP (netscape,
meillo@0 151 mozilla are examples)
meillo@0 152
meillo@0 153 Template: masqmail/init_queue_daemon
meillo@0 154 Type: boolean
meillo@0 155 Default: true
meillo@0 156 _Description: Start SMTP queue running daemon?
meillo@0 157 Please choose this option if you want masqmail to start as a queue
meillo@0 158 running daemon. You're very likely to need this. It is used for mail
meillo@0 159 that cannot delivered immediately, either because of delivery
meillo@0 160 failures or because you were not online on the first attempt to send
meillo@0 161 a mail.
meillo@0 162
meillo@0 163 Template: masqmail/queue_daemon_ival
meillo@0 164 Type: string
meillo@0 165 Default: -q10m
meillo@0 166 _Description: Interval for the queue running daemon:
meillo@0 167 Please choose the interval for the queue running daemon. -q10m means
meillo@0 168 flush the queue every 10 minutes.
meillo@0 169 .
meillo@0 170 The format is -q, followed by an numeric value and one of the letters s,m,h,d,w for
meillo@0 171 seconds, minutes, hours, days or weeks respectively.
meillo@0 172 .
meillo@0 173 Reasonable values are between 5 minutes (-q5m) and 2 hours (-q2h).
meillo@0 174
meillo@0 175 Template: masqmail/init_fetch_daemon
meillo@0 176 Type: boolean
meillo@0 177 Default: false
meillo@0 178 _Description: Start POP3 fetch daemon?
meillo@0 179 Please choose this option if you want masqmail to start as a fetch
meillo@0 180 daemon. If you do so, masqmail will try to fetch mail from POP3
meillo@0 181 servers that you configure in regular intervals, detecting the online
meillo@0 182 status first.
meillo@0 183 .
meillo@0 184 No matter what you choose here, you can later select whether you want to fetch
meillo@0 185 mail the moment you get online.
meillo@0 186
meillo@0 187 Template: masqmail/fetch_daemon_ival
meillo@0 188 Type: string
meillo@0 189 Default: -go5m
meillo@0 190 _Description: Interval for the fetch daemon:
meillo@0 191 Please choose the interval for the fetch daemon.
meillo@0 192 .
meillo@0 193 The format is -go, followed by an numeric value and one of the letters s,m,h,d,w for
meillo@0 194 seconds, minutes, hours, days or weeks respectively.
meillo@0 195 .
meillo@0 196 Reasonable values are between 2 minutes (-go2m) and 2 hours (-go2h).
meillo@0 197
meillo@0 198 Template: masqmail/ipup_runqueue
meillo@0 199 Type: boolean
meillo@0 200 Default: true
meillo@0 201 _Description: Flush mail queue when you get online?
meillo@0 202 Please choose whether you want masqmail to immediately flush its mail
meillo@0 203 queue as soon as you go online. This will be done in the ip-up script
meillo@0 204 in /etc/ppp/ip-up or in /etc/network/if-up.d/.
meillo@0 205
meillo@0 206 Template: masqmail/ipup_fetch
meillo@0 207 Type: boolean
meillo@0 208 Default: false
meillo@0 209 _Description: Fetch mail when you get online?
meillo@0 210 Please choose whether you want masqmail to immediately fetch mail
meillo@0 211 from POP3 servers as soon as you go online. This will be done in the
meillo@0 212 ip-up script in /etc/ppp/ip-up or in /etc/network/if-up.d/.
meillo@0 213
meillo@0 214 Template: masqmail/ifup_ifaces
meillo@0 215 Type: string
meillo@0 216 Default: all
meillo@0 217 _Description: List of interfaces used for masqmail online detection:
meillo@0 218 Please choose a list of network interfaces which will trigger queue
meillo@0 219 runs and/or fetching mails when going up. The list will be used in
meillo@0 220 the /etc/ppp/ip-up and /etc/network/if-up.d/ scripts, when the
meillo@0 221 interface goes up.
meillo@0 222 .
meillo@0 223 A reasonable choice is eg. 'ppp0' for a desktop at home, or 'ppp0 eth0' for
meillo@0 224 a notebook.
meillo@0 225 .
meillo@0 226 Set to 'all' for all interfaces, or 'none' for no interfaces.
meillo@0 227