annotate docs/ppp-setup @ 208:3708b655a371

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