Debian Codegraph @

test/testroot/etc/mail/virtusertable

raw
1 # A domain-specific form of aliasing, allowing multiple virtual domains to be
2 # hosted on one machine.
3 #
4 # [email protected] foo-info
5 # [email protected] bar-info
6 # [email protected] error:nouser 550 No such user here
7 # [email protected] error:5.7.0:550 Address invalid
8 # @baz.org [email protected]
9 #
10 # then mail addressed to [email protected] will be sent to the address foo-info,
11 # mail addressed to [email protected] will be delivered to bar-info, and mail
12 # addressed to anyone at baz.org will be sent to [email protected], mail to
13 # [email protected] will be rejected with the specified error message, and mail to
14 # [email protected] will also have a RFC 1893 compliant error code 5.7.0.
15 #
16 # The username from the original address is passed as %1 allowing:
17 #
18 # @foo.org %[email protected]
19 #
20 # Additionally, if the local part consists of "user+detail" then "detail" is
21 # passed as %2 and "+detail" is passed as %3 when a match against user+* is
22 # attempted, so entries like
23 #
24 # old+*@foo.org new+%[email protected]
25 # gen+*@foo.org %[email protected]
26 # +*@foo.org %1%[email protected]
27 # [email protected] Z%[email protected]
28 # @bar.org %1%3
29 #
30 # Note: to preserve "+detail" for a default case (@domain) %1%3 must be used
31 # as RHS. There are two wildcards after "+": "+" matches only a non-empty
32 # detail, "*" matches also empty details, e.g., [email protected] matches#
33 # +*@foo.org but not [email protected]. This can be used to ensure that the
34 # parameters %2 and %3 are not empty.
35 #
36 # All the host names on the left hand side (foo.com, bar.com, and baz.org)
37 # must be in class {w} or class {VirtHost}. The latter can be defined by the
38 # macros VIRTUSER_DOMAIN or VIRTUSER_DOMAIN_FILE (analogously to
39 # MASQUERADE_DOMAIN and MASQUERADE_DOMAIN_FILE). If VIRTUSER_DOMAIN or
40 # VIRTUSER_DOMAIN_FILE is used, then the entries of class {VirtHost} are
41 # added to class {R}, i.e., relaying is allowed to (and from) those domains.