From owner-svn-doc-all@FreeBSD.ORG Fri May 9 16:17:58 2014 Return-Path: Delivered-To: svn-doc-all@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 B191FAF4; Fri, 9 May 2014 16:17:58 +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 847E47A5; Fri, 9 May 2014 16:17:58 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s49GHwe6041409; Fri, 9 May 2014 16:17:58 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s49GHwYU041408; Fri, 9 May 2014 16:17:58 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201405091617.s49GHwYU041408@svn.freebsd.org> From: Dru Lavigne Date: Fri, 9 May 2014 16:17:58 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44798 - 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 16:17:58 -0000 Author: dru Date: Fri May 9 16:17:58 2014 New Revision: 44798 URL: http://svnweb.freebsd.org/changeset/doc/44798 Log: Rename Using Electronic Email to Mail Components. Format as a variable list, clean up the wording, and add references. Many more commits in this chapter to come. 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 12:25:18 2014 (r44797) +++ head/en_US.ISO8859-1/books/handbook/mail/chapter.xml Fri May 9 16:17:58 2014 (r44798) @@ -114,37 +114,11 @@ - Using Electronic Mail + Mail Components POP IMAP DNS - - There are five major parts involved in an email exchange: - the Mail User Agent - MUA>, the - Mail Transfer AgentMTA, DNS, a remote or local mailbox, and - the mail host. - - - The Mail User Agent - - This includes command line programs such as - mutt, - alpine, - elm, and - mail, GUI programs such - as balsa or - xfmail, and web mail programs - which can be accessed from a web browser. User programs pass - the email transactions to the local mail host, either - by a MTA, or by - delivering it over TCP. - - - - The Mail Transfer Agent - mail server daemons Sendmail @@ -161,180 +135,94 @@ mail server daemons Exim + + email + receiving + + MX record + mail host - &os; ships with Sendmail as the - default MTA, but it also supports numerous - other mail server daemons, including: - - + There are five major parts involved in an email exchange: + the Mail User Agent (MUA), the Mail Transfer + Agent (MTA), a mail host, a remote + or local mailbox, and DNS. This section provides an + overview of these components. + + + + Mail User Agent (MUA) - Exim; - + The Mail User Agent (MUA) is an + application which is used to compose, send, and receive + emails. This application can be a command line program, such as + the built-in mail utility or a third-party + application from the Ports Collection, such as + mutt, + alpine, or + elm. + Dozens of graphical programs are also available in the Ports Collection, including + Claws Mail, Evolution, and + Thunderbird. Some organizations provide a web mail program + which can be accessed through a web browser. More information + about installing and using a MUA on &os; can be + found in . + + + + Mail Transfer Agent (MTA) - Postfix; - + The Mail Transfer Agent (MTA) is + responsible for receiving incoming mail and delivering + outgoing mail. &os; ships with Sendmail as the + default MTA, but it also supports numerous + other mail server daemons, including Exim, + Postfix, and + qmail. + Sendmail configuration is described + in . If another + MTA is installed using the Ports + Collection, refer to its post-installation message for + &os;-specific configuration details and the application's + website for more general configuration instructions. + + + + Mail Host and Mailboxes - qmail. - - - - The MTA usually has two functions. It - is responsible for receiving incoming mail as well as - delivering outgoing mail. It is not - responsible for the collection of mail using protocols such as - POP or IMAP, nor does it - allow connecting to local mbox or Maildir - mailboxes. An additional daemon may be required for - these functions. - - - Older versions of Sendmail - contain serious security issues which may result in an - attacker gaining local or remote access to the system. - Run a current version to &os; to avoid these problems. - Optionally, install an alternative MTA - from the &os; Ports - Collection. - - - - - Email and DNS - - The Domain Name System (DNS) and its - daemon named play a large role in the - delivery of email. In order to deliver mail from one site to - another, the MTA will look up the remote - site in DNS to determine which host will - receive mail for the destination. This process also occurs - when mail is sent from a remote host to the - MTA. - - - MX record - - - DNS is responsible for mapping - hostnames to IP addresses, as well as for storing information - specific to mail delivery, known as Mail eXchanger - MX records. The MX - record specifies which host, or hosts, will receive mail for a - particular domain. If there is no MX - record for the hostname or domain, the mail will be delivered - directly to the host, provided there is an - A record pointing the hostname to the IP - address. - - To view the MX records for a domain, - specify the type of record using &man.host.1;, as seen in the - example below: - - &prompt.user; host -t mx FreeBSD.org -FreeBSD.org mail is handled by 10 mx1.FreeBSD.org - - - - Receiving Mail - - - email - receiving - - - Receiving mail for a domain is done by the mail host. - It will collect all mail sent to the domain and store it + The mail host is a server that is responsible for + delivering and receiving mail for a host or a network. The + mail host collects all mail sent to the domain and stores it either in the default mbox or the alternative Maildir format, depending on the configuration. Once mail has been stored, it may either be read locally using - a MUA, or remotely accessed and collected + a MUA or remotely accessed and collected using protocols such as POP or - IMAP. In order to read mail locally, + IMAP. If mail is read locally, a POP or IMAP server does not need to be installed. - - Accessing Remote Mailboxes Using <acronym>POP</acronym> - and <acronym>IMAP</acronym> - - POP - IMAP - To access mailboxes remotely, access to a + To access mailboxes remotely, a POP or IMAP server is - required. These protocols allow users to connect to their - mailboxes from remote locations. Though both - POP and IMAP allow - users to remotely access mailboxes, IMAP - offers many advantages, including: - - - - IMAP can store messages on a - remote server as well as fetch them. - - - - IMAP supports concurrent - updates. - - - - IMAP can be useful over + required as these protocols allow users to connect to their + mailboxes from remote locations. IMAP offers + several advantages over POP. These + include the ability to store a copy of messages on a + remote server after they are downloaded and concurrent + updates. IMAP can be useful over low-speed links as it allows users to fetch the structure of messages without downloading them. It can also perform tasks such as searching on the server in order to minimize data transfer between clients and servers. - - - - In order to install a POP or - IMAP server, the following steps should - be performed: - - - - Use the Ports Collection to install an - IMAP or POP - server. The following POP and - IMAP servers are well known: - - - - mail/qpopper - - - - mail/teapop - - - - mail/imap-uw - - - - mail/courier-imap - - - - mail/dovecot2 - - - - - - - Where required, use the startup script that came - with the application to load the POP - or IMAP server. Those programs will - also provide a variable which can be added to - /etc/rc.conf to automate the - startup of the application's daemon whenever the system - boots. - - + Several POP and + IMAP servers are available in the Ports + Collection. These include mail/qpopper, + mail/imap-uw, + mail/courier-imap, and + mail/dovecot2. It should be noted that both POP @@ -343,29 +231,43 @@ FreeBSD.org mail is handled by 10 mx1.Fr clear-text. To secure the transmission of information across these protocols, consider tunneling sessions over &man.ssh.1; () or - using SSL (). + using SSL (). - + + - - Accessing Local Mailboxes + + Domain Name System (DNS) + + The Domain Name System (DNS) and its + daemon named play a large role in the + delivery of email. In order to deliver mail from one site to + another, the MTA will look up the remote + site in DNS to determine which host will + receive mail for the destination. This process also occurs + when mail is sent from a remote host to the + MTA. - Mailboxes may be accessed locally by directly using an - MUA on the server on which the mailbox - resides. This can be done using a built-in application - such as &man.mail.1; or by installing a - MUA from the Ports Collection.. - - + In addition to mapping hostnames to IP + addresses, DNS is responsible for storing information + specific to mail delivery, known as Mail eXchanger + MX records. The MX + record specifies which hosts will receive mail for a + particular domain. - - The Mail Host + To view the MX records for a domain, + specify the type of record. Refer to &man.host.1;, for more + details about this command: - mail host + &prompt.user; host -t mx FreeBSD.org +FreeBSD.org mail is handled by 10 mx1.FreeBSD.org - The mail host is a server that is responsible for - delivering and receiving mail for a host, or a network. - + Refer to for more + information about DNS and its + configuration. + + +