--- INSTALL 2001/10/11 09:35:39 1.9
+++ INSTALL 2001/10/13 13:45:11 1.10
@@ -9,6 +9,7 @@
OSSP lmtp2nntp - Mail to News Gateway
INSTALLATION
+ ============
To install OSSP lmtp2nntp into /path/to/lmtp2nntp/{bin,man}/ perform
the following steps in your shell:
@@ -19,14 +20,17 @@
$ make install
CONFIGURATION
+ =============
In order to use OSSP lmtp2nntp, the program has to be integrated into
a Mail Transfer Agent (MTA) which speaks Local Mail Transfer Protocol
- (LMTP). OSSP lmtp2nntp was developed with Sendmail 8.11, but should
- also work with other MTAs who provide an LMTP interface. The detailed
- integration into Sendmail 8.11 is shown below.
+ (LMTP). OSSP lmtp2nntp was developed with Sendmail 8.11 and tested
+ with Sendmail 8.11 and Postfix 20010228, but should also work with
+ other MTAs who provide an LMTP interface. The detailed integration
+ into Sendmail 8.11 and Postfix 20010228 is shown below.
Sendmail Integration
+ --------------------
1. Create a "cf/mailer/lmtp2nntp.m4" macro file with the following contents:
@@ -70,6 +74,8 @@
2. Add to your Sendmail M4 configuration (file "sendmail.m4" or
"sendmail.mc" according to your installation) the following entry:
+ sendmail.m4:
+
| dnl # Mailer: LMTP2NNTP (mail to news gateway)
| define(`LMTP2NNTP_MAILER_PATH', `/path/to/lmtp2nntp/bin/lmtp2nntp')
| MAILER(lmtp2nntp)
@@ -81,7 +87,16 @@
lmtp2nntp(1) manual page for more details about the commmand line
parameters.
- 3. Add the following entries to both your virtual user table (file
+ 3. Activate in your Sendmail M4 configuration (file "sendmail.m4" or
+ "sendmail.mc" according to your installation) the virtual user
+ and mailer table:
+
+ sendmail.m4:
+
+ | FEATURE(mailertable, `hash -o /path/to/mailertable')
+ | FEATURE(virtusertable, `hash -o /path/to/virtusertable')
+
+ 4. Add the following entries to both your virtual user table (file
"virtusertable") and your mailer table (file "mailertable") in order
to finally activate the mail to news gateway:
@@ -118,3 +133,85 @@
Notice that there are more delivery modes supported by OSSP
lmtp2nntp. Refer to the lmtp2nntp(1) manual page for more details.
+ Postfix Integration
+ -------------------
+
+ 1. Make sure that Postfix was built with PCRE map support
+ (see README.PCRE in the original Postfix source distribution).
+ It basically means building and installing PCRE from
+ ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/ and
+ configuring Postfix with at least:
+
+ | make makefiles \
+ | CCARGS="-I/path/to/pcre/include -DHAS_PCRE"
+ | AUXLIBS="-L/path/to/pcre/lib -lpcre"
+
+ 2. In the Postfix main configuration file (main.cf) you have
+ enable the virtual user and transport mapping tables:
+
+ main.cf:
+
+ | virtual_maps = pcre:/path/to/virtual
+ | transport_maps = hash:/path/to/transport
+
+ 3. Add the following entry to the Postfix virtual user mapping table:
+
+ /path/to/virtual:
+
+ | /^posting\+(.*)@gateway\.example\.com$/ $1@lmtp2nntp.invalid
+
+ 4. Add the following entry to the Postfix transport mapping table:
+
+ /path/to/transport:
+
+ | lmtp2nntp.invalid lmtp:unix:/path/to/lmtp2nntp.news.example.com
+
+ Additionally convert the transport mapping table into the hash
+ table format Postfix reads (not required for the virtual user
+ mapping table above, because it is PCRE based).
+
+ $ postmap /path/to/transport
+
+ 5. Start lmtp2nntp as a stand-alone daemon for delivering to
+ news.example.com. This is required because in contrast to Sendmail,
+ Postfix can speak LMTP only via Unix Domain and Internet Domain
+ sockets (but not via a Unix pipe). Use the following script:
+
+ lmtp2nntpd:
+
+ | #!/bin/sh
+ | LMTP2NNTP_PATH='/usr/local/bin/lmtp2nntp'
+ | LMTP2NNTP_ARGS=''
+ | LMTP2NNTP_CLIENTBIND='/path/to/lmtp2nntp.news.example.com'
+ | LMTP2NNTP_GROUPMODE='envelope'
+ | LMTP2NNTP_LOGLEVEL='notice:/var/log/lmtp2nntp'
+ | LMTP2NNTP_MAILFROM='^.+@(?:[^.]+\.)+[^.]+$'
+ | LMTP2NNTP_NODENAME=`hostname`
+ | LMTP2NNTP_OPERATIONMODE='post'
+ | LMTP2NNTP_SIZE='800000'
+ | LMTP2NNTP_TIMEOUT='nntp:connect=60'
+ | LMTP2NNTP_NEWSGROUP='*'
+ | case $1 in
+ | start )
+ | $LMTP2NNTP_PATH -D -P "/path/to/lmtp2nntp.pid" \
+ | -c "$LMTP2NNTP_CLIENTBIND" \
+ | -d "news.example.com" \
+ | -g "$LMTP2NNTP_GROUPMODE" \
+ | -l "$LMTP2NNTP_LOGLEVEL" \
+ | -m "$LMTP2NNTP_MAILFROM" \
+ | -n "$LMTP2NNTP_NODENAME" \
+ | -o "$LMTP2NNTP_OPERATIONMODE" \
+ | -s "$LMTP2NNTP_SIZE" \
+ | -t "$LMTP2NNTP_TIMEOUT" \
+ | "$LMTP2NNTP_NEWSGROUP"
+ | ;;
+ | stop )
+ | $LMTP2NNTP_PATH -K -P "/path/to/lmtp2nntp.pid"
+ | ;;
+ | esac
+
+ 5. start lmtp2nntp daemon and reload Postfix to activate the new setup:
+
+ $ lmtp2nntpd start
+ $ postfix reload
+
|
