rewriting(5)

NAME
rewriting - syntactic changes to mail-address host names

DESCRIPTION
new-inject and ofmipd support a generic rewriting system for Internet mail addresses. Each host name is transformed according to a series of instructions, as described here. The instructions are followed in order, each at most once. An instruction is either =post:new, *post:new, ?post:new, or -post:new. =post:new means that the host name post is replaced by new. *post:new means that any host name of the form prepost is replaced by prenew. ?post:new means that any host name of the form prepost, where pre does not contain dots or brackets, is replaced by prenew. -post:new means that any host name of the form prepost is replaced by new. For example, the instruction *.: removes a trailing dot if there is one; =:vangogh converts an empty host name into vangogh; ?:.cs.b adds .cs.b to any host name without dots or brackets; *.b:.berkeley.edu changes vangogh.cs.b into vangogh.cs.berkeley.edu; -.local:cs.berkeley.edu converts me.local into cs.berkeley.edu.

INSTRUCTION SOURCES
Rewriting instructions are normally listed in the rewrite control file, one instruction per line. If rewrite does not exist, new-inject and ofmipd use the control files defaultdomain, defaulthost, and plusdomain in the following instructions:
       *.:
       =:defaulthost
       *+:.plusdomain
       ?:.defaultdomain
In other words: (1) If the host name ends with a dot, remove the dot. (2) If the host name is empty, add defaulthost. (3) If the host name ends with a plus sign, change the plus sign to a dot and add plusdomain. (4) If the host name does not contain dots or brackets, add a dot and add defaultdomain. The defaultdomain, defaulthost, and plusdomain control files can be overridden by the environment variables $QMAILDEFAULTDOMAIN, $QMAILDEFAULTHOST, and $QMAILPLUSDOMAIN respectively. They all default to me.

SEE ALSO
new-inject(1), rewritehost(3), qmail-control(5), ofmipd(8)