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