~ubuntu-branches/ubuntu/hoary/postfix/hoary-security

« back to all changes in this revision

Viewing changes to html/UUCP_README.html

  • Committer: Bazaar Package Importer
  • Author(s): LaMont Jones
  • Date: 2004-10-06 11:50:33 UTC
  • Revision ID: james.westby@ubuntu.com-20041006115033-ooo6yfg6kmoteu04
Tags: upstream-2.1.3
ImportĀ upstreamĀ versionĀ 2.1.3

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<!doctype html public "-//W3C//DTD HTML 4.01 Transitional//EN"
 
2
        "http://www.w3.org/TR/html4/loose.dtd">
 
3
 
 
4
<html>
 
5
 
 
6
<head>
 
7
 
 
8
<title>Postfix and UUCP </title>
 
9
 
 
10
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
 
11
 
 
12
</head>
 
13
 
 
14
<body>
 
15
 
 
16
<h1><img src="postfix-logo.jpg" width="203" height="98" ALT="">Postfix and UUCP </h1>
 
17
 
 
18
<hr>
 
19
 
 
20
<h2><a name="uucp-tcp">Using UUCP over TCP</a></h2>
 
21
 
 
22
<p> Despite a serious lack of sex-appeal, email via UUCP over TCP
 
23
is a practical option for sites without permanent Internet connection,
 
24
and for sites without a fixed IP address. For first-hand information,
 
25
see the following guides: </p>
 
26
 
 
27
<ul>
 
28
 
 
29
<li> Jim Seymour's guide for using UUCP over TCP at
 
30
<a href="http://jimsun.LinxNet.com/jdp/uucp_over_tcp/index.html">http://jimsun.LinxNet.com/jdp/uucp_over_tcp/index.html</a>,
 
31
 
 
32
<li> Craig Sanders's guide for SSL-encrypted UUCP over TCP
 
33
using stunnel at <a href="http://taz.net.au/postfix/uucp/">http://taz.net.au/postfix/uucp/</a>.
 
34
 
 
35
</ul>
 
36
 
 
37
Here's a graphical description of what this document is about:
 
38
 
 
39
<blockquote>
 
40
 
 
41
<table>
 
42
 
 
43
<tr> <td> Local network <tt> &lt;---&gt; </tt> </td>
 
44
 
 
45
<td bgcolor="#f0f0ff" align="center"><a href="#lan-uucp">LAN to<br>
 
46
UUCP<br> Gateway</a></td>
 
47
 
 
48
<td> <tt> &lt;--- </tt> UUCP <tt> ---&gt; </tt> </td>
 
49
 
 
50
<td bgcolor="#f0f0ff" align="center"><a href="#internet-uucp">Internet<br>
 
51
to UUCP<br> Gateway</a></td>
 
52
 
 
53
<td> <tt> &lt;---&gt; </tt>  Internet </td> </tr>
 
54
 
 
55
</table>
 
56
 
 
57
</blockquote>
 
58
 
 
59
<p> And here's the table of contents of this document: </p>
 
60
 
 
61
<ul>
 
62
 
 
63
<li><a href="#internet-uucp">Setting up a Postfix Internet to UUCP
 
64
gateway</a>
 
65
 
 
66
<li><a href="#lan-uucp">Setting up a Postfix LAN to UUCP
 
67
gateway</a>
 
68
 
 
69
</ul>
 
70
 
 
71
<h2><a name="internet-uucp">Setting up a Postfix Internet to UUCP
 
72
gateway</a></h2>
 
73
 
 
74
<p> Here is how to set up a machine that sits on the Internet and
 
75
that forwards mail to a LAN that is connected via UUCP. See
 
76
the <a href="#lan-uucp">LAN to UUCP gateway</a> section for
 
77
the other side of the story. </p>
 
78
 
 
79
<ul>
 
80
 
 
81
<li> <p> You need an <b>rmail</b> program that extracts the sender
 
82
address from mail that arrives via UUCP, and that feeds the mail
 
83
into the Postfix <b>sendmail</b> command.  Most UNIX systems come
 
84
with an <b>rmail</b> utility. If you're in a pinch, try the one
 
85
bundled with the Postfix source code in the <b>auxiliary/rmail</b>
 
86
directory. </p>
 
87
 
 
88
<li> <p> Define a <a href="pipe.8.html">pipe(8)</a> based mail delivery transport for delivery
 
89
via UUCP: </p>
 
90
 
 
91
<pre>
 
92
/etc/postfix/master.cf:
 
93
    uucp      unix  -       n       n       -       -       pipe
 
94
      flags=F user=uucp argv=uux -r -n -z -a$sender - $nexthop!rmail ($recipient)
 
95
</pre>
 
96
 
 
97
<p> This runs the <b>uux</b> command to place outgoing mail into
 
98
the UUCP queue after replacing $nexthop by the next-hop hostname
 
99
(the receiving UUCP host) and after replacing $recipient by the
 
