annotate README.online @ 23:30402b14eeb8

fixed lintian warnings
author meillo@marmaro.de
date Sun, 24 May 2009 20:21:51 +0200
parents 9a453b386f33
children 8923fa06a2b7
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
1 Different methods for online detection
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
2 --------------------------------------
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
3
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
4 /etc/ppp/peers/<provider>
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
5 -------------------------
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
6
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
7 The scripts /etc/ppp/ip-{up,down}.d/{1,99}masqmail make use of the variable
8
9a453b386f33 fixed typo
meillo@marmaro.de
parents: 0
diff changeset
8 $IPPARAM, which you can define in your /etc/ppp/peers/<provider>
0
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
9 configuration with the ippparam option, eg:
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
10
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
11 ippparam arcor
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
12
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
13 If this is set, $IPPARAM will be written to a 'route' file. Using some
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
14 awk magic, the scripts finds out which file you have defined for
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
15 online detection (if online_detect=file) and writes the value of
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
16 $IPPARAM to this file. masqmail then uses this file to determine its
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
17 online status.
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
18
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
19
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
20 /etc/network/interfaces
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
21 -----------------------
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
22
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
23 You can use the /etc/network/interfaces script to tell masqmail
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
24 when a link goes up, and masqmail shall flush its queue and/or fetch mail.
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
25
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
26 This is an example for a static interface:
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
27
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
28 iface eth0 inet static
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
29 # mroute/name used by ip-up.d/masqmail BDL May02
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
30 name SNRC
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
31 address 130.130.10.233
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
32 netmask 255.255.255.0
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
33 gateway 130.130.10.254
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
34
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
35 (This example is from Ben Low. Thanks, Ben :-))
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
36
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
37 If you use masqmail on a notebook, you can define several interfaces,
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
38 depending on the network you are in. Read
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
39 /usr/share/doc/ifupdown/examples/interfaces.gz
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
40 for examples.
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
41
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
42 The scripts /etc/network/if-{up,down}.d/1masqmail make use of the NAME
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
43 in the same way as the /etc/ppp/ip-{up,down}.d/ scripts. See above.
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
44
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
45
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
46 guessnet and /etc/network/interfaces
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
47 ------------------------------------
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
48
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
49 Another nice tool is guessnet. See /usr/share/doc/guessnet/README.gz,
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
50 if you have guessnet installed. You can use it in combination with the
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
51 method described above for /etc/network/interfaces.
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
52
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
53
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
54 guessnet and the 'online_pipe' option
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
55 -------------------------------------
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
56
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
57 Alternatively you can also use guessnet directly to check the online
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
58 status. To do this, set in
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
59 /etc/masqmail/masqmail.conf
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
60
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
61 #
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
62 online_detect=pipe
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
63 online_pipe="/usr/bin/guessnet < /etc/masqmail/guessnet.conf"
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
64 #
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
65
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
66 and create a file
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
67 /etc/masqmail/guessnet.conf
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
68
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
69 Example:
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
70 192.168.0.35 00:10:5A:24:C5:B6 192.168.0.1 default
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
71 192.168.2.1 00:80:AD:97:D5:2D 192.168.0.1 home
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
72
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
73
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
74 masqdialer and the 'online_pipe' option
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
75 ---------------------------------------
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
76
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
77 Yet another possibility for ppp dialups is masqdialer:
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
78
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
79 Example:
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
80 #
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
81 online_detect=pipe
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
82 online_pipe="/usr/bin/mservdetect 192.168.1.2 224"
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
83 #
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
84
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
85 This is useful if you have a gateway with masqdialer running
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
86 and masqmail on another host behind ('behind' as seen from the internet)
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
87
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
88 Note:
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
89 The online detect method 'mserver' is deprecated, and this debian
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
90 package comes with that option disabled. You can still recompile the
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
91 package with the ./configure option --enable-mserver, but this may be
5ef519035828 debian directory of masqmail-0.2.21-4
meillo@marmaro.de
parents:
diff changeset
92 removed in future version of masqmail.