1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/debian/masqmail.templates	Fri Sep 26 17:05:23 2008 +0200
     1.3 @@ -0,0 +1,267 @@
     1.4 +Template: masqmail/note_moved_tpl
     1.5 +Type: note
     1.6 +Description: Failure notice templates have been moved
     1.7 + The delivery failure notices that lived in /etc/masqmail/tpl are now in
     1.8 + /usr/share/masqmail/tpl/.
     1.9 + .
    1.10 + You will notice this only if you have changed the location in
    1.11 + masqmail.conf or changed the templates.
    1.12 + .
    1.13 + Since they are no longer conffiles because of the move, you should
    1.14 + give a customized version another name, otherwise it will be
    1.15 + overwritten on the next upgrade.
    1.16 +
    1.17 +Template: masqmail/note_pcmcia_scripts
    1.18 +Type: note
    1.19 +Description: Removed executable bit in scripts in /etc/pcmcia/ip-{up,down}.d/
    1.20 + The scripts in /etc/pcmcia/ip-{up,down}.d/ are deprecated
    1.21 + and are replaced with the scripts /etc/network/if-{up,down}.d/1masqmail, which
    1.22 + will work for _any_ network card (not just pcmcia). The executable bit of the
    1.23 + old scripts has been removed, because otherwise they and the new scripts would be
    1.24 + exececuted, which is not desired.
    1.25 + .
    1.26 + You should remove these scripts from /etc/pcmcia/ip-{up,down}.d/. If you still want
    1.27 + to use them, just reset the executable bit.
    1.28 + .
    1.29 + Whatever you do, you will never see the note again.
    1.30 +
    1.31 +Template: masqmail/manage_config_with_debconf
    1.32 +Type: boolean
    1.33 +Default: true
    1.34 +Description: Manage masqmail.conf using debconf?
    1.35 + The /etc/masqmail/masqmail.conf file can be handled automatically
    1.36 + by debconf, or manually by you.
    1.37 + .
    1.38 + Note that only specific, marked sections of the configuration file will be
    1.39 + handled by debconf if you select this option; if those markers are absent,
    1.40 + you will have to update the file manually, or move or delete the file.
    1.41 +
    1.42 +Template: masqmail/move_existing_nondebconf_config
    1.43 +Type: boolean
    1.44 +Default: false
    1.45 +Description: Replace existing /etc/masqmail/masqmail.conf file?
    1.46 + The existing /etc/masqmail/masqmail.conf file currently on the system does
    1.47 + not contain a marked section for debconf to write its data.
    1.48 + .
    1.49 + If you select this option, the existing configuration
    1.50 + file will be backed up to /etc/masqmail/masqmail.conf.debconf-backup and a
    1.51 + new file written to /etc/masqmail/masqmail.conf.  If you do not select this
    1.52 + option, the existing configuration file will not be managed by debconf,
    1.53 + and no further questions about masqmail configuration will be
    1.54 + asked.
    1.55 +
    1.56 +Template: masqmail/host_name
    1.57 +Type: string
    1.58 +Default:
    1.59 +Description: The name with which masqmail identifies itself to others
    1.60 + This is most likely your hostname. It is used in its SMTP greeting
    1.61 + banner, for expanding unqualified addresses, the Message ID and so on.
    1.62 +
    1.63 +Template: masqmail/local_hosts
    1.64 +Type: string
    1.65 +Default:
    1.66 +Description: hosts considered local
    1.67 + This is a list of hosts, separated with semicolons (;), which are
    1.68 + considered 'local', ie. mail to this host will be delivered to a
    1.69 + mailbox (or Maildir or MDA) on this host.
    1.70 + .
    1.71 + You will most likely insert 'localhost', your hostname in its fully
    1.72 + qualified version, and just the simple hostname here.
    1.73 + .
    1.74 + You can also use wildcard expressions like '*' and '?'.
    1.75 +
    1.76 +Template: masqmail/local_nets
    1.77 +Type: string
    1.78 +Default:
    1.79 +Description: nets considered local, for immediate delivery attempts
    1.80 + This is a list of hosts, separated with semicolons (;), which are
    1.81 + on your local network, ie. they are always reachable, without a
    1.82 + dialup connection. Mail to these hosts will be delivered immediately,
    1.83 + without checking for the online status.
    1.84 + .
    1.85 + You can use wildcards expressions like '*' and '?', eg. *.yournet.local
    1.86 + .
    1.87 + If you have only one box, you can leave this empty. If you do not want
    1.88 + to use masqmail as an offline MTA, and the whole internet or another mail
    1.89 + server which accepts outgoing mail is all time
    1.90 + reachable to you, just insert '*'.
    1.91 +
    1.92 +Template: masqmail/listen_addresses
    1.93 +Type: string
    1.94 +Default: localhost:25
    1.95 +Description: accept connections on these interfaces
    1.96 + masqmail, for security reasons, does not listen an all network interfaces
    1.97 + by default. If there are no other hosts connected to your host, just leave
    1.98 + this 'localhost:25'. If there are other hosts that may want to send SMTP
    1.99 + messages to this host, add the address of you network interface here,
   1.100 + eg.: localhost:25;192.168.1.2:25.
   1.101 + .
   1.102 + Of course you can also replace the '25' with another port number, but
   1.103 + this is unusual.
   1.104 +
   1.105 +Template: masqmail/use_syslog
   1.106 +Type: boolean
   1.107 +Default: false
   1.108 +Description: use syslogd for logs?
   1.109 + You can decide whether masqmail should log via syslog or not. If not,
   1.110 + logs will be written to /var/log/masqmail/masqmail.log.
   1.111 +
   1.112 +Template: masqmail/online_detect
   1.113 +Type: select
   1.114 +Choices: file, pipe
   1.115 +Default: file
   1.116 +Description: the online detection method
   1.117 + masqmail has different methods to determine whether it is online or not,
   1.118 + these are 'file','pipe'.
   1.119 + .
   1.120 + For 'file', masqmail checks for the existence of a file, and, if it
   1.121 + exists, reads from it the name of the connection.
   1.122 + .
   1.123 + For 'pipe', masqmail calls a program or script, which outputs the name
   1.124 + if online or nothing if not. You can use eg. the program guessnet for this.
   1.125 +
   1.126 +Template: masqmail/online_file
   1.127 +Type: string
   1.128 +Default: /var/run/masqmail-route
   1.129 +Description: the name of the file to determine the online status
   1.130 +
   1.131 +Template: masqmail/online_pipe
   1.132 +Type: string
   1.133 +Default:
   1.134 +Description: the name of the program to determine the online status
   1.135 + Note that, when this program is called, masqmail has the user id 'mail'.
   1.136 +
   1.137 +Template: masqmail/mbox_default
   1.138 +Type: select
   1.139 +Choices: mbox, mda, maildir
   1.140 +Default: mbox
   1.141 +Description: local delivery style
   1.142 + Local mail can be delivered to a mailbox, to an MDA (eg. procmail)
   1.143 + or to a qmail style maildir in the users home dir.
   1.144 + .
   1.145 + You can select the default style here. You can configure this also
   1.146 + on a per-user basis with the options mbox_users, mda_users and
   1.147 + maildir_users.
   1.148 +
   1.149 +Template: masqmail/mda
   1.150 +Type: string
   1.151 +Default: /usr/bin/procmail -Y -d ${rcpt_local}
   1.152 +Description: The MDA command line including options
   1.153 + Give here the path to the mda, including its arguments. You can use
   1.154 + substitution values here, eg. ${rcpt_local} for the user name.
   1.155 + .
   1.156 + For other substitutions please see the man page.
   1.157 + .
   1.158 + (This question is also asked if you did not set mbox_default to mda,
   1.159 + since you can use mda for a set of users specially)
   1.160 +
   1.161 +Template: masqmail/alias_local_caseless
   1.162 +Type: boolean
   1.163 +Default: false
   1.164 +Description: Alias expansion regarding case or not
   1.165 + masqmail uses the file /etc/aliases to redirect local addresses.
   1.166 + The search for a match in /etc/aliases can be regarding upper/lower
   1.167 + case or insensitive to case.
   1.168 +
   1.169 +Template: masqmail/init_smtp_daemon
   1.170 +Type: boolean
   1.171 +Default: true
   1.172 +Description: Start SMTP listening daemon?
   1.173 + Select 'yes' if you want masqmail to start as an SMTP listening
   1.174 + daemon. You will need this if:
   1.175 + .
   1.176 + - there are other hosts in your local network that may want to send mail via this host
   1.177 + .
   1.178 + - you use a mail client that sends mail via SMTP (netscape, mozilla are examples)
   1.179 + .
   1.180 + If in doubt, select 'yes'.
   1.181 +
   1.182 +Template: masqmail/init_queue_daemon
   1.183 +Type: boolean
   1.184 +Default: true
   1.185 +Description: Start SMTP queue running daemon?
   1.186 + Select 'yes' if you want masqmail to start as a queue running daemon. You will
   1.187 + need this very likely. It is used for mail that cannot delivered immediately,
   1.188 + either because of delivery failures or because you were not online on
   1.189 + the first attempt to send a mail.
   1.190 + .
   1.191 + If in doubt, select 'yes'.
   1.192 +
   1.193 +Template: masqmail/queue_daemon_ival
   1.194 +Type: string
   1.195 +Default: -q10m
   1.196 +Description: The interval for the queue running daemon
   1.197 + Set the interval for the queue running daemon. -q10m means flush the queue every
   1.198 + 10 minutes.
   1.199 + .
   1.200 + The format is -q, followed by an numeric value and one of the letters s,m,h,d,w for
   1.201 + seconds, minutes, hours, days or weeks respectively.
   1.202 + .
   1.203 + Reasonable values are between 5 minutes (-q5m) and 2 hours (-q2h).
   1.204 +
   1.205 +Template: masqmail/init_fetch_daemon
   1.206 +Type: boolean
   1.207 +Default: false
   1.208 +Description: Start POP3 fetch daemon?
   1.209 + Select 'yes' if you want masqmail to start as a fetch daemon. If you say 'yes',
   1.210 + masqmail will try to fetch mail from pop servers that you configure in regular
   1.211 + intervals, detecting the online status first.
   1.212 + .
   1.213 + No matter what you choose here, you can later select whether you want to fetch
   1.214 + mail the moment you get online.
   1.215 +
   1.216 +Template: masqmail/fetch_daemon_ival
   1.217 +Type: string
   1.218 +Default: -go5m
   1.219 +Description: The interval for the fetch daemon
   1.220 + Set the interval for the fetch daemon. -go5m means try to fetch mail every
   1.221 + 5 minutes.
   1.222 + .
   1.223 + The format is -go, followed by an numeric value and one of the letters s,m,h,d,w for
   1.224 + seconds, minutes, hours, days or weeks respectively.
   1.225 + .
   1.226 + Reasonable values are between 2 minutes (-go2m) and 2 hours (-go2h).
   1.227 +
   1.228 +Template: masqmail/ipup_runqueue
   1.229 +Type: boolean
   1.230 +Default: true
   1.231 +Description: flush mail queue when you get online?
   1.232 + Select 'yes' if you want masqmail to immediately flush its mail queue as soon
   1.233 + as you go online. This will be done in the ip-up script in /etc/ppp/ip-up or
   1.234 + in /etc/network/if-up.d/.
   1.235 +
   1.236 +Template: masqmail/ipup_fetch
   1.237 +Type: boolean
   1.238 +Default: false
   1.239 +Description: fetch mail when you get online?
   1.240 + Select 'yes' if you want masqmail to immediately fetch mail from POP3
   1.241 + servers as soon as you go online. This will be done in the ip-up script
   1.242 + in /etc/ppp/ip-up or in /etc/network/if-up.d/.
   1.243 +
   1.244 +Template: masqmail/ifup_ifaces
   1.245 +Type: string
   1.246 +Default: all
   1.247 +Description: a list of interfaces used for masqmail online detection
   1.248 + Set this to a list of network interfaces. When any of those interfaces go
   1.249 + up, the current online status will be used for queue runs and/or fetching
   1.250 + mails. The list will be used in the /etc/ppp/ip-up and /etc/network/if-up.d/
   1.251 + scripts, when the interface goes up.
   1.252 + .
   1.253 + A reasonable choice is eg. 'ppp0' for a desktop at home, or 'ppp0 eth0' for
   1.254 + a notebook". If this is set to eg. 'ppp0', nothing happens if eth0 goes up.
   1.255 + .
   1.256 + Set to 'all' for all interfaces, or 'none' for no interfaces.
   1.257 +
   1.258 +Template: masqmail/you_are_not_finished
   1.259 +Type: note
   1.260 +Description: You are not finished
   1.261 + Although masqmail is not as feature rich as other MTAs like sendmail
   1.262 + or exim, this debconf does not (yet) do all configurations for you.
   1.263 + .
   1.264 + To make use of masqmail, you still have to create some sub configuration
   1.265 + files for sending mail to some ISP and/or to fetch mail. masqmail has
   1.266 + lots of man pages and examples which are hopefully clear enough to
   1.267 + explain to you how to do it.
   1.268 + .
   1.269 + You should start with the man pages masqmail.conf, masqmail.route
   1.270 + and masqmail.get.