100
recipients.  The <a href="pipe.8.html">pipe(8)</a> delivery agent executes the <b>uux</b>
 
101
command without assistance from the shell, so there are no problems
 
102
with shell meta characters in command-line parameters.  </p>
 
103
 
 
104
<li> <p> Specify that mail for <i>example.com</i>, should be
 
105
delivered via UUCP, to a host named <i>uucp-host</i>: </p>
 
106
 
 
107
<pre>
 
108
/etc/postfix/transport:
 
109
    example.com     uucp:uucp-host
 
110
    .example.com    uucp:uucp-host
 
111
</pre>
 
112
 
 
113
<p> See the <a href="transport.5.html">transport(5)</a> manual page for more details. </p>
 
114
 
 
115
<li> <p> Execute the command "<b>postmap /etc/postfix/transport</b>"
 
116
whenever you change the <b>transport</b> file. </p>
 
117
 
 
118
<li> <p> Enable <b>transport</b> table lookups: </p>
 
119
 
 
120
<pre>
 
121
/etc/postfix/main.cf:
 
122
    <a href="postconf.5.html#transport_maps">transport_maps</a> = hash:/etc/postfix/transport
 
123
</pre>
 
124
 
 
125
<p> Specify <B>dbm</b> instead of <b>hash</b> if your system uses
 
126
<b>dbm</b> files instead of <b>db</b> files. To find out what map
 
127
types Postfix supports, use the command "<b>postconf -m</b>". </p>
 
128
 
 
129
<li> <p> Add <i>example.com</i> to the list of domains that your site
 
130
is willing to relay mail for. </p>
 
131
 
 
132
<pre>
 
133
/etc/postfix/main.cf:
 
134
    <a href="postconf.5.html#relay_domains">relay_domains</a> = example.com ...<i>other <a href="ADDRESS_CLASS_README.html#relay_domain_class">relay domains</a></i>...
 
135
</pre>
 
136
 
 
137
<p> See the <a href="postconf.5.html#relay_domains">relay_domains</a> configuration parameter description for
 
138
details. </p>
 
139
 
 
140
<li> <p> Execute the command "<b>postfix reload</b>" to make the
 
141
changes effective. </p>
 
142
 
 
143
</ul>
 
144
 
 
145
<h2><a name="lan-uucp">Setting up a Postfix LAN to UUCP
 
146
gateway</a></h2>
 
147
 
 
148
<p> Here is how to relay mail from a LAN via UUCP to the
 
149
Internet. See the <a href="#internet-uucp">Internet to UUCP
 
150
gateway</a> section for the other side of the story. </p>
 
151
 
 
152
<ul>
 
153
 
 
154
<li> <p> You need an <b>rmail</b> program that extracts the sender
 
155
address from mail that arrives via UUCP, and that feeds the mail
 
156
into the Postfix <b>sendmail</b> command.  Most UNIX systems come
 
157
with an <b>rmail</b> utility. If you're in a pinch, try the one
 
158
bundled with the Postfix source code in the <b>auxiliary/rmail</b>
 
159
directory. </p>
 
160
 
 
161
<li> <p> Specify that all remote mail must be sent via the <b>uucp</b>
 
162
mail transport to your UUCP gateway host, say, <i>uucp-gateway</i>: </p>
 
163
 
 
164
<pre>
 
165
/etc/postfix/main.cf:
 
166
    <a href="postconf.5.html#relayhost">relayhost</a> = uucp-gateway
 
167
    <a href="postconf.5.html#default_transport">default_transport</a> = uucp
 
168
</pre>
 
169
 
 
170
<p> Postfix 2.0 and later also allows the following more succinct form: </p>
 
171
 
 
172
<pre>
 
173
/etc/postfix/main.cf:
 
174
    <a href="postconf.5.html#default_transport">default_transport</a> = uucp:uucp-gateway
 
175
</pre>
 
176
 
 
177
<li> <p> Define a <a href="pipe.8.html">pipe(8)</a> based message delivery transport for mail
 
178
delivery via UUCP: </p>
 
179
 
 
180
<pre>
 
181
/etc/postfix/master.cf:
 
182
    uucp      unix  -       n       n       -       -       pipe
 
183
      flags=F user=uucp argv=uux -r -n -z -a$sender - $nexthop!rmail ($recipient)
 
184
</pre>
 
185
 
 
186
<p> This runs the <b>uux</b> command to place outgoing mail into
 
187
the UUCP queue. It substitutes the next-hop hostname (<i>uucp-gateway</i>,
 
188
or whatever you specified) and the recipients before executing the
 
189
command.  The <b>uux</b> command is executed without assistance
 
190
from the shell, so there are no problems with shell meta characters.
 
191
</p>
 
192
 
 
193
<li> <p> Execute the command "<b>postfix reload</b>" to make the
 
194
changes effective. </p>
 
195
 
 
196
</ul>
 
197
 
 
198
</body>
 
199
 
 
200
</html>