masqmail-0.2

annotate debian/README.online @ 0:08114f7dcc23

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