debian/masqmail-debian

view README.online @ 56:8638dc3d7bcd

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