From owner-svn-doc-all@FreeBSD.ORG Fri May 9 20:25:28 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id CDA4AF11; Fri, 9 May 2014 20:25:28 +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 B9BAAF9C; Fri, 9 May 2014 20:25:28 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s49KPSOC057500; Fri, 9 May 2014 20:25:28 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s49KPSbe057499; Fri, 9 May 2014 20:25:28 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405092025.s49KPSbe057499@svn.freebsd.org> From: Dru Lavigne Date: Fri, 9 May 2014 20:25:28 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44804 - 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-all@freebsd.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 09 May 2014 20:25:28 -0000 Author: dru Date: Fri May 9 20:25:28 2014 New Revision: 44804 URL: http://svnweb.freebsd.org/changeset/doc/44804 Log: White space fix only. Translators can ignore. 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 20:05:33 2014 (r44803) +++ head/en_US.ISO8859-1/books/handbook/mail/chapter.xml Fri May 9 20:25:28 2014 (r44804) @@ -296,9 +296,8 @@ FreeBSD.org mail is handled by 10 mx1.Fr Sendmail is the default - MTA installed with &os;. - It accepts mail from - MUAs and delivers it to the appropriate + MTA installed with &os;. It accepts mail + from MUAs and delivers it to the appropriate mail host, as defined by its configuration. Sendmail can also accept network connections and deliver mail to local mailboxes or to another @@ -306,8 +305,8 @@ FreeBSD.org mail is handled by 10 mx1.Fr The configuration files for Sendmail are located in - /etc/mail. This section describes these files in more - detail. + /etc/mail. This section describes these + files in more detail. /etc/mail/access @@ -333,30 +332,32 @@ FreeBSD.org mail is handled by 10 mx1.Fr - /etc/mail/access - - This access database file defines which hosts or IP addresses - have access to the local mail server and what kind of access - they have. Hosts listed as , which is the - default option, are allowed to send mail to this host as long - as the mail's final destination is the local machine. Hosts - listed as are rejected for all mail - connections. Hosts listed as are - allowed to send mail for any destination using this mail - server. Hosts listed as will have their mail returned with - the specified mail error. If a host is listed - as , Sendmail - will abort the current search for this entry without accepting - or rejecting the mail. Hosts listed - as will have their messages held and will receive the - specified text as the reason for the hold. - - Examples of using these options for both - IPv4 and IPv6 - addresses can be found in the &os; sample configuration, - /etc/mail/access.sample: + /etc/mail/access + + This access database file defines which hosts or + IP addresses have access to the local + mail server and what kind of access they have. Hosts + listed as , which is the default + option, are allowed to send mail to this host as long as + the mail's final destination is the local machine. Hosts + listed as are rejected for all + mail connections. Hosts listed as + are allowed to send mail for any destination using this + mail server. Hosts listed as will + have their mail returned with the specified mail error. + If a host is listed as , + Sendmail will abort the current + search for this entry without accepting or rejecting the + mail. Hosts listed as will + have their messages held and will receive the specified + text as the reason for the hold. + + Examples of using these options for both + IPv4 and IPv6 + addresses can be found in the &os; sample configuration, + /etc/mail/access.sample: - # $FreeBSD$ + # $FreeBSD$ # # Mail relay access control list. Default is to reject mail unless the # destination is local, or listed in /etc/mail/local-host-names @@ -373,63 +374,65 @@ FreeBSD.org mail is handled by 10 mx1.Fr #Connect:[127.0.0.3] OK #Connect:[IPv6:1:2:3:4:5:6:7:8] OK - To configure the access database, use the format shown in - the sample to make entries in - /etc/mail/access, but do not put a - comment symbol (#) in front of the entries. Create - an entry for each host or network whose access should be - configured. Mail senders that match - the left side of the table are affected by the action on the - right side of the table. + To configure the access database, use the format shown + in the sample to make entries in + /etc/mail/access, but do not put a + comment symbol (#) in front of the + entries. Create an entry for each host or network whose + access should be configured. Mail senders that match the + left side of the table are affected by the action on the + right side of the table. - Whenever this file is updated, update its database and - restart Sendmail: + Whenever this file is updated, update its database and + restart Sendmail: - &prompt.root; makemap hash /etc/mail/access < /etc/mail/access + &prompt.root; makemap hash /etc/mail/access < /etc/mail/access &prompt.root; service sendmail restart - - + + - - /etc/mail/aliases - - 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: + + /etc/mail/aliases + + 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: - root: localuser + 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 - 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 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 - 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. Refer to &man.aliases.5; for more information about the - format of this file. - - Whenever this file is updated, run newaliases - to update and initialize the aliases - database. - - + The mailbox name on the left side of the colon is + expanded to the target(s) on the right. The first entry + expands the 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 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 + 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. Refer to &man.aliases.5; for more + information about the format of this file. + + Whenever this file is updated, run + newaliases to update and initialize the + aliases database. + + - - /etc/mail/sendmail.cf - - This is the master configuration file for - Sendmail. It controls the overall - behavior of Sendmail, including - everything from rewriting email addresses to printing rejection - messages to remote mail servers. Accordingly, this - configuration file is quite complex. Fortunately, this file - rarely needs to be changed for standard mail servers. - - The master Sendmail configuration - file can be built from &man.m4.1; macros that define the - features and behavior of Sendmail. - Refer to - /usr/src/contrib/sendmail/cf/README for - some of the details. - - Whenever changes to this file are made, - Sendmail needs to be restarted for - the changes to take effect. - - + + /etc/mail/sendmail.cf + + This is the master configuration file for + Sendmail. It controls the + overall behavior of Sendmail, + including everything from rewriting email addresses to + printing rejection messages to remote mail servers. + Accordingly, this configuration file is quite complex. + Fortunately, this file rarely needs to be changed for + standard mail servers. + + The master Sendmail + configuration file can be built from &man.m4.1; macros + that define the features and behavior of + Sendmail. Refer to + /usr/src/contrib/sendmail/cf/README + for some of the details. + + Whenever changes to this file are made, + Sendmail needs to be restarted + for the changes to take effect. + + - - /etc/mail/virtusertable - - 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. This allows - multiple virtual domains to be hosted on one machine. - - &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: + + /etc/mail/virtusertable + + 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. This + allows multiple virtual domains to be hosted on one + machine. + + &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 + root@example.com root postmaster@example.com postmaster@noc.example.net @example.com 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: + 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; makemap hash /etc/mail/virtusertable < /etc/mail/virtusertable &prompt.root; service sendmail restart - - - + + +