CVS: tmda/htdocs config-vars.ht, 1.40, 1.41 config-vars.html, 1.71, 1.72

"Jason R. Mastaler" <[email protected]>
Newsgroups gmane.mail.spam.tmda.cvs
Message-ID <[email protected]>
Update of /cvsroot/tmda/tmda/htdocs
In directory sc8-pr-cvs1:/tmp/cvs-serv18348/htdocs

Modified Files:
	config-vars.ht config-vars.html 
Log Message:
Change the default value for OUTGOINGMAIL to 'sendmail', and also
rename OUTGOINGMAIL to MAIL_TRANSPORT.  Rationale:

I made SMTP transport the default for OUTGOINGMAIL in the past for two
reasons:

1) Since our /usr/sbin/sendmail implementation went through the shell,
   there was a potential security risk with incoming mail.  If someone
   embedded the right shell commands in their Return-Path, they could
   get executed by TMDA inadvertently.

2) Argument quoting and escaping issues when TMDA tried to respond to
   a really malformed address that confused the shell.

However, the new implementation doesn't use the shell at all, so the
above problems should hopefully be non-issues.

In addition, there were the following problems with the SMTP
default:

a) qmail doesn't let localhost relay by default, so we get 1001
   questions on tmda-users first about why TMDA isn't sending any
   mail, and then about how to setup qmail's obscure relaying
   mechanism.  This is FAQ 3.3.  The user probably just ends up
   setting OUTGOINGMAIL to 'sendmail' to fix things.

b) With Sendmail/Postfix/Exim, if TMDA tries to respond to a bogus
   local address, the MTA refuses the transmission during the SMTP
   transaction resulting in an LOGFILE_DEBUG traceback.  This is FAQ
   3.7 essentially.  The user probably ends up setting OUTGOINGMAIL to
   'sendmail' to fix things.

Reversing the default should solve both of these issues, with no
additional problems created.

The name "OUTGOINGMAIL" proved non-intuitive and confusing, so
it is renamed to something less ambiguous.


Index: config-vars.ht
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-vars.ht,v
retrieving revision 1.40
retrieving revision 1.41
diff -u -r1.40 -r1.41
--- config-vars.ht	10 Oct 2003 03:29:39 -0000	1.40
+++ config-vars.ht	13 Oct 2003 19:33:25 -0000	1.41
@@ -129,12 +129,12 @@
 <td><a href="#MAIL_TRANSFER_AGENT">MAIL_TRANSFER_AGENT</a></td>
 </tr>
 <tr>
+<td><a href="#MAIL_TRANSPORT">MAIL_TRANSPORT</a></td>
 <td><a href="#MAX_AUTORESPONSES_PER_DAY">MAX_AUTORESPONSES_PER_DAY</a></td>
-<td><a href="#MESSAGE_FROM_STYLE">MESSAGE_FROM_STYLE</a></td>
 </tr>
 <tr>
+<td><a href="#MESSAGE_FROM_STYLE">MESSAGE_FROM_STYLE</a></td>
 <td><a href="#MESSAGE_TAG_HEADER_STYLE">MESSAGE_TAG_HEADER_STYLE</a></td>
-<td><a href="#OUTGOINGMAIL">OUTGOINGMAIL</a></td>
 </tr>
 <tr>
 <td><a href="#PENDING_BLACKLIST_APPEND">PENDING_BLACKLIST_APPEND</a></td>
@@ -985,6 +985,26 @@
 <br><br>
 Default is qmail
 <dt><hr>
+<a name="MAIL_TRANSPORT"><h4>MAIL_TRANSPORT</h4></a>
+<dd>
+Final delivery method for all outgoing mail (server and client).
+Possible values include:
+<br><br>
+"<code>smtp</code>"
+<blockquote>
+   Deliver messages by handing them off to an SMTP server (i.e,
+   smarthost).  Be sure that the "SMTPHOST" variable (see below) is
+   set correctly.
+</blockquote>
+<br>
+"<code>sendmail</code>"
+<blockquote>
+   Deliver messages via the command line interface to the sendmail
+   program (e.g, /usr/sbin/sendmail).
+</blockquote>
+<br>
+Default is "sendmail"
+<dt><hr>
 <a name="MAX_AUTORESPONSES_PER_DAY"><h4>MAX_AUTORESPONSES_PER_DAY</h4></a>
 <dd>
 An integer specifying the maximum number of automatic responses sent
