1#++ 2# NAME 3# relocated 5 4# SUMMARY 5# Postfix relocated table format 6# SYNOPSIS 7# \fBpostmap /etc/postfix/relocated\fR 8# DESCRIPTION 9# The optional \fBrelocated\fR(5) table provides the information that is 10# used in "user has moved to \fInew_location\fR" bounce messages. 11# 12# Normally, the \fBrelocated\fR(5) table is specified as a text file 13# that serves as input to the \fBpostmap\fR(1) command. 14# The result, an indexed file in \fBdbm\fR or \fBdb\fR format, 15# is used for fast searching by the mail system. Execute the command 16# "\fBpostmap /etc/postfix/relocated\fR" to rebuild an indexed 17# file after changing the corresponding relocated table. 18# 19# When the table is provided via other means such as NIS, LDAP 20# or SQL, the same lookups are done as for ordinary indexed files. 21# 22# Alternatively, the table can be provided as a regular-expression 23# map where patterns are given as regular expressions, or lookups 24# can be directed to a TCP-based server. In those case, the lookups 25# are done in a slightly different way as described below under 26# "REGULAR EXPRESSION TABLES" or "TCP-BASED TABLES". 27# 28# Table lookups are case insensitive. 29# CASE FOLDING 30# .ad 31# .fi 32# The search string is folded to lowercase before database 33# lookup. As of Postfix 2.3, the search string is not case 34# folded with database types such as regexp: or pcre: whose 35# lookup fields can match both upper and lower case. 36# TABLE FORMAT 37# .ad 38# .fi 39# The input format for the \fBpostmap\fR(1) command is as follows: 40# .IP \(bu 41# An entry has one of the following form: 42# 43# .nf 44# \fIpattern new_location\fR 45# .fi 46# 47# Where \fInew_location\fR specifies contact information such as 48# an email address, or perhaps a street address or telephone number. 49# .IP \(bu 50# Empty lines and whitespace-only lines are ignored, as 51# are lines whose first non-whitespace character is a `#'. 52# .IP \(bu 53# A logical line starts with non-whitespace text. A line that 54# starts with whitespace continues a logical line. 55# TABLE SEARCH ORDER 56# .ad 57# .fi 58# With lookups from indexed files such as DB or DBM, or from networked 59# tables such as NIS, LDAP or SQL, patterns are tried in the order as 60# listed below: 61# .IP \fIuser\fR@\fIdomain\fR 62# Matches \fIuser\fR@\fIdomain\fR. This form has precedence over all 63# other forms. 64# .IP \fIuser\fR 65# Matches \fIuser\fR@\fIsite\fR when \fIsite\fR is $\fBmyorigin\fR, 66# when \fIsite\fR is listed in $\fBmydestination\fR, or when \fIsite\fR 67# is listed in $\fBinet_interfaces\fR or $\fBproxy_interfaces\fR. 68# .IP @\fIdomain\fR 69# Matches other addresses in \fIdomain\fR. This form has the lowest 70# precedence. 71# ADDRESS EXTENSION 72# .fi 73# .ad 74# When a mail address localpart contains the optional recipient delimiter 75# (e.g., \fIuser+foo\fR@\fIdomain\fR), the lookup order becomes: 76# \fIuser+foo\fR@\fIdomain\fR, \fIuser\fR@\fIdomain\fR, \fIuser+foo\fR, 77# \fIuser\fR, and @\fIdomain\fR. 78# REGULAR EXPRESSION TABLES 79# .ad 80# .fi 81# This section describes how the table lookups change when the table 82# is given in the form of regular expressions or when lookups are 83# directed to a TCP-based server. For a description of regular 84# expression lookup table syntax, see \fBregexp_table\fR(5) or 85# \fBpcre_table\fR(5). For a description of the TCP client/server 86# table lookup protocol, see \fBtcp_table\fR(5). 87# This feature is available in Postfix 2.5 and later. 88# 89# Each pattern is a regular expression that is applied to the entire 90# address being looked up. Thus, \fIuser@domain\fR mail addresses are not 91# broken up into their \fIuser\fR and \fI@domain\fR constituent parts, 92# nor is \fIuser+foo\fR broken up into \fIuser\fR and \fIfoo\fR. 93# 94# Patterns are applied in the order as specified in the table, until a 95# pattern is found that matches the search string. 96# 97# Results are the same as with indexed file lookups, with 98# the additional feature that parenthesized substrings from the 99# pattern can be interpolated as \fB$1\fR, \fB$2\fR and so on. 100# TCP-BASED TABLES 101# .ad 102# .fi 103# This section describes how the table lookups change when lookups 104# are directed to a TCP-based server. For a description of the TCP 105# client/server lookup protocol, see \fBtcp_table\fR(5). 106# This feature is available in Postfix 2.5 and later. 107# 108# Each lookup operation uses the entire address once. Thus, 109# \fIuser@domain\fR mail addresses are not broken up into their 110# \fIuser\fR and \fI@domain\fR constituent parts, nor is 111# \fIuser+foo\fR broken up into \fIuser\fR and \fIfoo\fR. 112# 113# Results are the same as with indexed file lookups. 114# BUGS 115# The table format does not understand quoting conventions. 116# CONFIGURATION PARAMETERS 117# .ad 118# .fi 119# The following \fBmain.cf\fR parameters are especially relevant. 120# The text below provides only a parameter summary. See 121# \fBpostconf\fR(5) for more details including examples. 122# .IP "\fBrelocated_maps (empty)\fR" 123# Optional lookup tables with new contact information for users or 124# domains that no longer exist. 125# .PP 126# Other parameters of interest: 127# .IP "\fBinet_interfaces (all)\fR" 128# The network interface addresses that this mail system receives 129# mail on. 130# .IP "\fBmydestination ($myhostname, localhost.$mydomain, localhost)\fR" 131# The list of domains that are delivered via the $local_transport 132# mail delivery transport. 133# .IP "\fBmyorigin ($myhostname)\fR" 134# The domain name that locally-posted mail appears to come 135# from, and that locally posted mail is delivered to. 136# .IP "\fBproxy_interfaces (empty)\fR" 137# The network interface addresses that this mail system receives mail 138# on by way of a proxy or network address translation unit. 139# SEE ALSO 140# trivial-rewrite(8), address resolver 141# postmap(1), Postfix lookup table manager 142# postconf(5), configuration parameters 143# README FILES 144# .ad 145# .fi 146# Use "\fBpostconf readme_directory\fR" or 147# "\fBpostconf html_directory\fR" to locate this information. 148# .na 149# .nf 150# DATABASE_README, Postfix lookup table overview 151# ADDRESS_REWRITING_README, address rewriting guide 152# LICENSE 153# .ad 154# .fi 155# The Secure Mailer license must be distributed with this software. 156# AUTHOR(S) 157# Wietse Venema 158# IBM T.J. Watson Research 159# P.O. Box 704 160# Yorktown Heights, NY 10598, USA 161# 162# Wietse Venema 163# Google, Inc. 164# 111 8th Avenue 165# New York, NY 10011, USA 166#-- 167