X-Git-Url: https://git.distorted.org.uk/~mdw/qmail/blobdiff_plain/5794b37af853f8e487dc5f7c2a83220b3899f596..d708ae5acbf10e579a5e3ea104561ce3fa6f7e13:/dot-qmail.9?ds=sidebyside

diff --git a/dot-qmail.9 b/dot-qmail.9
index 4fa1358..651726a 100644
--- a/dot-qmail.9
+++ b/dot-qmail.9
@@ -39,7 +39,28 @@ A comment line begins with a number sign:
 .EE
 
 .B qmail-local
-ignores the line.
+ignores the line.  However,
+.BR qmail-valid-addresses (8)
+interprets some markers in comments.  If the first line of a
+.B .qmail
+file begins `#!' then the address (or addresses) controlled by the file
+are considered invalid, and any attempt to send to them is refused by
+.BR qmail-smtpd (8).
+(Note: This doesn't prevent local users sending mail directly.  This
+feature can therefore be used to experiment with mail rules before
+allowing the entire Internet to break them.)  If the first line of a
+.B .qmail
+file begins `#?' then 
+.BR qmail-smtpd (8)
+will consult a Userv service
+.BI addrcheck: ext
+to decide whether addresses matched by the extension
+.I ext
+are valid.  The service is passed many arguments, though the first two
+are the most interesting.  The first is the local-part tail (i.e., the
+bit that matched
+.BR default )
+and the second is the envelope sender.
 .TP 5
 (2)
 A program line begins with a vertical bar:
@@ -152,6 +173,25 @@ It reliably stores the incoming message in that directory.
 See
 .B maildir(5)
 for more details.
+.TP 5
+(6)
+An
+.I sender
+line begins with a less-than-sign `<'.  The remainder of the line is set
+as the new envelope sender for any forwarding done through this file.
+.TP 5
+(7)
+An
+.I environment
+line begins with an exclamation mark `!'.  If the remainder of the line
+has the form
+.IB var = value
+then the environment variable
+.I var
+is set to 
+.I value
+for the following program deliveries.  If there is no equals sign, the
+named environment variable is deleted.
 .PP
 If
 .B .qmail