From owner-svn-doc-head@FreeBSD.ORG Fri May 9 20:05:34 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 23ED67A6; Fri, 9 May 2014 20:05:34 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 10F22DEA; Fri, 9 May 2014 20:05:34 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s49K5XVg048514; Fri, 9 May 2014 20:05:33 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s49K5XnT048513; Fri, 9 May 2014 20:05:33 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405092005.s49K5XnT048513@svn.freebsd.org> From: Dru Lavigne Date: Fri, 9 May 2014 20:05:33 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44803 - 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.18 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: Fri, 09 May 2014 20:05:34 -0000 Author: dru Date: Fri May 9 20:05:33 2014 New Revision: 44803 URL: http://svnweb.freebsd.org/changeset/doc/44803 Log: Finish initial editorial review of Sendmail Configuration Files. Comment out local-host-names for now until instructions for building its needed .mc feature are added. Sponsored by: iXsystems 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 Fri May 9 18:42:36 2014 (r44802) +++ head/en_US.ISO8859-1/books/handbook/mail/chapter.xml Fri May 9 20:05:33 2014 (r44803) @@ -383,7 +383,7 @@ FreeBSD.org mail is handled by 10 mx1.Fr right side of the table. Whenever this file is updated, update its database and - restart Sendmail: + restart Sendmail: &prompt.root; makemap hash /etc/mail/access < /etc/mail/access &prompt.root; service sendmail restart @@ -393,47 +393,49 @@ FreeBSD.org mail is handled by 10 mx1.Fr /etc/mail/aliases - This database contains a list of virtual mailboxes that - are expanded to other user(s), files, programs, or other - aliases. Here are a few examples to illustrate the + This database file contains a list of virtual mailboxes that + are expanded to users, files, programs, or other + aliases. Here are a few entries to illustrate the file format: - - Mail Aliases - root: localuser ftp-bugs: joe,eric,paul bit.bucket: /dev/null procmail: "|/usr/local/bin/procmail" - The mailbox name on the left side of the colon is expanded to the target(s) on the right. The first entry expands the - mailbox root to the - mailbox localuser, - which is then looked up again in the - aliases database. If no match is found, + root mailbox to the + localuser mailbox, + which is then looked up in the + /etc/mail/aliases database. If no match is found, the message is delivered to localuser. The second entry - shows a mail list. Mail to the mailbox ftp-bugs is expanded to the three local mailboxes joe, eric, and paul. A remote mailbox could - be specified as user@example.com. The third + be specified as user@example.com. The third entry shows how to write mail to a file, in this case /dev/null. The last entry demonstrates how to send mail to a program, /usr/local/bin/procmail, through a &unix; - pipe. + pipe. Refer to &man.aliases.5; for more information about the + format of this file. - Whenever this file is updated, run make - in /etc/mail/ to update the + Whenever this file is updated, run newaliases + to update and initialize the aliases database. - + /etc/mail/sendmail.cf @@ -483,34 +485,37 @@ mail.example.com /etc/mail/virtusertable - The virtusertable maps mail addresses + This database file maps mail addresses for virtual domains and users to real mailboxes. These mailboxes can be local, remote, aliases defined in - /etc/mail/aliases, or files. + /etc/mail/aliases, or files. This allows + multiple virtual domains to be hosted on one machine. - - Example Virtual Domain Mail Map + &os; provides a sample configuration file in + /etc/mail/virtusertable.sample to + further demonstrate its format. The following example demonstrates how + to create custom entries using that format: root@example.com root postmaster@example.com postmaster@noc.example.net @example.com joe - - The above example contains a mapping for the domain - example.com. - This file is processed in a first match order. The first item - maps root@example.com to the local mailbox - root. The second - entry maps postmaster@example.com to the - mailbox postmaster - on the host noc.example.net. Finally, - if nothing from example.com has matched so - far, it will match the last mapping, which matches every other - mail message addressed to someone at example.com to the local - mailbox joe. + This file is processed in a first match order. When an + email address matches the address on the left, it is mapped to + the local mailbox listed on the right. The format of the first entry in + this example maps a specific email address to a local mailbox, + whereas the format of the second entry maps a specific email + address to a remote mailbox. Finally, any email address + from example.com which has not matched any of the previous entries + will match the last mapping and be sent to the local mailbox + joe. When creating custom entries, use + this format and add them to + /etc/mail/virtusertable. Whenever this + file is edited, update its database and restart + Sendmail: + + &prompt.root; makemap hash /etc/mail/virtusertable < /etc/mail/virtusertable +&prompt.root; service sendmail restart