From 5ce9e938db92d8413100ea4d2558c33cd75e9171 Mon Sep 17 00:00:00 2001 From: rswindell <> Date: Tue, 14 Nov 2017 22:47:13 +0000 Subject: [PATCH] Document the new_message_text_filename (%n) and log_text_filename (%d) stuff added back in 2009 (mailsrvr.c, r1.459). --- ctrl/mailproc.ini | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/ctrl/mailproc.ini b/ctrl/mailproc.ini index baa16fb98d..3807ee92ce 100644 --- a/ctrl/mailproc.ini +++ b/ctrl/mailproc.ini @@ -12,12 +12,12 @@ ; 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. +; will be used as the 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, +; For a mail processor to only process mail received for specific name(s), ; 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". @@ -33,11 +33,15 @@ ; Each of the strings in these lists may use the Synchronet .can-style wildcards. +; The filenames referenced below may all be modified or created by the mail processor. + ; Additional (read-only) variables available to JavaScript mail processors: ; ; message_text_filename // filename contains complete message header and body +; new_message_text_filename // completely new message header and body (optional) ; 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 +; log_text_filename // an optional filename that if created will include debug log output ; 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") @@ -57,8 +61,10 @@ ; (native or JavaScript mail processor): ; ; %m mail message (header and body text) path/filename +; %n new message (header and body text) path/filename, in case you can't modify the original ; %l recipient list path/filename ; %e processing error path/filename (put error text in this file) +; %d processing debug log output path/filename ; ; %h sender's host name ; %i sender's IP address -- GitLab