.TH s/qmail: srsforward 1
.SH NAME
srsforward \- forward mail to one or more addresses including a SRS extension
.SH SYNOPSIS
in
.BR .qmail :
.B |srsforward
.I address ...
.SH DESCRIPTION
.B srsforward
forwards mails for dedicated recipient
.I 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
.B 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.
.SH "CONTROL FILE"
.B srsforward 
reads the control file 
.IR srsdomains .
Here, you can specify 

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

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

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

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

.B srsforward
may include
.I srsaddress
to construct the domain part of the RCPT TO:
envelope address for SRS fowarded mails. If 
.I srsaddress 
ends with a dot '.',
this name is used to prepend the original 
host name and typically is chosen as
.IR srs. .
Otherwise, the original host name is
used as default 
.I srsaddress 
for forwarding and also relevant for 
potential bounces being subject of
.BR srsreverse .
.SH "ENVIRONMENT VARIABLES"
.B srsforward
reads the environment variables
.IR HOST ,
which is used to determine the 
.IR srsdomain ,
.IR DTLINE ,
and 
.IR NEWSENDER .
.SH REFERENCE
.B srsforward 
uses srs2.c from 
.IR libsrs2 .
.SH "SEE ALSO"
srsreverse(1),
dot-qmail(5),
qmail-command(8),
qmail-queue(8), 
qmail-send(8).