ossp-pkg/lmtp2nntp/INSTALL
1.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:
$ ./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:
virtusertable:
| @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.
