Many updates covering the recent improvements to the mailproc support.

ctrl/mailproc.ini

@@ -8,34 +8,47 @@
 ; slightly different (and less flexible) format.
 
 ; Each mail processor is specified in a separate "section", comprised of the
-; mail processor command-line enclosed in square brackets ("[]"), followed by
-; a list of optional "key = value" pairs.
+; mail processor name (or command-line) enclosed in square brackets ("[]"), 
+; followed by a list of optional "key = value" pairs.
+
+; If no "Eval" or "Command" key value is specified, the mail processor name
+; will be used as teh command-line to execute.
 
 ; Non-JavaScript mail processors (i.e. native executables), must have the 
 ; "native" key set to "true" (e.g. "native = true").
 
 ; For a mail processor to only process mail received for a specific name,
-; it must have a "to" key with a comma-separated list of destination names.
-; Example: "to = listserver, listserv" would cause a mail processor to only
+; it must have a "To" key with a comma-separated list of destination names.
+; Example: "To = listserver, listserv" would cause a mail processor to only
 ; process mail received for either "listserver" or "listserv".
-; If no "to" value is specified, then the mail processor will process *all*
+; If no "To" value is specified, then the mail processor will process *all*
 ; incoming (SMTP) e-mail messages.
-; If a "to" value is specified, but is not a valid user, then the "passthru"
-; key must be set to "true" or the mail may be rejected or forwarded
-; (depending on the system configuration).
+; If a "To" value is specified, but is not a valid user name, then the 
+; "PassThru" key must be set to "true" or the mail may be rejected or
+; forwarded (depending on the system configuration).
 
-; Additional variables available to JavaScript mail processors:
-;
-;     message_text_filename
-;     recipient_list_filename
-;     processing_error_filename
-;     sender_name
-;     sender_address
-;     reverse_path
+; Additional (read-only) variables available to JavaScript mail processors:
 ;
-;     See exec/mailproc_util.js and exec/listserver.js for example use.
+;     message_text_filename			// filename contains complete message header and body
+;     recipient_list_filename		// list of all SMTP recipients for this message (.ini format)
+;     processing_error_filename		// a filename that if created will reject this message with an SMTP error
+;     hello_name					// the "HELO" name specified by the sender during the SMTP session
+;     sender_name					// the name of the sender, possibly the same as the sender_address
+;     sender_address				// sender's email address (e.g. "user@domain.com")
+;     reverse_path					// sender's SMTP reverse-path from SMTP envelope (e.g. "<user@domain.com>")
+;     recipient_address				// last specified recipient in SMTP session (e.g. "you@your.host.com")
 ;
-; Command-line specifiers (variables) available for use in command-lines:
+;     See exec/mailproc_util.js and exec/listserver.js for example uses.
+
+; JavaScript mail processors may be implemented as either a single "Eval"
+; string or an external JavaScript file (e.g. *.js).
+
+; External JavaScript mail processors (.js files) are loaded from the "mods"
+; or "exec" directory if no path is specified on the command-line. 
+; If no file extension is specified on the command-line, ".js" is assumed.
+
+; Command-line specifiers (variables) available for use in command-lines
+; (native or JavaScript mail processor):
 ;
 ;     %m mail message (header and body text) path/filename
 ;     %l recipient list path/filename
@@ -43,10 +56,11 @@
 ;
 ;     %h sender's host name
 ;     %i sender's IP address
-;     %s sender's name (portion of e-mail address)
-;     %a sender's address (portion of e-mail address)
+;     %s sender's name
+;     %a sender's address
 ;     %u sender's user number (0 if unauthenticated)
 ;     %r reverse path (of SMTP "envelope")
+;     %t recipient's address (from SMTP "envelope")
 ;
 ;     %! exec dir
 ;     %g temp dir
@@ -65,10 +79,18 @@
 ; PassThru = true
 ; Native = false
 ; IgnoreOnError = false
-; To = 
-; AccessRequirements =
+; To = <none>
+; AccessRequirements = <none>
+; Command = [section_name]
+; Eval = <none>
+
+[MailAuth]
+	Command=mailauth.js
+	AccessRequirements=user equal 0 or guest
+	Disabled=false
 
-[listserver.js]
-	To = listserver, listserv
-	Passthru = false
-	Disabled = false
\ No newline at end of file
+[ListServer]
+	Command=listserver.js
+	To=listserver, listserv
+	PassThru=false
+	Disabled=false