masqmail-0.2

view debian/masqmail.templates @ 0:08114f7dcc23

this is masqmail-0.2.21 from oliver kurth
author meillo@marmaro.de
date Fri, 26 Sep 2008 17:05:23 +0200
parents
children af25f5c39d90
line source
1 Template: masqmail/note_moved_tpl
2 Type: note
3 Description: Failure notice templates have been moved
4 The delivery failure notices that lived in /etc/masqmail/tpl are now in
5 /usr/share/masqmail/tpl/.
6 .
7 You will notice this only if you have changed the location in
8 masqmail.conf or changed the templates.
9 .
10 Since they are no longer conffiles because of the move, you should
11 give a customized version another name, otherwise it will be
12 overwritten on the next upgrade.
14 Template: masqmail/note_pcmcia_scripts
15 Type: note
16 Description: Removed executable bit in scripts in /etc/pcmcia/ip-{up,down}.d/
17 The scripts in /etc/pcmcia/ip-{up,down}.d/ are deprecated
18 and are replaced with the scripts /etc/network/if-{up,down}.d/1masqmail, which
19 will work for _any_ network card (not just pcmcia). The executable bit of the
20 old scripts has been removed, because otherwise they and the new scripts would be
21 exececuted, which is not desired.
22 .
23 You should remove these scripts from /etc/pcmcia/ip-{up,down}.d/. If you still want
24 to use them, just reset the executable bit.
25 .
26 Whatever you do, you will never see the note again.
28 Template: masqmail/manage_config_with_debconf
29 Type: boolean
30 Default: true
31 Description: Manage masqmail.conf using debconf?
32 The /etc/masqmail/masqmail.conf file can be handled automatically
33 by debconf, or manually by you.
34 .
35 Note that only specific, marked sections of the configuration file will be
36 handled by debconf if you select this option; if those markers are absent,
37 you will have to update the file manually, or move or delete the file.
39 Template: masqmail/move_existing_nondebconf_config
40 Type: boolean
41 Default: false
42 Description: Replace existing /etc/masqmail/masqmail.conf file?
43 The existing /etc/masqmail/masqmail.conf file currently on the system does
44 not contain a marked section for debconf to write its data.
45 .
46 If you select this option, the existing configuration
47 file will be backed up to /etc/masqmail/masqmail.conf.debconf-backup and a
48 new file written to /etc/masqmail/masqmail.conf. If you do not select this
49 option, the existing configuration file will not be managed by debconf,
50 and no further questions about masqmail configuration will be
51 asked.
53 Template: masqmail/host_name
54 Type: string
55 Default:
56 Description: The name with which masqmail identifies itself to others
57 This is most likely your hostname. It is used in its SMTP greeting
58 banner, for expanding unqualified addresses, the Message ID and so on.
60 Template: masqmail/local_hosts
61 Type: string
62 Default:
63 Description: hosts considered local
64 This is a list of hosts, separated with semicolons (;), which are
65 considered 'local', ie. mail to this host will be delivered to a
66 mailbox (or Maildir or MDA) on this host.
67 .
68 You will most likely insert 'localhost', your hostname in its fully
69 qualified version, and just the simple hostname here.
70 .
71 You can also use wildcard expressions like '*' and '?'.
73 Template: masqmail/local_nets
74 Type: string
75 Default:
76 Description: nets considered local, for immediate delivery attempts
77 This is a list of hosts, separated with semicolons (;), which are
78 on your local network, ie. they are always reachable, without a
79 dialup connection. Mail to these hosts will be delivered immediately,
80 without checking for the online status.
81 .
82 You can use wildcards expressions like '*' and '?', eg. *.yournet.local
83 .
84 If you have only one box, you can leave this empty. If you do not want
85 to use masqmail as an offline MTA, and the whole internet or another mail
86 server which accepts outgoing mail is all time
87 reachable to you, just insert '*'.
89 Template: masqmail/listen_addresses
90 Type: string
91 Default: localhost:25
92 Description: accept connections on these interfaces
93 masqmail, for security reasons, does not listen an all network interfaces
94 by default. If there are no other hosts connected to your host, just leave
95 this 'localhost:25'. If there are other hosts that may want to send SMTP
96 messages to this host, add the address of you network interface here,
97 eg.: localhost:25;192.168.1.2:25.
98 .
99 Of course you can also replace the '25' with another port number, but
100 this is unusual.
102 Template: masqmail/use_syslog
103 Type: boolean
104 Default: false
105 Description: use syslogd for logs?
106 You can decide whether masqmail should log via syslog or not. If not,
107 logs will be written to /var/log/masqmail/masqmail.log.
109 Template: masqmail/online_detect
110 Type: select
111 Choices: file, pipe
112 Default: file
113 Description: the online detection method
114 masqmail has different methods to determine whether it is online or not,
115 these are 'file','pipe'.
116 .
117 For 'file', masqmail checks for the existence of a file, and, if it
118 exists, reads from it the name of the connection.
119 .
120 For 'pipe', masqmail calls a program or script, which outputs the name
121 if online or nothing if not. You can use eg. the program guessnet for this.
123 Template: masqmail/online_file
124 Type: string
125 Default: /var/run/masqmail-route
126 Description: the name of the file to determine the online status
128 Template: masqmail/online_pipe
129 Type: string
130 Default:
131 Description: the name of the program to determine the online status
132 Note that, when this program is called, masqmail has the user id 'mail'.
134 Template: masqmail/mbox_default
135 Type: select
136 Choices: mbox, mda, maildir
137 Default: mbox
138 Description: local delivery style
139 Local mail can be delivered to a mailbox, to an MDA (eg. procmail)
140 or to a qmail style maildir in the users home dir.
141 .
142 You can select the default style here. You can configure this also
143 on a per-user basis with the options mbox_users, mda_users and
144 maildir_users.
146 Template: masqmail/mda
147 Type: string
148 Default: /usr/bin/procmail -Y -d ${rcpt_local}
149 Description: The MDA command line including options
150 Give here the path to the mda, including its arguments. You can use
151 substitution values here, eg. ${rcpt_local} for the user name.
152 .
153 For other substitutions please see the man page.
154 .
155 (This question is also asked if you did not set mbox_default to mda,
156 since you can use mda for a set of users specially)
158 Template: masqmail/alias_local_caseless
159 Type: boolean
160 Default: false
161 Description: Alias expansion regarding case or not
162 masqmail uses the file /etc/aliases to redirect local addresses.
163 The search for a match in /etc/aliases can be regarding upper/lower
164 case or insensitive to case.
166 Template: masqmail/init_smtp_daemon
167 Type: boolean
168 Default: true
169 Description: Start SMTP listening daemon?
170 Select 'yes' if you want masqmail to start as an SMTP listening
171 daemon. You will need this if:
172 .
173 - there are other hosts in your local network that may want to send mail via this host
174 .
175 - you use a mail client that sends mail via SMTP (netscape, mozilla are examples)
176 .
177 If in doubt, select 'yes'.
179 Template: masqmail/init_queue_daemon
180 Type: boolean
181 Default: true
182 Description: Start SMTP queue running daemon?
183 Select 'yes' if you want masqmail to start as a queue running daemon. You will
184 need this very likely. It is used for mail that cannot delivered immediately,
185 either because of delivery failures or because you were not online on
186 the first attempt to send a mail.
187 .
188 If in doubt, select 'yes'.
190 Template: masqmail/queue_daemon_ival
191 Type: string
192 Default: -q10m
193 Description: The interval for the queue running daemon
194 Set the interval for the queue running daemon. -q10m means flush the queue every
195 10 minutes.
196 .
197 The format is -q, followed by an numeric value and one of the letters s,m,h,d,w for
198 seconds, minutes, hours, days or weeks respectively.
199 .
200 Reasonable values are between 5 minutes (-q5m) and 2 hours (-q2h).
202 Template: masqmail/init_fetch_daemon
203 Type: boolean
204 Default: false
205 Description: Start POP3 fetch daemon?
206 Select 'yes' if you want masqmail to start as a fetch daemon. If you say 'yes',
207 masqmail will try to fetch mail from pop servers that you configure in regular
208 intervals, detecting the online status first.
209 .
210 No matter what you choose here, you can later select whether you want to fetch
211 mail the moment you get online.
213 Template: masqmail/fetch_daemon_ival
214 Type: string
215 Default: -go5m
216 Description: The interval for the fetch daemon
217 Set the interval for the fetch daemon. -go5m means try to fetch mail every
218 5 minutes.
219 .
220 The format is -go, followed by an numeric value and one of the letters s,m,h,d,w for
221 seconds, minutes, hours, days or weeks respectively.
222 .
223 Reasonable values are between 2 minutes (-go2m) and 2 hours (-go2h).
225 Template: masqmail/ipup_runqueue
226 Type: boolean
227 Default: true
228 Description: flush mail queue when you get online?
229 Select 'yes' if you want masqmail to immediately flush its mail queue as soon
230 as you go online. This will be done in the ip-up script in /etc/ppp/ip-up or
231 in /etc/network/if-up.d/.
233 Template: masqmail/ipup_fetch
234 Type: boolean
235 Default: false
236 Description: fetch mail when you get online?
237 Select 'yes' if you want masqmail to immediately fetch mail from POP3
238 servers as soon as you go online. This will be done in the ip-up script
239 in /etc/ppp/ip-up or in /etc/network/if-up.d/.
241 Template: masqmail/ifup_ifaces
242 Type: string
243 Default: all
244 Description: a list of interfaces used for masqmail online detection
245 Set this to a list of network interfaces. When any of those interfaces go
246 up, the current online status will be used for queue runs and/or fetching
247 mails. The list will be used in the /etc/ppp/ip-up and /etc/network/if-up.d/
248 scripts, when the interface goes up.
249 .
250 A reasonable choice is eg. 'ppp0' for a desktop at home, or 'ppp0 eth0' for
251 a notebook". If this is set to eg. 'ppp0', nothing happens if eth0 goes up.
252 .
253 Set to 'all' for all interfaces, or 'none' for no interfaces.
255 Template: masqmail/you_are_not_finished
256 Type: note
257 Description: You are not finished
258 Although masqmail is not as feature rich as other MTAs like sendmail
259 or exim, this debconf does not (yet) do all configurations for you.
260 .
261 To make use of masqmail, you still have to create some sub configuration
262 files for sending mail to some ISP and/or to fetch mail. masqmail has
263 lots of man pages and examples which are hopefully clear enough to
264 explain to you how to do it.
265 .
266 You should start with the man pages masqmail.conf, masqmail.route
267 and masqmail.get.