masqmail

diff docs/ppp-setup @ 166:0ef0f756280b

moved the PPP setup documentation from INSTALL to an own file
author meillo@marmaro.de
date Thu, 08 Jul 2010 22:02:58 +0200
parents
children f10a56dc7481
line diff
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/docs/ppp-setup	Thu Jul 08 22:02:58 2010 +0200
     1.3 @@ -0,0 +1,51 @@
     1.4 +This document covers dial-up internet connections with PPP
     1.5 +----------------------------------------------------------
     1.6 +
     1.7 +Now you have to set up the online configuration. The trick is to tell
     1.8 +your ip-up script the connection name. You could use the IP number of
     1.9 +the far side of the ppp link, but this is a pain and may change each
    1.10 +time. But you can give it an additional argument via pppd with ipparam.
    1.11 +Somewhere in your dial up script you have a line similar to:
    1.12 +
    1.13 +	/usr/sbin/pppd /dev/ttyS1 connect "/usr/sbin/chat -t 90 -f $CHATFILE" \
    1.14 +	-d -d -d user user@somewhere file "$OPTIONS"
    1.15 +
    1.16 +Just add 'ipparam FastNet' in the command line for pppd if your ISP has
    1.17 +the name FastNet. The ip-up script will then get 'FastNet' as a sixth
    1.18 +parameter. In your ip-up script you can then call masqmail with
    1.19 +
    1.20 +	/usr/local/sbin/masqmail -qo "$6"
    1.21 +
    1.22 +instead of 'sendmail -q', if you had that in the script before.
    1.23 +Masqmail will then read the route configuration specified for the
    1.24 +connection name 'FastNet' and deliver the mail destined to the internet.
    1.25 +See the configuration manual on how to write a route configuration or
    1.26 +use one of the examples as a template.
    1.27 +
    1.28 +I do not know how do configure that for an ISDN adapter, but I am sure
    1.29 +you will find something similar in the man pages.
    1.30 +
    1.31 +If you want mail that is received by masqmail from your local net to be
    1.32 +delivered immediately using the route configuration, you have two
    1.33 +possibilities:
    1.34 +
    1.35 +* if you are using the masqdialer system, you just have to set the
    1.36 +  variables online_detect to pipe and online_pipe to something like
    1.37 +	/usr/bin/mservdetect localhost 224
    1.38 +  if mserver is running on localhost and listens on port 224. See the
    1.39 +  man page to mservdetect(1).
    1.40 +
    1.41 +* otherwise you have to add two commands in your ip-up script:
    1.42 +	echo "$6" >/var/run/masqmail/masqmail-route
    1.43 +	chmod 644 /var/run/masqmail/masqmail-route
    1.44 +  and you have to remove the file /var/run/masqmail/masqmail-route in
    1.45 +  your ip-down script:
    1.46 +	rm /var/run/masqmail/masqmail-route
    1.47 +  Then you have to set online_detect to file and online_file to
    1.48 +  /var/run/masqmail/masqmail-route
    1.49 +
    1.50 +See the route documentation for more.
    1.51 +
    1.52 +
    1.53 +written by oku
    1.54 +(it was once located inside of INSTALL)