@@ -1029,26 +1049,6 @@
 The valid values and default value is identical to that of
 MESSAGE_FROM_STYLE.
 <dt><hr>
-<a name="OUTGOINGMAIL"><h4>OUTGOINGMAIL</h4></a>
-<dd>
-Final delivery method for all outgoing mail (server and client).
-Possible values include:
-<br><br>
-"<code>smtp</code>"
-<blockquote>
-   Deliver messages by handing them off to an SMTP server (i.e,
-   smarthost).  Be sure that the "SMTPHOST" variable (see below) is
-   set correctly.
-</blockquote>
-<br>
-"<code>sendmail</code>"
-<blockquote>
-   Deliver messages via the command line interface to the sendmail
-   program (/usr/sbin/sendmail).
-</blockquote>
-<br>
-Default is "smtp"
-<dt><hr>
 <a name="PENDING_BLACKLIST_APPEND"><h4>PENDING_BLACKLIST_APPEND</h4></a>
 <dd>
 Filename to which a sender's e-mail address should be appended
@@ -1302,7 +1302,7 @@
 <a name="SENDMAIL_PROGRAM"><h4>SENDMAIL_PROGRAM</h4></a>
 <dd>
 The path to the sendmail program, or sendmail compatibility
-interface when OUTGOINGMAIL is "sendmail".
+interface when MAIL_TRANSPORT is "sendmail".
 <br><br>
 Defaults to one of the two standard locations.
 <dt><hr>
@@ -1332,7 +1332,7 @@
 <dt><hr>
 <a name="SMTPHOST"><h4>SMTPHOST</h4></a>
 <dd>
-SMTP host and optional port, when OUTGOINGMAIL is "smtp".
+SMTP host and optional port, when MAIL_TRANSPORT is "smtp".
 If the hostname or IP address ends with a colon (":") followed by a
 number, that suffix will be stripped off and the number interpreted
 as the port number to use.  Otherwise, the standard SMTP port (25)
@@ -1374,7 +1374,7 @@
 <a name="SMTP_MAX_SESSIONS_PER_CONNECTION"><h4>SMTP_MAX_SESSIONS_PER_CONNECTION</h4></a>
 <dd>
 An integer specifying a ceiling on the number of SMTP sessions to
-perform on a single socket connection, when OUTGOINGMAIL is
+perform on a single socket connection, when MAIL_TRANSPORT is
 "smtp".  Some MTAs have limits.  Set this to 0 to do as many
 as we like (i.e. your MTA has no limits).  Set this to some number
 great than 0 and TMDA will close the SMTP connection and re-open it

Index: config-vars.html
===================================================================
RCS file: /cvsroot/tmda/tmda/htdocs/config-vars.html,v
retrieving revision 1.71
retrieving revision 1.72
diff -u -r1.71 -r1.72
--- config-vars.html	11 Oct 2003 04:32:56 -0000	1.71
+++ config-vars.html	13 Oct 2003 19:33:25 -0000	1.72
@@ -1,7 +1,7 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 <html>
 <!-- THIS PAGE IS AUTOMATICALLY GENERATED.  DO NOT EDIT. -->
-<!-- Sat Oct 11 00:29:52 2003 -->
+<!-- Mon Oct 13 13:13:29 2003 -->
 <!-- USING HT2HTML 2.0 -->
 <!-- SEE http://ht2html.sf.net -->
 <!-- User-specified headers:
@@ -321,12 +321,12 @@
 <td><a href="#MAIL_TRANSFER_AGENT">MAIL_TRANSFER_AGENT</a></td>
 </tr>
 <tr>
+<td><a href="#MAIL_TRANSPORT">MAIL_TRANSPORT</a></td>
 <td><a href="#MAX_AUTORESPONSES_PER_DAY">MAX_AUTORESPONSES_PER_DAY</a></td>
-<td><a href="#MESSAGE_FROM_STYLE">MESSAGE_FROM_STYLE</a></td>
 </tr>
 <tr>
