4
4
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
5
5
<title> Postfix manual - relocated(5) </title>
7
RELOCATED(5) RELOCATED(5)
7
RELOCATED(5) RELOCATED(5)
10
relocated - format of Postfix relocated table
10
relocated - Postfix relocated table format
13
13
<b>postmap /etc/postfix/relocated</b>
16
The optional <b>relocated</b> table provides the information that
17
is used in "user has moved to <i>new</i><b>_</b><i>location</i>" bounce mes-
16
The optional <a href="relocated.5.html"><b>relocated</b>(5)</a> table provides the information
17
that is used in "user has moved to <i>new</i><b>_</b><i>location</i>" bounce
20
Normally, the <b>relocated</b> table is specified as a text file
21
that serves as input to the <a href="postmap.1.html"><b>postmap</b>(1)</a> command. The
20
Normally, the <a href="relocated.5.html"><b>relocated</b>(5)</a> table is specified as a text
21
file that serves as input to the <a href="postmap.1.html"><b>postmap</b>(1)</a> command. The
22
22
result, an indexed file in <b>dbm</b> or <b>db</b> format, is used for
23
23
fast searching by the mail system. Execute the command
24
<b>postmap /etc/postfix/relocated</b> in order to rebuild the
24
"<b>postmap /etc/postfix/relocated</b>" in order to rebuild the
25
25
indexed file after changing the relocated table.
27
27
When the table is provided via other means such as NIS,
83
84
description of regular expression lookup table syntax, see
84
85
<a href="regexp_table.5.html"><b>regexp_table</b>(5)</a> or <a href="pcre_table.5.html"><b>pcre_table</b>(5)</a>. For a description of the
85
86
TCP client/server table lookup protocol, see <b>tcp_table</b>(5).
87
This feature is not available up to and including Postfix
87
Each pattern is a regular expression that is applied to
90
Each pattern is a regular expression that is applied to
88
91
the entire address being looked up. Thus, <i>user@domain</i> mail
89
addresses are not broken up into their <i>user</i> and <i>@domain</i>
92
addresses are not broken up into their <i>user</i> and <i>@domain</i>
90
93
constituent parts, nor is <i>user+foo</i> broken up into <i>user</i> and
93
Patterns are applied in the order as specified in the
94
table, until a pattern is found that matches the search
96
Patterns are applied in the order as specified in the ta-
97
ble, until a pattern is found that matches the search
97
Results are the same as with indexed file lookups, with
98
the additional feature that parenthesized substrings from
100
Results are the same as with indexed file lookups, with
101
the additional feature that parenthesized substrings from
99
102
the pattern can be interpolated as <b>$1</b>, <b>$2</b> and so on.
101
104
<b>TCP-BASED TABLES</b>
102
This section describes how the table lookups change when
105
This section describes how the table lookups change when
103
106
lookups are directed to a TCP-based server. For a descrip-
104
tion of the TCP client/server lookup protocol, see
105
<b>tcp_table</b>(5). This feature is not available in Postfix
107
tion of the TCP client/server lookup protocol, see <b>tcp_ta-</b>
108
<b>ble</b>(5). This feature is not available up to and including
108
111
Each lookup operation uses the entire address once. Thus,
109
<i>user@domain</i> mail addresses are not broken up into their
112
<i>user@domain</i> mail addresses are not broken up into their
110
113
<i>user</i> and <i>@domain</i> constituent parts, nor is <i>user+foo</i> broken
111
114
up into <i>user</i> and <i>foo</i>.
113
116
Results are the same as with indexed file lookups.
116
The table format does not understand quoting conventions.
119
The table format does not understand quoting conventions.
118
121
<b>CONFIGURATION PARAMETERS</b>
119
The following <b>main.cf</b> parameters are especially relevant.
120
The text below provides only a parameter summary. See
121
<a href="postconf.5.html">postconf(5)</a> for more details including examples.
122
The following <b>main.cf</b> parameters are especially relevant.
123
The text below provides only a parameter summary. See
124
<a href="postconf.5.html"><b>postconf</b>(5)</a> for more details including examples.
123
126
<b><a href="postconf.5.html#relocated_maps">relocated_maps</a></b>
124
127
List of lookup tables for relocated users or sites.
126
129
Other parameters of interest:
128
131
<b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a></b>
129
The network interface addresses that this system
132
The network interface addresses that this system
130
133
receives mail on. You need to stop and start Post-
131
134
fix when this parameter changes.
133
136
<b><a href="postconf.5.html#mydestination">mydestination</a></b>
134
List of domains that this mail system considers
137
List of domains that this mail system considers
137
140
<b><a href="postconf.5.html#myorigin">myorigin</a></b>