1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
.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).
|
