From owner-svn-doc-head@FreeBSD.ORG Sun May 19 03:14:26 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 7A6889D2; Sun, 19 May 2013 03:14:26 +0000 (UTC) (envelope-from eadler@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) by mx1.freebsd.org (Postfix) with ESMTP id 6AFA869A; Sun, 19 May 2013 03:14:26 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.6/8.14.6) with ESMTP id r4J3EQxl059846; Sun, 19 May 2013 03:14:26 GMT (envelope-from eadler@svn.freebsd.org) Received: (from eadler@localhost) by svn.freebsd.org (8.14.6/8.14.5/Submit) id r4J3EQ0B059845; Sun, 19 May 2013 03:14:26 GMT (envelope-from eadler@svn.freebsd.org) Message-Id: <201305190314.r4J3EQ0B059845@svn.freebsd.org> From: Eitan Adler Date: Sun, 19 May 2013 03:14:26 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r41677 - head/en_US.ISO8859-1/books/handbook/mail X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 19 May 2013 03:14:26 -0000 Author: eadler Date: Sun May 19 03:14:25 2013 New Revision: 41677 URL: http://svnweb.freebsd.org/changeset/doc/41677 Log: There is no longer a need for SMTP with UUCP in the handbook Discussed with: swills, brd Modified: head/en_US.ISO8859-1/books/handbook/mail/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/mail/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/mail/chapter.xml Sun May 19 02:09:43 2013 (r41676) +++ head/en_US.ISO8859-1/books/handbook/mail/chapter.xml Sun May 19 03:14:25 2013 (r41677) @@ -75,10 +75,6 @@ - How to use SMTP with UUCP. - - - How to set up the system to send mail only. @@ -1300,141 +1296,6 @@ freefall MX 20 who.cdrom.com - - SMTP with UUCP - - The sendmail configuration - that ships with FreeBSD 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. - - Tweaking /etc/mail/sendmail.cf manually - is an advanced topic. sendmail - version 8 generates config files via &man.m4.1; preprocessing, - where the actual configuration occurs on a higher abstraction - level. The &man.m4.1; configuration files can be found under - /usr/share/sendmail/cf. The file - README in the cf - directory can serve as a basic introduction to &man.m4.1; - configuration. - - 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. - - First, you have to create your .mc - file. The directory - /usr/share/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: - - &prompt.root; cd /etc/mail -&prompt.root; make foo.cf -&prompt.root; cp foo.cf /etc/mail/sendmail.cf - - A typical .mc file might look - like: - - VERSIONID(`Your version number') OSTYPE(bsd4.4) - -FEATURE(accept_unresolvable_domains) -FEATURE(nocanonify) -FEATURE(mailertable, `hash -o /etc/mail/mailertable') - -define(`UUCP_RELAY', your.uucp.relay) -define(`UUCP_MAX_SIZE', 200000) -define(`confDONT_PROBE_INTERFACES') - -MAILER(local) -MAILER(smtp) -MAILER(uucp) - -Cw your.alias.host.name -Cw youruucpnodename.UUCP - - 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. - - 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: - - # -# makemap hash /etc/mail/mailertable.db < /etc/mail/mailertable -. uucp-dom:your.uucp.relay - - A more complex example might look like this: - - # -# makemap hash /etc/mail/mailertable.db < /etc/mail/mailertable -# -horus.interface-business.de uucp-dom:horus -.interface-business.de uucp-dom:if-bus -interface-business.de uucp-dom:if-bus -.heep.sax.de smtp8:%1 -horus.UUCP uucp-dom:horus -if-bus.UUCP uucp-dom:if-bus -. uucp-dom: - - - 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. - - 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. - - Final hint: if you are uncertain whether some particular - mail routing would work, remember the - option to sendmail. It starts - sendmail in address test - mode; 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 - - CtrlD. - - &prompt.user; sendmail -bt -ADDRESS TEST MODE (ruleset 3 NOT automatically invoked) -Enter <ruleset> <address> -> 3,0 foo@example.com -canonify input: foo @ example . com -... -parse returns: $# uucp-dom $@ your.uucp.relay $: foo < @ example . com . > -> ^D - -