--- lmtp2nntp.pod 2001/09/12 07:29:23 1.20
+++ lmtp2nntp.pod 2001/09/13 13:45:12 1.21
@@ -28,7 +28,7 @@
=head1 NAME
-B<lmtp2nntp> - mail to news gateway
+B<OSSP lmtp2nntp> - mail to news gateway
=head1 SYNOPSIS
@@ -47,15 +47,18 @@
=head1 DESCRIPTION
-The B<lmtp2nntp> program is a LMTP service which is usually invoked by a MTA.
-Input messages get their headers slightly reformatted to match network news
-article format. The article is then posted or fed into a NNTP service.
-Delivery must take place immediately or the transaction fails. A LMTP service
-relies on the queuing capabilities of its MTA. To support this, the program
-returns proper delivery status notification which indicates successful
-completed action, persistent transient failure or permanent failure.
+The B<OSSP lmtp2nntp> program is an LMTP service for use in conjunction
+with an MTA (like Sendmail), providing a reliable real-time mail to news
+gateway. Input messages get their headers slightly reformatted to match
+Usenet news article format. The article is then posted or feeded into
+a remote NNTP service (like INN). Delivery must take place immediately
+or the transaction fails. B<OSSP lmtp2nntp> relies on the queuing
+capabilities of the MTA in order to provide a fully reliable service.
+For this the program returns proper delivery status notification which
+indicates successful completed action, persistent transient failure or
+permanent failure.
-The following options are available:
+The following command line options and arguments are available:
=over 4
@@ -157,37 +160,11 @@
=back
-=head1 SENDMAIL INTEGRATION
-
-t.virtusertable
-
- # mail to news gateway
- posting+*@first.gateway.example %2@lmtp2nntp
-
-t.mailertable
-
- # mail to news gateway
- lmtp2nntp lmtp2nntp:second.gateway.example
-
-sendmail.m4
-
- dnl # Mailer: LMTP2NNTP (mail to news gateway)
- define(`LMTP2NNTP_MAILER_PATH', `confMYBINDIR/lmtp2nntp')
- define(`LMTP2NNTP_MAILER_MAX', `100000')
- define(`LMTP2NNTP_MAILER_DELIVERYMODE', `post')
- define(`LMTP2NNTP_MAILER_GROUPMODE', `envelope')
- define(`LMTP2NNTP_MAILER_ARGS', `-t confMYVARDIR/lmtp2nntp.log')
- define(`LMTP2NNTP_MAILER_GROUPS', `alt.test.\* alt.binaries.test')
- MAILER(lmtp2nntp)
-
=head1 DIAGNOSTICS
-when invoked as LMTP server
-
- 0 = successful execution
- 1 = execution failed
-
-Returning proper delivery status notification is part of the LMTP protocol.
+If invoked it returns 0 on successful execution (not neccessarily
+meaning successful delivery!) or 1 on failed execution. Returning proper
+delivery status notification is part of the LMTP protocol.
=head1 STANDARDS
@@ -264,13 +241,5 @@
=back
-=head1 AUTHOR
-
- The OSSP Project
- Cable & Wireless Deutschland GmbH
- Thomas Lotterer
- <thomas.lotterer@cw.com>
-
=cut
-
|
