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

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

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

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

meillo@56: meillo@56:

Compliling is a matter of the usual procedure:

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

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

meillo@56: meillo@56:

Additional options for configure:

meillo@56: meillo@56:

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

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

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

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

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

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

meillo@56: meillo@56:

After make install

meillo@56: meillo@56:

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

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

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

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

meillo@56: 

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

meillo@56:

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

meillo@56: meillo@56:

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

meillo@56: meillo@56:

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

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

Then make a link to the new MTA:

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

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

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

or shorter:

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

meillo@56:
meillo@56: meillo@56:

You can also start it with:

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

meillo@56:
meillo@56: meillo@56:

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

meillo@56: meillo@56:

Configuring for online delivery

meillo@56: meillo@56:

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

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

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

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

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

meillo@56: meillo@56:

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

meillo@56: meillo@56:

meillo@56:

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

meillo@56: meillo@56:

See the route documentation for more.

meillo@56:
meillo@56:

meillo@56:

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

meillo@56: meillo@56:
meillo@56:
meillo@56: meillo@56: meillo@56: meillo@56: