Mercurial > masqmail

annotate INSTALL @ 174:dbe3dadd1afe

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documentation improvements in the INSTALL file and some man pages thanks to Nico R.
author meillo@marmaro.de
date Wed, 14 Jul 2010 12:02:01 +0200
parents 10d00e3235f2
children 25b769efafe6
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
1 Additional information may be available in docs/ or on the website.
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
2 For installing on GNU/Linux distributions read docs/INSTALL.linux.
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
3
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
4
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
5 Installation instructions
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
6 -------------------------
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
7
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
8 To compile masqmail you need glib 1.2 (http://www.gtk.org).
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
9
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
10 You need a user and a group for masqmail to run, I suggest user
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
11 'mail' and group 'trusted'. Say:
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
12
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
13 groupadd -g 42 trusted
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
14 useradd -u 42 -g 42 -d / -s /bin/sh -c "Mail Transfer Agent" mail
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
15
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
16 If you use other names than 'mail' and 'trusted' use the options
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
17 described below for configure. The 42 is just a suggestion, you can
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
18 use any number you like, but preferably one < 100. It does not have
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
19 to be the same for the user 'mail' and the group 'trusted'.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
20
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
21 Compiling is a matter of the usual procedure. In the source directory,
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
22 after unpacking do:
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
23
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
24 ./configure
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
25 make
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
26 make install
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
27
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
28
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
29
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
30 Additional options for configure
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
31 --------------------------------
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
32
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
33 See the output of
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
34
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
35 ./configure -h
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
36
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
37 Here is additional, but maybe obsolete, explanation:
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
38
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
39 --with-user=USER sets the user as which MasqMail will run. Default is
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
40 'mail'. USER has to exist before you 'make install'.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
41
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
42 --with-group=GROUP sets the group as which MasqMail will run. Default
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
43 is 'trusted'. GROUP has to exist before you 'make install'.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
44
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
45 --with-logdir=LOGDIR sets the directory where MasqMail stores its log
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
46 files. It will be created if it does not exist. Default is /var/masqmail/.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
47
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
48 --with-spooldir=SPOOLDIR sets the directory where MasqMail stores its
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
49 spool files. It will be created if it does not exist. Default is
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
50 /var/spool/masqmail/.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
51
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
52 --with-confdir=CONFDIR sets the default configuration directory to
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
53 CONFDIR, in case you prefer another location than /etc/masqmail/.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
54
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
55 --enable-auth enables ESMTP AUTH support (disabled by default)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
56
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
57 --disable-pop3 disables POP3 support (enabled by default)
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
58
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
59 --enable-maildir enables qmail style Maildir support (disabled by default)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
60
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
61 --enable-ident enables RFC 1413 support. If you have the libident
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
62 dynamic library installed, this will be linked, otherwise it will be
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
63 statically linked using the sources included in the package.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
64
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
65 --disable-resolver disables resolver support. Without the resolver functions,
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
66 masqmail uses only gethostbyname() to resolve DNS names, and you cannot send
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
67 mail without a smart host. Not recommended. You save 3K at most.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
68
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
69 --disable-smtp-server disables SMTP server support. You may want this if you do
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
70 not need masqmail to listen. In this case, you cannot use masqmail as a smart
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
71 host for other hosts on your LAN, you cannot use mail clients that send SMTP,
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
72 you cannot even use pine. In short, use of this option is discouraged unless
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
73 your resources are extremely limited.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
74
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
75 --enable-mserver enables online detection by connecting to the mserver
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
76 (masqdialer system).
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
77
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
78 --with-libcryto instead of using the md5 and hmac functions within the package,
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
79 link dynamically with libcrypto. This applies only if you have POP3 or SMTP
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
80 AUTH enabled. Only makes sense if your resources are limited and you have
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
81 libcrypto installed. Untested.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
82
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
83 --with-glib-static links with glib statically. This makes the binary larger
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
84 by around 30K (i386 architecture), but if masqmail is the only binary using
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
85 glib, you save some space in total, because you do not need the shared glib
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
86 library installed.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
87
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
88 --disable-debug disables debugging; enabling it by command line or configuration
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
89 option has no effect. Strongly discouraged, since you miss valuable information
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
90 if something goes wrong. You save 6K.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
91
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
92 BTW, to get 3K of space, call
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
93 strip --remove-section=.comment --remove-section=.note --strip-unneeded src/masqmail
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
94 after building.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
95
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
96
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
97
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
98 after make install:
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
99 -------------------
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
100
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
101 You can also use these instructions to omit 'make install' if you do
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
102 not want to use it.
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
103
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
104 Check that 'make install' worked correctly. The following command:
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
105
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
106 ls -ld /usr/sbin/masqmail /etc/masqmail /var/log/masqmail/ \
174
dbe3dadd1afe Documentation improvements in the INSTALL file and some man pages
meillo@marmaro.de
parents: 92
diff changeset
107 /var/run/masqmail /var/spool/masqmail/ /var/spool/masqmail/*
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
108
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
109 should give output similar to
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
110
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
111 -rwsr-xr-x 1 root root 399356 May 10 12:34 /usr/sbin/masqmail
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
112 drwxr-xr-x 2 root root 4096 May 10 12:34 /etc/masqmail
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
113 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/log/masqmail
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
114 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/run/masqmail
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
115 drwxr-xr-x 5 mail trusted 4096 May 10 12:34 /var/spool/masqmail
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
116 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/spool/masqmail/input
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
117 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/spool/masqmail/lock
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
118 drwxr-xr-x 2 mail trusted 4096 May 10 12:34 /var/spool/masqmail/popuidl
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
119
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
120 (important is the set-user-id bit for /usr/sbin/masqmail and the
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
121 ownership of all items).
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
122
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
123 Use the example configuration files in examples/ to edit your own. The
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
124 main configuration file `masqmail.conf' and the *.route and *.get files
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
125 should go into /etc/masqmail.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
126
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
127 The default destination for the executable `masqmail' is /usr/sbin.
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
128 Check that it has the set-uid bit set. You can set it with:
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
129
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
130 chmod u+s /usr/sbin/masqmail
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
131
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
132 If you want to replace sendmail, move your old sendmail binary to
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
133 another name and make a symbolic link:
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
134
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
135 ln -s /usr/sbin/masqmail /usr/sbin/sendmail
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
136
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
137 Now every mailer that used to call sendmail will now call masqmail. You
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
138 can now kill your old sendmail if it is running and start masqmail.
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
139
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
140 /sbin/init.d/sendmail restart
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
141
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
142 should do that. You can also start masqmail with:
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
143
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
144 /usr/sbin/masqmail -bd -q30m
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
145
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
146
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
147
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
148 Configuring for online delivery
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
149 -------------------------------
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
150
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
151 (This section covers dial-up internet connections.)
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
152
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
153 Now you have to set up the online configuration. The trick is to tell
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
154 your ip-up script the connection name. You could use the IP number of
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
155 the far side of the ppp link, but this is a pain and may change each
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
156 time. But you can give it an additional argument via pppd with ipparam.
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
157 Somewhere in your dial up script you have a line similar to:
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
158
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
159 /usr/sbin/pppd /dev/ttyS1 connect "/usr/sbin/chat -t 90 -f $CHATFILE" \
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
160 -d -d -d user user@somewhere file "$OPTIONS"
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
161
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
162 Just add 'ipparam FastNet' in the command line for pppd if your ISP has
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
163 the name FastNet. The ip-up script will then get 'FastNet' as a sixth
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
164 parameter. In your ip-up script you can then call masqmail with
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
165
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
166 /usr/sbin/masqmail -qo "$6"
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
167
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
168 instead of 'sendmail -q', if you had that in the script before.
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
169 Masqmail will then read the route configuration specified for the
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
170 connection name 'FastNet' and deliver the mail destined to the internet.
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
171 See the configuration manual on how to write a route configuration or
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
172 use one of the examples as a template.
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
173
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
174 I do not know how do configure that for an ISDN adapter, but I am sure
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
175 you will find something similar in the man pages.
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
176
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
177 If you want mail that is received by masqmail from your local net to be
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
178 delivered immediately using the route configuration, you have two
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
179 possibilities:
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
180
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
181 * if you are using the masqdialer system, you just have to set the
92
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
182 variables online_detect to pipe and online_pipe to something like
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
183 /usr/bin/mservdetect localhost 222
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
184 if mserver is running on localhost and listens on port 222. See the
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
185 man page to mservdetect(1).
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
186
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
187 * otherwise you have to add two commands in your ip-up script:
92
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
188 echo "$6" >/var/run/masqmail/masqmail-route
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
189 chmod 644 /var/run/masqmail/masqmail-route
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
190 and you have to remove the file /var/run/masqmail/masqmail-route in
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
191 your ip-down script:
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
192 rm /var/run/masqmail/masqmail-route
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
193 Then you have to set online_detect to file and online_file to
92
10d00e3235f2 updated docs (online_file, mserver_iface)
meillo@marmaro.de
parents: 59
diff changeset
194 /var/run/masqmail/masqmail-route
59
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
195
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
196 See the route documentation for more.
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
197
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
198
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
199
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
200 Written by oku.
941413084f56 updated docs; moved files around
meillo@marmaro.de
parents: 0
diff changeset
201 Updated by meillo.