external/ibm-public/postfix/dist/README_FILES/UUCP_README

   1 P\bPo\bos\bst\btf\bfi\bix\bx a\ban\bnd\bd U\bUU\bUC\bCP\bP
   2
   3 -------------------------------------------------------------------------------
   4
   5 U\bUs\bsi\bin\bng\bg U\bUU\bUC\bCP\bP o\bov\bve\ber\br T\bTC\bCP\bP
   6
   7 Despite a serious lack of sex-appeal, email via UUCP over TCP is a practical
   8 option for sites without permanent Internet connections, and for sites without
   9 a fixed IP address. For first-hand information, see the following guides:
  10
  11   * Jim Seymour's guide for using UUCP over TCP at http://jimsun.LinxNet.com/
  12     jdp/uucp_over_tcp/index.html,
  13   * Craig Sanders's guide for SSL-encrypted UUCP over TCP using stunnel at
  14     http://taz.net.au/postfix/uucp/.
  15
  16 Here's a graphical description of what this document is about:
  17
  18                         LAN to                 Internet
  19     Local network <--->  UUCP   <--- UUCP ---> to UUCP  <---> Internet
  20                         Gateway                Gateway
  21
  22 And here's the table of contents of this document:
  23
  24   * Setting up a Postfix Internet to UUCP gateway
  25   * Setting up a Postfix LAN to UUCP gateway
  26
  27 S\bSe\bet\btt\bti\bin\bng\bg u\bup\bp a\ba P\bPo\bos\bst\btf\bfi\bix\bx I\bIn\bnt\bte\ber\brn\bne\bet\bt t\bto\bo U\bUU\bUC\bCP\bP g\bga\bat\bte\bew\bwa\bay\by
  28
  29 Here is how to set up a machine that sits on the Internet and that forwards
  30 mail to a LAN that is connected via UUCP. See the LAN to UUCP gateway section
  31 for the other side of the story.
  32
  33   * You need an r\brm\bma\bai\bil\bl program that extracts the sender address from mail that
  34     arrives via UUCP, and that feeds the mail into the Postfix s\bse\ben\bnd\bdm\bma\bai\bil\bl
  35     command. Most UNIX systems come with an r\brm\bma\bai\bil\bl utility. If you're in a
  36     pinch, try the one bundled with the Postfix source code in the a\bau\bux\bxi\bil\bli\bia\bar\bry\by/\b/
  37     r\brm\bma\bai\bil\bl directory.
  38
  39   * Define a pipe(8) based mail delivery transport for delivery via UUCP:
  40
  41     /etc/postfix/master.cf:
  42         uucp      unix  -       n       n       -       -       pipe
  43           flags=F user=uucp argv=uux -r -n -z -a$sender - $nexthop!rmail
  44     ($recipient)
  45
  46     This runs the u\buu\bux\bx command to place outgoing mail into the UUCP queue after
  47     replacing $nexthop by the next-hop hostname (the receiving UUCP host) and
  48     after replacing $recipient by the recipients. The pipe(8) delivery agent
  49     executes the u\buu\bux\bx command without assistance from the shell, so there are no
  50     problems with shell meta characters in command-line parameters.
  51
  52   * Specify that mail for example.com, should be delivered via UUCP, to a host
  53     named uucp-host:
  54
  55     /etc/postfix/transport:
  56         example.com     uucp:uucp-host
  57         .example.com    uucp:uucp-host
  58
  59     See the transport(5) manual page for more details.
  60
  61   * Execute the command "p\bpo\bos\bst\btm\bma\bap\bp /\b/e\bet\btc\bc/\b/p\bpo\bos\bst\btf\bfi\bix\bx/\b/t\btr\bra\ban\bns\bsp\bpo\bor\brt\bt" whenever you change
  62     the t\btr\bra\ban\bns\bsp\bpo\bor\brt\bt file.
  63
  64   * Enable t\btr\bra\ban\bns\bsp\bpo\bor\brt\bt table lookups:
  65
  66     /etc/postfix/main.cf:
  67         transport_maps = hash:/etc/postfix/transport
  68
  69     Specify d\bdb\bbm\bm instead of h\bha\bas\bsh\bh if your system uses d\bdb\bbm\bm files instead of d\bdb\bb
  70     files. To find out what map types Postfix supports, use the command
  71     "p\bpo\bos\bst\btc\bco\bon\bnf\bf -\b-m\bm".
  72
  73   * Add example.com to the list of domains that your site is willing to relay
  74     mail for.
  75
  76     /etc/postfix/main.cf:
  77         relay_domains = example.com ...other relay domains...
  78
  79     See the relay_domains configuration parameter description for details.
  80
  81   * Execute the command "p\bpo\bos\bst\btf\bfi\bix\bx r\bre\bel\blo\boa\bad\bd" to make the changes effective.
  82
  83 S\bSe\bet\btt\bti\bin\bng\bg u\bup\bp a\ba P\bPo\bos\bst\btf\bfi\bix\bx L\bLA\bAN\bN t\bto\bo U\bUU\bUC\bCP\bP g\bga\bat\bte\bew\bwa\bay\by
  84
  85 Here is how to relay mail from a LAN via UUCP to the Internet. See the Internet
  86 to UUCP gateway section for the other side of the story.
  87
  88   * You need an r\brm\bma\bai\bil\bl program that extracts the sender address from mail that
  89     arrives via UUCP, and that feeds the mail into the Postfix s\bse\ben\bnd\bdm\bma\bai\bil\bl
  90     command. Most UNIX systems come with an r\brm\bma\bai\bil\bl utility. If you're in a
  91     pinch, try the one bundled with the Postfix source code in the a\bau\bux\bxi\bil\bli\bia\bar\bry\by/\b/
  92     r\brm\bma\bai\bil\bl directory.
  93
  94   * Specify that all remote mail must be sent via the u\buu\buc\bcp\bp mail transport to
  95     your UUCP gateway host, say, uucp-gateway:
  96
  97     /etc/postfix/main.cf:
  98         relayhost = uucp-gateway
  99         default_transport = uucp
 100
 101     Postfix 2.0 and later also allows the following more succinct form:
 102
 103     /etc/postfix/main.cf:
 104         default_transport = uucp:uucp-gateway
 105
 106   * Define a pipe(8) based message delivery transport for mail delivery via
 107     UUCP:
 108
 109     /etc/postfix/master.cf:
 110         uucp      unix  -       n       n       -       -       pipe
 111           flags=F user=uucp argv=uux -r -n -z -a$sender - $nexthop!rmail
 112     ($recipient)
 113
 114     This runs the u\buu\bux\bx command to place outgoing mail into the UUCP queue. It
 115     substitutes the next-hop hostname (uucp-gateway, or whatever you specified)
 116     and the recipients before executing the command. The u\buu\bux\bx command is
 117     executed without assistance from the shell, so there are no problems with
 118     shell meta characters.
 119
 120   * Execute the command "p\bpo\bos\bst\btf\bfi\bix\bx r\bre\bel\blo\boa\bad\bd" to make the changes effective.
 121