SYNOPSIS

       in .qmail: |srsforward address ...

DESCRIPTION

       srsforward forwards mails for dedicated recipient srsdomains to the
       specified list of addresses while extending the SMTP 'RCPT TO:'
       envelope address with SRS (Sender Rewriting Scheme) information.  It is
       a simple wrapper around qmail-queue rewriting the SMTP recipient
       address. The forwarded email ought to be acceptable for SPF enabled
       recipient MTAs.  Additionally, it mitigates the forgery of addresses
       for bounces.

CONTROL FILE

       srsforward reads the control file srsdomains.  Here, you can specify

       srsdomain:SRS_secret1 SRS_secret2 ...|[+,-,=]|[srsaddress(.)]

       srsdomain is s/qmail's recipient domain; typically defaultdomain or any
       domain given in rcpthosts.  srsdomain can be simply expressed as '*',
       thus the following informations are applicable for all srsfoward
       domains as default values, while particular srsdomain settings have
       precedence.  Reversely, recipient domains can be disable for SRS
       fowarding: !nosrsfoward.example.com:.

       srsforward accepts several 'secrets' for each srsdomain separated by
       empty spaces.

       srsfoward's delimiter is a character chosen out of the set +,-,= with
       default = and thus is optional.

       srsforward may include srsaddress to construct the domain part of the
       RCPT TO: envelope address for SRS fowarded mails. If srsaddress ends
       with a dot '.', this name is used to prepend the original host name and
       typically is chosen as srs..  Otherwise, the original host name is used
       as default srsaddress for forwarding and also relevant for potential
       bounces being subject of srsreverse.

ENVIRONMENT VARIABLES

       srsforward reads the environment variables HOST, which is used to
       determine the srsdomain, DTLINE, and NEWSENDER.

REFERENCE

       srsforward uses srs2.c from libsrs2.

SEE ALSO

       srsreverse(1), dot-qmail(5), qmail-command(8), qmail-queue(8), qmail-
       send(8).



                                       1                  s/qmail:(srsforward)