Put in remaining pages and wiki contents.
[ikiwiki.git] / docs / handbook / handbook-smtp-uucp.mdwn
1 \r
2 \r
3 ## 20.7 SMTP with UUCP \r
4 \r
5 The  **sendmail**  configuration that ships with DragonFly is designed for sites that connect directly to the Internet. Sites that wish to exchange their mail via UUCP must install another  **sendmail**  configuration file.\r
6 \r
7 Tweaking `/etc/mail/sendmail.cf` manually is an advanced topic.  **sendmail**  version 8 generates config files via [m4(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#m4&section1) preprocessing, where the actual configuration occurs on a higher abstraction level. The [m4(1)](http://leaf.dragonflybsd.org/cgi/web-man?command=m4&section=1) configuration files can be found under `/usr/src/usr.sbin/sendmail/cf`.\r
8 \r
9 If you did not install your system with full sources, the  **sendmail**  configuration set has been broken out into a separate source distribution tarball. Assuming you have your DragonFly source code CDROM mounted, do:\r
10 \r
11     \r
12     # cd /cdrom/src\r
13     # cat scontrib.?? | tar xzf - -C /usr/src/contrib/sendmail\r
14 \r
15 \r
16 This extracts to only a few hundred kilobytes. The file `README` in the `cf` directory can serve as a basic introduction to [m4(1)](http://leaf.dragonflybsd.org/cgi/web-man?command#m4&section1) configuration.\r
17 \r
18 The best way to support UUCP delivery is to use the `mailertable` feature. This creates a database that  **sendmail**  can use to make routing decisions.\r
19 \r
20 First, you have to create your `.mc` file. The directory `/usr/src/usr.sbin/sendmail/cf/cf` contains a few examples. Assuming you have named your file `foo.mc`, all you need to do in order to convert it into a valid `sendmail.cf` is:\r
21 \r
22     \r
23     # cd /usr/src/usr.sbin/sendmail/cf/cf\r
24     # make foo.cf\r
25     # cp foo.cf /etc/mail/sendmail.cf\r
26 \r
27 \r
28 A typical `.mc` file might look like:\r
29 \r
30     \r
31     VERSIONID(******Your version number***`') OSTYPE(bsd4.4)\r
32     \r
33     FEATURE(accept_unresolvable_domains)\r
34     FEATURE(nocanonify)\r
35     FEATURE(mailertable, `hash -o /etc/mail/mailertable')\r
36     \r
37     define(`UUCP_RELAY', `***your.uucp.relay***`)\r
38     define(`UUCP_MAX_SIZE', 200000)\r
39     define(`confDONT_PROBE_INTERFACES')\r
40     \r
41     MAILER(local)\r
42     MAILER(smtp)\r
43     MAILER(uucp)\r
44     \r
45     Cw    `***your.alias.host.name***`\r
46     Cw    `***youruucpnodename.UUCP***`\r
47 \r
48 \r
49 The lines containing `accept_unresolvable_domains`, `nocanonify`, and `confDONT_PROBE_INTERFACES` features will prevent any usage of the DNS during mail delivery. The `UUCP_RELAY` clause is needed to support UUCP delivery. Simply put an Internet hostname there that is able to handle .UUCP pseudo-domain addresses; most likely, you will enter the mail relay of your ISP there.\r
50 \r
51 Once you have this, you need an `/etc/mail/mailertable` file. If you have only one link to the outside that is used for all your mails, the following file will suffice:\r
52 \r
53     \r
54     #\r
55     # makemap hash /etc/mail/mailertable.db < /etc/mail/mailertable\r
56     .                             uucp-dom:`***your.uucp.relay***`\r
57 \r
58 \r
59 A more complex example might look like this:\r
60 \r
61     \r
62     #\r
63     # makemap hash /etc/mail/mailertable.db < /etc/mail/mailertable\r
64     #\r
65     horus.interface-business.de   uucp-dom:horus\r
66     .interface-business.de        uucp-dom:if-bus\r
67     interface-business.de         uucp-dom:if-bus\r
68     .heep.sax.de                  smtp8:%1\r
69     horus.UUCP                    uucp-dom:horus\r
70     if-bus.UUCP                   uucp-dom:if-bus\r
71     .                             uucp-dom:\r
72 \r
73 \r
74 The first three lines handle special cases where domain-addressed mail should not be sent out to the default route, but instead to some UUCP neighbor in order to ***shortcut*** the delivery path. The next line handles mail to the local Ethernet domain that can be delivered using SMTP. Finally, the UUCP neighbors are mentioned in the .UUCP pseudo-domain notation, to allow for a ******uucp-neighbor ***`!`***recipient****** override of the default rules. The last line is always a single dot, matching everything else, with UUCP delivery to a UUCP neighbor that serves as your universal mail gateway to the world. All of the node names behind the `uucp-dom:` keyword must be valid UUCP neighbors, as you can verify using the command `uuname`.\r
75 \r
76 As a reminder that this file needs to be converted into a DBM database file before use. The command line to accomplish this is best placed as a comment at the top of the `mailertable` file. You always have to execute this command each time you change your `mailertable` file.\r
77 \r
78 Final hint: if you are uncertain whether some particular mail routing would work, remember the `-bt` option to  **sendmail** . It starts  **sendmail**  in ***address test mode***; simply enter `3,0`, followed by the address you wish to test for the mail routing. The last line tells you the used internal mail agent, the destination host this agent will be called with, and the (possibly translated) address. Leave this mode by typing  **Ctrl** + **D** .\r
79 \r
80     \r
81     % sendmail -bt\r
82     ADDRESS TEST MODE (ruleset 3 NOT automatically invoked)\r
83     Enter <ruleset> <address>\r
84     > 3,0 foo@example.com\r
85     canonify           input: foo @ example . com\r
86     ...\r
87     parse            returns: $# uucp-dom $@ `***your.uucp.relay***` $: foo < @ example . com . >\r
88     > ^D\r
89 \r
90 \r
91 \r
92 \r
93 CategoryHandbook\r
94 CategoryHandbook-email\r