--- INSTALL 2001/09/13 12:57:49 1.5
+++ INSTALL 2001/09/13 13:45:12 1.6
@@ -1,67 +1,120 @@
-
-Sendmail Integration
-====================
-
-Create an cf/mailer/lmtp2nntp.m4 files with the following contents:
-______________________________________________________________________
-
-PUSHDIVERT(-1)
-_DEFIFNOT(`LMTP2NNTP_MAILER_PATH', `/usr/local/bin/lmtp2nntp')
-_DEFIFNOT(`LMTP2NNTP_MAILER_FLAGS', `mDFMuXz')
-_DEFIFNOT(`LMTP2NNTP_MAILER_ARGS', `')
-_DEFIFNOT(`LMTP2NNTP_MAILER_BINDADDR', '0.0.0.0')
-_DEFIFNOT(`LMTP2NNTP_MAILER_DELIVERYMODE', `post')
-_DEFIFNOT(`LMTP2NNTP_MAILER_GROUPMODE', `envelope')
-_DEFIFNOT(`LMTP2NNTP_MAILER_MAILFROM', `.+@(?:[^.]+\.)+\.[^.]+')
-_DEFIFNOT(`LMTP2NNTP_MAILER_NODENAME', `confDOMAIN_NAME')
-_DEFIFNOT(`LMTP2NNTP_MAILER_SIZE', `800000')
-_DEFIFNOT(`LMTP2NNTP_MAILER_LOGLEVEL', `notice:/var/log/lmtp2nntp')
-_DEFIFNOT(`LMTP2NNTP_MAILER_WAITTIME', `60')
-_DEFIFNOT(`LMTP2NNTP_MAILER_NEWSGROUP', `\*')
-POPDIVERT
-
-#########################################
-### LMTP2NNTP Mailer specification ###
-#########################################
-
-Mlmtp2nntp, P=LMTP2NNTP_MAILER_PATH, F=LMTP2NNTP_MAILER_FLAGS,
- S=EnvFromSMTP/HdrFromSMTP, R=MasqSMTP, E=\r\n,
- L=990, T=DNS/RFC822/SMTP, M=LMTP2NNTP_MAILER_MAX,
- A=lmtp2nntp LMTP2NNTP_MAILER_ARGS dnl
- -b LMTP2NNTP_MAILER_BINDADDR dnl
- -d LMTP2NNTP_MAILER_DELIVERYMODE dnl
- -g LMTP2NNTP_MAILER_GROUPMODE dnl
- -h $h dnl
- -m LMTP2NNTP_MAILER_MAILFROM dnl
- -n LMTP2NNTP_MAILER_NODENAME dnl
- -s LMTP2NNTP_MAILER_SIZE dnl
- -l LMTP2NNTP_MAILER_LOGLEVEL dnl
- -w LMTP2NNTP_MAILER_WAITTIME dnl
- LMTP2NNTP_MAILER_NEWSGROUP
-______________________________________________________________________
-
-Add to your sendmail.m4 (or sendmail.mc) the following entry:
-
-______________________________________________________________________
-
-dnl # Mailer: LMTP2NNTP (mail to news gateway)
-dnl define(`LMTP2NNTP_MAILER_PATH', `/path/to/your/lmtp2nntp')
-dnl MAILER(lmtp2nntp)
-______________________________________________________________________
-
-
-Add to your virtualusertable:
-______________________________________________________________________
-
-posting@gateway.example.com posting@lmtp2nntp.invalid
-posting+*@gateway.example.com %2@lmtp2nntp.invalid
-@news.example.com %1@lmtp2nntp.invalid
-______________________________________________________________________
+ _ _ ____ _
+ | |_ __ ___ | |_ _ __|___ \ _ __ _ __ | |_ _ __
+ | | '_ ` _ \| __| '_ \ __) | '_ \| '_ \| __| '_ \
+ | | | | | | | |_| |_) / __/| | | | | | | |_| |_) |
+ |_|_| |_| |_|\__| .__/_____|_| |_|_| |_|\__| .__/
+ |_| |_|
+
+ OSSP lmtp2nntp - Mail to News Gateway
+
+ INSTALLATION
+
+ To install OSSP lmtp2nntp into /path/to/lmtp2nntp/{bin,man}/ perform
+ the following steps in your shell:
+
+ $ ./configure --prefix=/path/to/lmtp2nntp
+ $ make
+ $ make check
+ $ 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.
+
+ Sendmail Integration
+
+ 1. Create a "cf/mailer/lmtp2nntp.m4" macro file with the following contents:
+
+ | PUSHDIVERT(-1)
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_PATH', `/usr/local/bin/lmtp2nntp')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_FLAGS', `mDFMuXz')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_ARGS', `')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_BINDADDR', '0.0.0.0')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_DELIVERYMODE', `post')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_GROUPMODE', `envelope')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_MAILFROM', `.+@(?:[^.]+\.)+\.[^.]+')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_NODENAME', `confDOMAIN_NAME')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_SIZE', `800000')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_LOGLEVEL', `notice:/var/log/lmtp2nntp')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_WAITTIME', `60')
+ | _DEFIFNOT(`LMTP2NNTP_MAILER_NEWSGROUP', `\*')
+ | POPDIVERT
+ |
+ | #########################################
+ | ### LMTP2NNTP Mailer specification ###
+ | #########################################
+ |
+ | Mlmtp2nntp, P=LMTP2NNTP_MAILER_PATH, F=LMTP2NNTP_MAILER_FLAGS,
+ | S=EnvFromSMTP/HdrFromSMTP, R=MasqSMTP, E=\r\n,
+ | L=990, T=DNS/RFC822/SMTP, M=LMTP2NNTP_MAILER_MAX,
+ | A=lmtp2nntp LMTP2NNTP_MAILER_ARGS dnl
+ | -b LMTP2NNTP_MAILER_BINDADDR dnl
+ | -d LMTP2NNTP_MAILER_DELIVERYMODE dnl
+ | -g LMTP2NNTP_MAILER_GROUPMODE dnl
+ | -h $h dnl
+ | -m LMTP2NNTP_MAILER_MAILFROM dnl
+ | -n LMTP2NNTP_MAILER_NODENAME dnl
+ | -s LMTP2NNTP_MAILER_SIZE dnl
+ | -l LMTP2NNTP_MAILER_LOGLEVEL dnl
+ | -w LMTP2NNTP_MAILER_WAITTIME dnl
+ | LMTP2NNTP_MAILER_NEWSGROUP
+
+ This changes nothing in your Sendmail configuration, but just adds
+ a new mailer named "lmtp2nntp" to Sendmail.
+
+ 2. Add to your Sendmail M4 configuration (file "sendmail.m4" or
+ "sendmail.mc" according to your installation) the following entry:
+
+ | dnl # Mailer: LMTP2NNTP (mail to news gateway)
+ | define(`LMTP2NNTP_MAILER_PATH', `/path/to/lmtp2nntp/bin/lmtp2nntp')
+ | MAILER(lmtp2nntp)
+
+ This defines the new "lmtp2nntp" mailer in your Sendmail
+ configuration, but still does not activate it. Additionally feel
+ free to overwrite more LMTP2NNTP_MAILER_XXXX variables in order
+ to adjust the run-time behaviour of OSSP lmtp2nntp. See the
+ lmtp2nntp(1) manual page for more details about the commmand line
+ parameters.
+
+ 3. 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:
+
+ virtusertable:
+
+ | posting+*@gateway.example.com %2@lmtp2nntp.invalid
+
+ mailertable:
+
+ | lmtp2nntp.invalid lmtp2nntp:news.example.com
+
+ Notice that we use the RFC2606 top-level domain name ".invalid"
+ for the internal mapping between virtual user table and the
+ mailer table. This is neccessary because Sendmail cannot directly
+ map individual recipient mailbox addresses to outgoing mailers.
+
+ In this example configrution we assumed that the machine
+ "gateway.example.com" is the FQDN of machine running Sendmail
+ and OSSP lmtp2nntp and "news.example.com" is the remote Usenet
+ News server speaking NNTP. This means that mails addressed to
+ "posting+foo.bar@gateway.example.com" are posted via NNTP as news
+ articles into the newsgroup foo.bar on "news.example.com".
+
+ Additionally, if just the MX DNS record for "news.example.com"
+ points to the address of "gateway.example.com" you can add the
+ following additional entry to your virtual user table in order
+ to let "news.example.com" virtually provide mail to news gateway
+ functionality:
-Add to your mailertable:
-______________________________________________________________________
+ virtusertable:
-lmtp2nntp.invalid lmtp2nntp:news.example.com
-______________________________________________________________________
+ | @news.example.com %1@lmtp2nntp.invalid
+
+ Notice that there are more delivery modes supported by OSSP
+ lmtp2nntp. Refer to the lmtp2nntp(1) manual page for more details.
|
