~ubuntu-branches/ubuntu/raring/postfix/raring

« back to all changes in this revision

Viewing changes to html/relocated.5.html

Tags: upstream-2.2.6
ImportĀ upstreamĀ versionĀ 2.2.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
5
5
<title> Postfix manual - relocated(5) </title>
6
6
</head> <body> <pre>
7
 
RELOCATED(5)                                         RELOCATED(5)
 
7
RELOCATED(5)                                                      RELOCATED(5)
8
8
 
9
9
<b>NAME</b>
10
 
       relocated - format of Postfix relocated table
 
10
       relocated - Postfix relocated table format
11
11
 
12
12
<b>SYNOPSIS</b>
13
13
       <b>postmap /etc/postfix/relocated</b>
14
14
 
15
15
<b>DESCRIPTION</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-
18
 
       sages.
 
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
 
18
       messages.
19
19
 
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.
26
26
 
27
27
       When the table is provided via other means  such  as  NIS,
54
54
              line  that starts with whitespace continues a logi-
55
55
              cal line.
56
56
 
 
57
<b>TABLE SEARCH ORDER</b>
57
58
       With lookups from indexed files such as DB or DBM, or from
58
59
       networked  tables  such  as NIS, LDAP or SQL, patterns are
59
60
       tried in the order as listed below:
67
68
              in $<b><a href="postconf.5.html#inet_interfaces">inet_interfaces</a></b> or $<b><a href="postconf.5.html#proxy_interfaces">proxy_interfaces</a></b>.
68
69
 
69
70
       @<i>domain</i>
70
 
              Matches  every address in <i>domain</i>. This form has the
71
 
              lowest precedence.
 
71
              Matches  other  addresses  in <i>domain</i>. This form has
 
72
              the lowest precedence.
72
73
 
73
74
<b>ADDRESS EXTENSION</b>
74
75
       When a mail address localpart contains the optional recip-
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
 
88
       version 2.2.
86
89
 
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
91
94
       <i>foo</i>.
92
95
 
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
95
98
       string.
96
99
 
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.
100
103
 
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
106
 
       version 2.1.
 
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
 
109
       Postfix version 2.2.
107
110
 
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>.
112
115
 
113
116
       Results are the same as with indexed file lookups.
114
117
 
115
118
<b>BUGS</b>
116
 
       The table format does not understand quoting  conventions.
 
119
       The  table format does not understand quoting conventions.
117
120
 
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.
122
125
 
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:
127
130
 
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.
132
135
 
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
135
138
              local.
136
139
 
137
140
       <b><a href="postconf.5.html#myorigin">myorigin</a></b>
152
155
       <a href="ADDRESS_REWRITING_README.html">ADDRESS_REWRITING_README</a>, address rewriting guide
153
156
 
154
157
<b>LICENSE</b>
155
 
       The  Secure  Mailer  license must be distributed with this
 
158
       The Secure Mailer license must be  distributed  with  this
156
159
       software.
157
160
 
158
161
<b>AUTHOR(S)</b>
161
164
       P.O. Box 704
162
165
       Yorktown Heights, NY 10598, USA
163
166
 
164
 
                                                     RELOCATED(5)
 
167
                                                                  RELOCATED(5)
165
168
</pre> </body> </html>