summaryrefslogtreecommitdiff
path: root/gnu/dist/postfix/html/transport.5.html
blob: bace70fa91db8c18569db5d08eca0751667cea2b (plain)
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
<html> <head> </head> <body> <pre>



TRANSPORT(5)                                         TRANSPORT(5)


<b>NAME</b>
       transport - format of Postfix transport table

<b>SYNOPSIS</b>
       <b>postmap</b> <b>/etc/postfix/transport</b>

<b>DESCRIPTION</b>
       The  optional  <b>transport</b>  file  specifies  a  mapping from
       domain hierarchies to message delivery  transports  and/or
       relay hosts. The mapping is used by the <a href="trivial-rewrite.8.html"><b>trivial-rewrite</b>(8)</a>
       daemon.

       The file serves as input to the  <a href="postmap.1.html"><b>postmap</b>(1)</a>  command.  The
       result,  an  indexed file in <b>dbm</b> or <b>db</b> format, is used for
       fast searching by the mail  system.  After  updating  this
       table, issue the <b>postfix</b> <b>reload</b> command to make the change
       visible.

       The format of the transport table is as follows:

       blanks and comments
              Blank lines are ignored,  as  are  lines  beginning
              with `#'.

       <i>domain</i> <i>transport</i>:<i>nexthop</i>
              Mail  for  <i>domain</i> is delivered through <i>transport</i> to
              <i>nexthop</i>.

       <i>.domain</i> <i>transport</i>:<i>nexthop</i>
              Mail for  any  subdomain  of  <i>domain</i>  is  delivered
              through <i>transport</i> to <i>nexthop</i>.

       Note:  transport  map entries take precedence over domains
       specified in the <b>mydestination</b> parameter. If you  use  the
       optional  transport  map,  it  may  be  safer  to  specify
       explicit entries for all domains specified  in  <b>mydestina-</b>
       <b>tion</b>, for example:

            <b>hostname.my.domain</b>       <b>local:</b>
            <b>localhost.my.domain</b>      <b>local:</b>

       The  interpretation  of  the  <i>nexthop</i>  field  is transport
       dependent. In the case of SMTP, specify <i>host</i>:<i>service</i> for a
       non-default  server port, and use [<i>host</i>] or [<i>host</i>:<i>port</i>] in
       order to disable MX (mail exchanger) DNS lookups.  The  []
       form  can  also be used with IP addresses instead of host-
       names.

<b>EXAMPLES</b>
       In order to send mail for <b>foo.org</b> and its subdomains
       via the <b>uucp</b> transport to the UUCP host named <b>foo</b>:

            <b>foo.org</b>      <b>uucp:foo</b>
            <b>.foo.org</b>     <b>uucp:foo</b>



                                                                1





TRANSPORT(5)                                         TRANSPORT(5)


       When no <i>nexthop</i> host name is specified, the destination domain
       name is used instead. For example, the following directs mail for
       <i>user</i>@<b>foo.org</b> via the <b>slow</b> transport to a mail
       exchanger for <b>foo.org</b>.  The <b>slow</b> transport could be
       something that runs at most one delivery process at a time:

            <b>foo.org</b>      <b>slow:</b>

       When no <i>transport</i> is specified, the default transport is
       used, as specified via the <b>default</b><i>_</i><b>transport</b> configuration
       parameter. The following sends all mail for <b>foo.org</b> and its
       subdomains to host <b>gateway.foo.org</b>:

            <b>foo.org</b>      <b>:[gateway.foo.org]</b>
            <b>.foo.org</b>     <b>:[gateway.foo.org]</b>

       In the above example, the [] are used to suppress MX lookups.
       The result would likely point to your local machine.

       In the case of delivery via SMTP, one may specify
       <i>hostname</i>:<i>service</i> instead of just a host:

            <b>foo.org</b>      <b>smtp:bar.org:2025</b>

       This directs mail for <i>user</i>@<b>foo.org</b> to host <b>bar.org</b>
       port <b>2025</b>. Instead of a numerical port a symbolic name may be
       used. Specify [] around the destination in order to disable MX lookups.

       The error mailer can be used to bounce mail:

            <b>.foo.org</b>      <b>error:mail</b> <b>for</b> <b>*.foo.org</b> <b>is</b> <b>not</b> <b>deliverable</b>

       This causes all mail for <i>user</i>@<i>anything</i><b>foo.org</b>
       to be bounced.

<b>CONFIGURATION</b> <b>PARAMETERS</b>
       The following <b>main.cf</b> parameters are  especially  relevant
       to  this  topic.  See  the Postfix <b>main.cf</b> file for syntax
       details and for default values.  Use  the  <b>postfix</b>  <b>reload</b>
       command after a configuration change.

       <b>transport</b><i>_</i><b>maps</b>
              List of transport lookup tables.

       Other parameters of interest:

       <b>default</b><i>_</i><b>transport</b>
              The  transport  to use when no transport is explic-
              itly specified.

       <b>relayhost</b>
              The default host to send to when no transport table
              entry matches.




                                                                2





TRANSPORT(5)                                         TRANSPORT(5)


<b>SEE</b> <b>ALSO</b>
       <a href="postmap.1.html">postmap(1)</a> create mapping table
       <a href="trivial-rewrite.8.html">trivial-rewrite(8)</a> rewrite and resolve addresses

<b>LICENSE</b>
       The  Secure  Mailer  license must be distributed with this
       software.

<b>AUTHOR(S)</b>
       Wietse Venema
       IBM T.J. Watson Research
       P.O. Box 704
       Yorktown Heights, NY 10598, USA












































                                                                3


</pre> </body> </html>