masqmail

annotate docs/ppp-setup @ 222:8cddc65765bd

added support for STARTTLS wrappers added the route config option `instant_helo' which causes masqmail, as SMTP client, not to wait for the server's 220 greeting. Instead if says EHLO right at once. You'll need this for STARTTLS wrappers that usually eat the greeting line.
author meillo@marmaro.de
date Fri, 23 Jul 2010 10:57:53 +0200
parents
children f10a56dc7481
rev   line source
meillo@166 1 This document covers dial-up internet connections with PPP
meillo@166 2 ----------------------------------------------------------
meillo@166 3
meillo@166 4 Now you have to set up the online configuration. The trick is to tell
meillo@166 5 your ip-up script the connection name. You could use the IP number of
meillo@166 6 the far side of the ppp link, but this is a pain and may change each
meillo@166 7 time. But you can give it an additional argument via pppd with ipparam.
meillo@166 8 Somewhere in your dial up script you have a line similar to:
meillo@166 9
meillo@166 10 /usr/sbin/pppd /dev/ttyS1 connect "/usr/sbin/chat -t 90 -f $CHATFILE" \
meillo@166 11 -d -d -d user user@somewhere file "$OPTIONS"
meillo@166 12
meillo@166 13 Just add 'ipparam FastNet' in the command line for pppd if your ISP has
meillo@166 14 the name FastNet. The ip-up script will then get 'FastNet' as a sixth
meillo@166 15 parameter. In your ip-up script you can then call masqmail with
meillo@166 16
meillo@166 17 /usr/local/sbin/masqmail -qo "$6"
meillo@166 18
meillo@166 19 instead of 'sendmail -q', if you had that in the script before.
meillo@166 20 Masqmail will then read the route configuration specified for the
meillo@166 21 connection name 'FastNet' and deliver the mail destined to the internet.
meillo@166 22 See the configuration manual on how to write a route configuration or
meillo@166 23 use one of the examples as a template.
meillo@166 24
meillo@166 25 I do not know how do configure that for an ISDN adapter, but I am sure
meillo@166 26 you will find something similar in the man pages.
meillo@166 27
meillo@166 28 If you want mail that is received by masqmail from your local net to be
meillo@166 29 delivered immediately using the route configuration, you have two
meillo@166 30 possibilities:
meillo@166 31
meillo@166 32 * if you are using the masqdialer system, you just have to set the
meillo@166 33 variables online_detect to pipe and online_pipe to something like
meillo@166 34 /usr/bin/mservdetect localhost 224
meillo@166 35 if mserver is running on localhost and listens on port 224. See the
meillo@166 36 man page to mservdetect(1).
meillo@166 37
meillo@166 38 * otherwise you have to add two commands in your ip-up script:
meillo@166 39 echo "$6" >/var/run/masqmail/masqmail-route
meillo@166 40 chmod 644 /var/run/masqmail/masqmail-route
meillo@166 41 and you have to remove the file /var/run/masqmail/masqmail-route in
meillo@166 42 your ip-down script:
meillo@166 43 rm /var/run/masqmail/masqmail-route
meillo@166 44 Then you have to set online_detect to file and online_file to
meillo@166 45 /var/run/masqmail/masqmail-route
meillo@166 46
meillo@166 47 See the route documentation for more.
meillo@166 48
meillo@166 49
meillo@166 50 written by oku
meillo@166 51 (it was once located inside of INSTALL)