meillo@1: meillo@1: meillo@1: meillo@1: meillo@1: meillo@1: meillo@1: meillo@1: meillo@1: meillo@1: meillo@1: MasqMail - Manual meillo@1: meillo@1: meillo@1: meillo@1: meillo@1:
meillo@1: meillo@1: meillo@1: meillo@1:
meillo@1: meillo@1: meillo@1: meillo@1: meillo@1: meillo@1: meillo@1:
meillo@1: meillo@1: manual meillo@1: meillo@1: Installation meillo@1: meillo@1: Options meillo@1: meillo@1:
meillo@1: meillo@1: meillo@1:

You need a user and a group for masqmail to run, I suggest user meillo@1: 'mail' and group 'trusted'. Say:

meillo@1: meillo@1: 
meillo@1: groupadd -g 42 trusted
meillo@1: useradd -u 42 -g 42 -d / -s /bin/sh -c "Mail Transfer Agent" mail
meillo@1:
meillo@1: meillo@1:

If you use other names than mail and trusted use the options meillo@1: described below for configure. The 42 is just a suggestion, you can meillo@1: use any number you like, but preferably one < 100. It does not have meillo@1: to be the same for the user 'mail' and the group 'trusted'.

meillo@1: meillo@1:

Compliling is a matter of the usual procedure:

meillo@1: meillo@1: In the source directory, after unpacking do:
meillo@1: meillo@1: 
meillo@1: ./configure
meillo@1: make
meillo@1: make install
meillo@1:
meillo@1: meillo@1:

Optionally, after you have called make, you can make some tests in meillo@1: the tests directory. Read the README in that directory for meillo@1: instructions.

meillo@1: meillo@1:

Additional options for configure:

meillo@1: meillo@1:

meillo@1: --with-user=USER sets the user as which MasqMail will run. Default is meillo@1: mail. USER has to exist before you 'make install'. meillo@1:

meillo@1: --with-group=GROUP sets the group as which MasqMail will run. Default meillo@1: is trusted. GROUP has to exist before you 'make install'. meillo@1:

meillo@1: --with-logdir=LOGDIR sets the directory where MasqMail stores its log meillo@1: files. It will be created if it does not exist. Default is /var/masqmail/. meillo@1:

meillo@1: --with-spooldir=SPOOLDIR sets the directory where MasqMail stores its meillo@1: spool files. It will be created if it does not exist. Default is meillo@1: /var/spool/masqmail/. meillo@1:

meillo@1: --enable-auth enables ESMTP AUTH support (disabled by default) meillo@1:

meillo@1: --disable-pop3 disables pop3 support (enabled by default) meillo@1:

meillo@1: meillo@1:

After make install

meillo@1: meillo@1:

meillo@1: You can also use these instructions to omit 'make install' if you do meillo@1: not want to use it. meillo@1:

meillo@1: Check that 'make install' worked correctly. The following command: meillo@1: 

meillo@1: ls -ld /usr/sbin/masqmail /var/masqmail/ /var/spool/masqmail /var/spool/masqmail/input
meillo@1:

meillo@1: should give output similar to meillo@1:

meillo@1: 

meillo@1: -rwsr-xr-x   1 root     root        86955 Oct 14 14:27 /usr/sbin/masqmail
meillo@1: drwxr-xr-x   2 mail     trusted      1024 Oct 14 14:29 /var/masqmail/
meillo@1: drwxr-xr-x   3 mail     trusted      1024 Oct 14 14:27 /var/spool/masqmail
meillo@1: drwxr-xr-x   2 mail     trusted      1024 Oct 14 18:32 /var/spool/masqmail/input
meillo@1: drwxr-xr-x   2 mail     trusted      1024 Oct 14 18:32 /var/spool/masqmail/popuidl
meillo@1:
meillo@1:

meillo@1:

meillo@1: (important is the set-user-id bit for /usr/sbin/masqmail and the meillo@1: ownership of all items). meillo@1:

meillo@1: meillo@1:

Edit the configuration files. You can use the files from the meillo@1: examples directory as a template. Copy masqmail.conf to meillo@1: /etc/maqmail.conf, the others to the location given in meillo@1: masqmail.conf.

meillo@1: meillo@1:

If you already have an MTA (eg. sendmail) installed, move that to meillo@1: another location:

meillo@1: meillo@1: mv /usr/sbin/sendmail /usr/sbin/sendmail.orig
meillo@1: meillo@1:

Then make a link to the new MTA:

meillo@1: meillo@1: 
meillo@1: ln -s /usr/sbin/masqmail /usr/sbin/sendmail
meillo@1:
meillo@1: meillo@1:

Now every mailer that used to call sendmail will now call meillo@1: masqmail. You can now kill your old sendmail if it is running and meillo@1: start masqmail. Usually this is done with the startup scripts. For meillo@1: SuSE this would be (as root):

meillo@1: meillo@1: 
meillo@1: /sbin/init.d/sendmail stop
meillo@1: /sbin/init.d/sendmail start
meillo@1:
meillo@1: meillo@1:

or shorter:

meillo@1: meillo@1: 
meillo@1: /sbin/init.d/sendmail restart

meillo@1:
meillo@1: meillo@1:

You can also start it with:

meillo@1: meillo@1: 
meillo@1: /usr/sbin/sendmail -bd -q30m

meillo@1:
meillo@1: meillo@1:

You can also let it be called from inetd (with the -bs option), but meillo@1: this is untested.

meillo@1: meillo@1:

Configuring for online delivery

meillo@1: meillo@1:

Now you have to set up the online configuration. The trick is to meillo@1: tell your ip-up script the connection name. You could use the IP meillo@1: number of the far side of the ppp link, but this is a pain and may meillo@1: change each time. But you can give it an additional argument via pppd meillo@1: with ipparam. Somewhere in your dial up script you have a line similar meillo@1: to:

meillo@1: meillo@1: 
meillo@1: /usr/sbin/pppd /dev/ttyS1 connect "/usr/sbin/chat -t 90 -f
meillo@1: ${CHATFILE}" -d -d -d user user@somewhere file ${OPTIONS}
meillo@1:
meillo@1: meillo@1:

Just add 'ipparam FastNet' in the command line for pppd if your ISP meillo@1: has the name FastNet. The ip-up script will then get 'FastNet' as a meillo@1: sixth parameter. In your ip-up script you can then call masqmail with

meillo@1: meillo@1: 
meillo@1: /usr/sbin/masqmail -qo $6
meillo@1:
meillo@1: meillo@1:

instead of 'sendmail -q', if you had that in the script meillo@1: before. Masqmail will then read the route configuration specified for meillo@1: the connection name 'FastNet' and deliver the mail destined to the meillo@1: internet. See the configuration manual on how meillo@1: to write a route configuration or use one of the examples as a meillo@1: template. I do not know how do configure that for an ISDN adapter, meillo@1: but I am sure you will find something similar in the man meillo@1: pages.

meillo@1: meillo@1:

If you want mail that is received by masqmail from your local meillo@1: net to be delivered immediately using the route configuration, you meillo@1: have two possibilities:

meillo@1: meillo@1:

meillo@1:

    meillo@1: meillo@1:
  • if you are using the masqdialer system, you just have to set the meillo@1: variables online_detect to mserver and meillo@1: mserver_iface to the interface mserver is listening to.
    • meillo@1: meillo@1:
  • otherwise you have to add two commands in your ip-up script:
    meillo@1: echo -n $6 > /tmp/connect_route
    chmod 644 /tmp/connect_route
    meillo@1: and you have to remove the file /tmp/connect_route in your meillo@1: ip-down script:
    rm /tmp/connect_route.
    Then you have to set meillo@1: online_detect to file and online_file to meillo@1: /tmp/connect_route.
    • meillo@1: meillo@1:
meillo@1:

meillo@1: meillo@1:

See the route documentation for more.

meillo@1:
meillo@1:

meillo@1:

meillo@1:
Oliver Kurth
meillo@1: Last modified: Tue May 30 15:19:56 CEST 2000 meillo@1:
meillo@1: This page was created using Genpage - Version: 1.0.6 meillo@1:

meillo@1: meillo@1:
meillo@1:
meillo@1: meillo@1: meillo@1: meillo@1: