masqmail

view docs/simple-local-setup @ 392:c5fd796ea06e

Heavy refactoring in parts of conf.c. init_conf() parse_boolean() parse_list_file() Re-arrangement of code. parse_address_glob_list() Removed unneccessary parameter. parse_list() parse_interface(): Use strtok()/strchr() instead of doing is all by hand. Removed limitation of fixed size buffer. eat_comments() Use a state machine. eat_line_trailing() eat_spaces() read_lval() Better structured code. read_conf() read_route() Removed magic numbers. Made all list type in the config files accept pathname entries, except for `permanent_routes' and `query_routes.' for which this is impossible.
author markus schnalke <meillo@marmaro.de>
date Sat, 18 Feb 2012 18:07:55 +0100
parents 72653295b75d
children
line source
1 Simple Setup
2 ============
4 You want
5 --------
7 - submit mail on stdin by calling masqmail on the commandline
8 - submit mail with SMTP from the local machine
9 - let masqmail deliver mail locally to the system mailboxes /var/mail/*
11 You have luck, because this is what masqmail does by default.
14 Set up
15 ------
17 Follow the description in INSTALL.
19 Most times it's simply:
21 ./configure
24 Configuration
25 -------------
27 You just need a minimal config file, having one line:
29 host_name = "foo.example.org"
31 (Substitute a real value, of course.)
34 Starting the daemon
35 -------------------
37 Listening for SMTP connections on a port requires masqmail to run as
38 daemon. You probably want to start masqmail as daemon each time the
39 system comes up. How you have to do that is system dependent.
40 /etc/rc.local is a good try to add the daemon call, because this file
41 seems to be frequently available.
43 /usr/local/sbin/masqmail -bd -q10m
45 This starts masqmail in daemon mode and does a queue run every ten
46 minutes.
49 Check the setup
50 ---------------
52 Ensure you have the sendmail links correct:
54 $ ls -l /usr/lib/sendmail /usr/sbin/sendmail
55 lrwxrwxrwx 1 root root 25 2010-03-06 13:50 /usr/lib/sendmail -> /usr/local/sbin/masqmail*
56 lrwxrwxrwx 1 root root 25 2010-03-06 13:50 /usr/sbin/sendmail -> /usr/local/sbin/masqmail*
58 Send a mail to yourself:
60 $ echo "some text" | mail `whoami`
62 Check if the mail was delivered (then delete it and quit):
64 $ mail
65 Mail version 8.1.2 01/15/2001. Type ? for help.
66 "/var/mail/meillo": 1 message 1 new
67 >N 1 meillo@serveme.sc Wed Jul 14 22:50 13/467
68 & p
69 Message 1:
70 From <meillo@serveme.schnalke.local> Wed Jul 14 22:50:13 2010
71 Envelope-to: <meillo@serveme.schnalke.local>
72 To: meillo
73 From: <meillo@serveme.schnalke.local>
74 Date: Wed, 14 Jul 2010 22:50:13 +0200
76 some text
78 & d
79 & q
82 In case of problems
83 -------------------
85 Have a look at the log file: /var/log/masqmail/masqmail.log
87 Set the debug level in masqmail.conf, restart the daemon, redo the
88 test, and look at the debug file: /var/log/masqmail/debug.log
90 Ask on the mailing list: <masqmail@marmaro.de>
94 meillo