+<td><a href="#MESSAGE_FROM_STYLE">MESSAGE_FROM_STYLE</a></td>
 <td><a href="#MESSAGE_TAG_HEADER_STYLE">MESSAGE_TAG_HEADER_STYLE</a></td>
-<td><a href="#OUTGOINGMAIL">OUTGOINGMAIL</a></td>
 </tr>
 <tr>
 <td><a href="#PENDING_BLACKLIST_APPEND">PENDING_BLACKLIST_APPEND</a></td>
@@ -1177,6 +1177,26 @@
 <br><br>
 Default is qmail
 <dt><hr>
+<a name="MAIL_TRANSPORT"><h4>MAIL_TRANSPORT</h4></a>
+<dd>
+Final delivery method for all outgoing mail (server and client).
+Possible values include:
+<br><br>
+"<code>smtp</code>"
+<blockquote>
+   Deliver messages by handing them off to an SMTP server (i.e,
+   smarthost).  Be sure that the "SMTPHOST" variable (see below) is
+   set correctly.
+</blockquote>
+<br>
+"<code>sendmail</code>"
+<blockquote>
+   Deliver messages via the command line interface to the sendmail
+   program (e.g, /usr/sbin/sendmail).
+</blockquote>
+<br>
+Default is "sendmail"
+<dt><hr>
 <a name="MAX_AUTORESPONSES_PER_DAY"><h4>MAX_AUTORESPONSES_PER_DAY</h4></a>
 <dd>
 An integer specifying the maximum number of automatic responses sent
@@ -1221,26 +1241,6 @@
 The valid values and default value is identical to that of
 MESSAGE_FROM_STYLE.
 <dt><hr>
-<a name="OUTGOINGMAIL"><h4>OUTGOINGMAIL</h4></a>
-<dd>
-Final delivery method for all outgoing mail (server and client).
-Possible values include:
-<br><br>
-"<code>smtp</code>"
-<blockquote>
-   Deliver messages by handing them off to an SMTP server (i.e,
-   smarthost).  Be sure that the "SMTPHOST" variable (see below) is
-   set correctly.
-</blockquote>
-<br>
-"<code>sendmail</code>"
-<blockquote>
-   Deliver messages via the command line interface to the sendmail
-   program (/usr/sbin/sendmail).
-</blockquote>
-<br>
-Default is "smtp"
-<dt><hr>
 <a name="PENDING_BLACKLIST_APPEND"><h4>PENDING_BLACKLIST_APPEND</h4></a>
 <dd>
 Filename to which a sender's e-mail address should be appended
@@ -1494,7 +1494,7 @@
 <a name="SENDMAIL_PROGRAM"><h4>SENDMAIL_PROGRAM</h4></a>
 <dd>
 The path to the sendmail program, or sendmail compatibility
-interface when OUTGOINGMAIL is "sendmail".
+interface when MAIL_TRANSPORT is "sendmail".
 <br><br>
 Defaults to one of the two standard locations.
 <dt><hr>
@@ -1524,7 +1524,7 @@
 <dt><hr>
 <a name="SMTPHOST"><h4>SMTPHOST</h4></a>
 <dd>
-SMTP host and optional port, when OUTGOINGMAIL is "smtp".
+SMTP host and optional port, when MAIL_TRANSPORT is "smtp".
 If the hostname or IP address ends with a colon (":") followed by a
 number, that suffix will be stripped off and the number interpreted
 as the port number to use.  Otherwise, the standard SMTP port (25)
@@ -1566,7 +1566,7 @@
 <a name="SMTP_MAX_SESSIONS_PER_CONNECTION"><h4>SMTP_MAX_SESSIONS_PER_CONNECTION</h4></a>
 <dd>
 An integer specifying a ceiling on the number of SMTP sessions to
-perform on a single socket connection, when OUTGOINGMAIL is
+perform on a single socket connection, when MAIL_TRANSPORT is
 "smtp".  Some MTAs have limits.  Set this to 0 to do as many
 as we like (i.e. your MTA has no limits).  Set this to some number
 great than 0 and TMDA will close the SMTP connection and re-open it
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.