meillo@0: Template: masqmail/note_moved_tpl
meillo@0: Type: note
meillo@0: Description: Failure notice templates have been moved
meillo@0:  The delivery failure notices that lived in /etc/masqmail/tpl are now in
meillo@0:  /usr/share/masqmail/tpl/.
meillo@0:  .
meillo@0:  You will notice this only if you have changed the location in
meillo@0:  masqmail.conf or changed the templates.
meillo@0:  .
meillo@0:  Since they are no longer conffiles because of the move, you should
meillo@0:  give a customized version another name, otherwise it will be
meillo@0:  overwritten on the next upgrade.
meillo@0: 
meillo@0: Template: masqmail/note_pcmcia_scripts
meillo@0: Type: note
meillo@0: Description: Removed executable bit in scripts in /etc/pcmcia/ip-{up,down}.d/
meillo@0:  The scripts in /etc/pcmcia/ip-{up,down}.d/ are deprecated
meillo@0:  and are replaced with the scripts /etc/network/if-{up,down}.d/1masqmail, which
meillo@0:  will work for _any_ network card (not just pcmcia). The executable bit of the
meillo@0:  old scripts has been removed, because otherwise they and the new scripts would be
meillo@0:  exececuted, which is not desired.
meillo@0:  .
meillo@0:  You should remove these scripts from /etc/pcmcia/ip-{up,down}.d/. If you still want
meillo@0:  to use them, just reset the executable bit.
meillo@0:  .
meillo@0:  Whatever you do, you will never see the note again.
meillo@0: 
meillo@0: Template: masqmail/manage_config_with_debconf
meillo@0: Type: boolean
meillo@0: Default: true
meillo@0: Description: Manage masqmail.conf using debconf?
meillo@0:  The /etc/masqmail/masqmail.conf file can be handled automatically
meillo@0:  by debconf, or manually by you.
meillo@0:  .
meillo@0:  Note that only specific, marked sections of the configuration file will be
meillo@0:  handled by debconf if you select this option; if those markers are absent,
meillo@0:  you will have to update the file manually, or move or delete the file.
meillo@0: 
meillo@0: Template: masqmail/move_existing_nondebconf_config
meillo@0: Type: boolean
meillo@0: Default: false
meillo@0: Description: Replace existing /etc/masqmail/masqmail.conf file?
meillo@0:  The existing /etc/masqmail/masqmail.conf file currently on the system does
meillo@0:  not contain a marked section for debconf to write its data.
meillo@0:  .
meillo@0:  If you select this option, the existing configuration
meillo@0:  file will be backed up to /etc/masqmail/masqmail.conf.debconf-backup and a
meillo@0:  new file written to /etc/masqmail/masqmail.conf.  If you do not select this
meillo@0:  option, the existing configuration file will not be managed by debconf,
meillo@0:  and no further questions about masqmail configuration will be
meillo@0:  asked.
meillo@0: 
meillo@0: Template: masqmail/host_name
meillo@0: Type: string
meillo@0: Default:
meillo@0: Description: The name with which masqmail identifies itself to others
meillo@0:  This is most likely your hostname. It is used in its SMTP greeting
meillo@0:  banner, for expanding unqualified addresses, the Message ID and so on.
meillo@0: 
meillo@0: Template: masqmail/local_hosts
meillo@0: Type: string
meillo@0: Default:
meillo@0: Description: hosts considered local
meillo@0:  This is a list of hosts, separated with semicolons (;), which are
meillo@0:  considered 'local', ie. mail to this host will be delivered to a
meillo@0:  mailbox (or Maildir or MDA) on this host.
meillo@0:  .
meillo@0:  You will most likely insert 'localhost', your hostname in its fully
meillo@0:  qualified version, and just the simple hostname here.
meillo@0:  .
meillo@0:  You can also use wildcard expressions like '*' and '?'.
meillo@0: 
meillo@0: Template: masqmail/local_nets
meillo@0: Type: string
meillo@0: Default:
meillo@0: Description: nets considered local, for immediate delivery attempts
meillo@0:  This is a list of hosts, separated with semicolons (;), which are
meillo@0:  on your local network, ie. they are always reachable, without a
meillo@0:  dialup connection. Mail to these hosts will be delivered immediately,
meillo@0:  without checking for the online status.
meillo@0:  .
meillo@0:  You can use wildcards expressions like '*' and '?', eg. *.yournet.local
meillo@0:  .
meillo@0:  If you have only one box, you can leave this empty. If you do not want
meillo@0:  to use masqmail as an offline MTA, and the whole internet or another mail
meillo@0:  server which accepts outgoing mail is all time
meillo@0:  reachable to you, just insert '*'.
meillo@0: 
meillo@0: Template: masqmail/listen_addresses
meillo@0: Type: string
meillo@0: Default: localhost:25
meillo@0: Description: accept connections on these interfaces
meillo@0:  masqmail, for security reasons, does not listen an all network interfaces
meillo@0:  by default. If there are no other hosts connected to your host, just leave
meillo@0:  this 'localhost:25'. If there are other hosts that may want to send SMTP
meillo@0:  messages to this host, add the address of you network interface here,
meillo@0:  eg.: localhost:25;192.168.1.2:25.
meillo@0:  .
meillo@0:  Of course you can also replace the '25' with another port number, but
meillo@0:  this is unusual.
meillo@0: 
meillo@0: Template: masqmail/use_syslog
meillo@0: Type: boolean
meillo@0: Default: false
meillo@0: Description: use syslogd for logs?
meillo@0:  You can decide whether masqmail should log via syslog or not. If not,
meillo@0:  logs will be written to /var/log/masqmail/masqmail.log.
meillo@0: 
meillo@0: Template: masqmail/online_detect
meillo@0: Type: select
meillo@0: Choices: file, pipe
meillo@0: Default: file
meillo@0: Description: the online detection method
meillo@0:  masqmail has different methods to determine whether it is online or not,
meillo@0:  these are 'file','pipe'.
meillo@0:  .
meillo@0:  For 'file', masqmail checks for the existence of a file, and, if it
meillo@0:  exists, reads from it the name of the connection.
meillo@0:  .
meillo@0:  For 'pipe', masqmail calls a program or script, which outputs the name
meillo@0:  if online or nothing if not. You can use eg. the program guessnet for this.
meillo@0: 
meillo@0: Template: masqmail/online_file
meillo@0: Type: string
meillo@0: Default: /var/run/masqmail-route
meillo@0: Description: the name of the file to determine the online status
meillo@0: 
meillo@0: Template: masqmail/online_pipe
meillo@0: Type: string
meillo@0: Default:
meillo@0: Description: the name of the program to determine the online status
meillo@0:  Note that, when this program is called, masqmail has the user id 'mail'.
meillo@0: 
meillo@0: Template: masqmail/mbox_default
meillo@0: Type: select
meillo@0: Choices: mbox, mda, maildir
meillo@0: Default: mbox
meillo@0: Description: local delivery style
meillo@0:  Local mail can be delivered to a mailbox, to an MDA (eg. procmail)
meillo@0:  or to a qmail style maildir in the users home dir.
meillo@0:  .
meillo@0:  You can select the default style here. You can configure this also
meillo@0:  on a per-user basis with the options mbox_users, mda_users and
meillo@0:  maildir_users.
meillo@0: 
meillo@0: Template: masqmail/mda
meillo@0: Type: string
meillo@0: Default: /usr/bin/procmail -Y -d ${rcpt_local}
meillo@0: Description: The MDA command line including options
meillo@0:  Give here the path to the mda, including its arguments. You can use
meillo@0:  substitution values here, eg. ${rcpt_local} for the user name.
meillo@0:  .
meillo@0:  For other substitutions please see the man page.
meillo@0:  .
meillo@0:  (This question is also asked if you did not set mbox_default to mda,
meillo@0:  since you can use mda for a set of users specially)
meillo@0: 
meillo@0: Template: masqmail/alias_local_caseless
meillo@0: Type: boolean
meillo@0: Default: false
meillo@0: Description: Alias expansion regarding case or not
meillo@0:  masqmail uses the file /etc/aliases to redirect local addresses.
meillo@0:  The search for a match in /etc/aliases can be regarding upper/lower
meillo@0:  case or insensitive to case.
meillo@0: 
meillo@0: Template: masqmail/init_smtp_daemon
meillo@0: Type: boolean
meillo@0: Default: true
meillo@0: Description: Start SMTP listening daemon?
meillo@0:  Select 'yes' if you want masqmail to start as an SMTP listening
meillo@0:  daemon. You will need this if:
meillo@0:  .
meillo@0:  - there are other hosts in your local network that may want to send mail via this host
meillo@0:  .
meillo@0:  - you use a mail client that sends mail via SMTP (netscape, mozilla are examples)
meillo@0:  .
meillo@0:  If in doubt, select 'yes'.
meillo@0: 
meillo@0: Template: masqmail/init_queue_daemon
meillo@0: Type: boolean
meillo@0: Default: true
meillo@0: Description: Start SMTP queue running daemon?
meillo@0:  Select 'yes' if you want masqmail to start as a queue running daemon. You will
meillo@0:  need this very likely. It is used for mail that cannot delivered immediately,
meillo@0:  either because of delivery failures or because you were not online on
meillo@0:  the first attempt to send a mail.
meillo@0:  .
meillo@0:  If in doubt, select 'yes'.
meillo@0: 
meillo@0: Template: masqmail/queue_daemon_ival
meillo@0: Type: string
meillo@0: Default: -q10m
meillo@0: Description: The interval for the queue running daemon
meillo@0:  Set the interval for the queue running daemon. -q10m means flush the queue every
meillo@0:  10 minutes.
meillo@0:  .
meillo@0:  The format is -q, followed by an numeric value and one of the letters s,m,h,d,w for
meillo@0:  seconds, minutes, hours, days or weeks respectively.
meillo@0:  .
meillo@0:  Reasonable values are between 5 minutes (-q5m) and 2 hours (-q2h).
meillo@0: 
meillo@0: Template: masqmail/init_fetch_daemon
meillo@0: Type: boolean
meillo@0: Default: false
meillo@0: Description: Start POP3 fetch daemon?
meillo@0:  Select 'yes' if you want masqmail to start as a fetch daemon. If you say 'yes',
meillo@0:  masqmail will try to fetch mail from pop servers that you configure in regular
meillo@0:  intervals, detecting the online status first.
meillo@0:  .
meillo@0:  No matter what you choose here, you can later select whether you want to fetch
meillo@0:  mail the moment you get online.
meillo@0: 
meillo@0: Template: masqmail/fetch_daemon_ival
meillo@0: Type: string
meillo@0: Default: -go5m
meillo@0: Description: The interval for the fetch daemon
meillo@0:  Set the interval for the fetch daemon. -go5m means try to fetch mail every
meillo@0:  5 minutes.
meillo@0:  .
meillo@0:  The format is -go, followed by an numeric value and one of the letters s,m,h,d,w for
meillo@0:  seconds, minutes, hours, days or weeks respectively.
meillo@0:  .
meillo@0:  Reasonable values are between 2 minutes (-go2m) and 2 hours (-go2h).
meillo@0: 
meillo@0: Template: masqmail/ipup_runqueue
meillo@0: Type: boolean
meillo@0: Default: true
meillo@0: Description: flush mail queue when you get online?
meillo@0:  Select 'yes' if you want masqmail to immediately flush its mail queue as soon
meillo@0:  as you go online. This will be done in the ip-up script in /etc/ppp/ip-up or
meillo@0:  in /etc/network/if-up.d/.
meillo@0: 
meillo@0: Template: masqmail/ipup_fetch
meillo@0: Type: boolean
meillo@0: Default: false
meillo@0: Description: fetch mail when you get online?
meillo@0:  Select 'yes' if you want masqmail to immediately fetch mail from POP3
meillo@0:  servers as soon as you go online. This will be done in the ip-up script
meillo@0:  in /etc/ppp/ip-up or in /etc/network/if-up.d/.
meillo@0: 
meillo@0: Template: masqmail/ifup_ifaces
meillo@0: Type: string
meillo@0: Default: all
meillo@0: Description: a list of interfaces used for masqmail online detection
meillo@0:  Set this to a list of network interfaces. When any of those interfaces go
meillo@0:  up, the current online status will be used for queue runs and/or fetching
meillo@0:  mails. The list will be used in the /etc/ppp/ip-up and /etc/network/if-up.d/
meillo@0:  scripts, when the interface goes up.
meillo@0:  .
meillo@0:  A reasonable choice is eg. 'ppp0' for a desktop at home, or 'ppp0 eth0' for
meillo@0:  a notebook". If this is set to eg. 'ppp0', nothing happens if eth0 goes up.
meillo@0:  .
meillo@0:  Set to 'all' for all interfaces, or 'none' for no interfaces.
meillo@0: 
meillo@0: Template: masqmail/you_are_not_finished
meillo@0: Type: note
meillo@0: Description: You are not finished
meillo@0:  Although masqmail is not as feature rich as other MTAs like sendmail
meillo@0:  or exim, this debconf does not (yet) do all configurations for you.
meillo@0:  .
meillo@0:  To make use of masqmail, you still have to create some sub configuration
meillo@0:  files for sending mail to some ISP and/or to fetch mail. masqmail has
meillo@0:  lots of man pages and examples which are hopefully clear enough to
meillo@0:  explain to you how to do it.
meillo@0:  .
meillo@0:  You should start with the man pages masqmail.conf, masqmail.route
meillo@0:  and masqmail.get.