docs/60186: [patch] Addition of new section to mail chapter of handbook

[Bill Moran]

>Number:         60186
>Category:       docs
>Synopsis:       [patch] Addition of new section to mail chapter of handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Dec 12 11:10:20 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     Bill Moran
>Release:        FreeBSD 5.1-RELEASE i386
>Organization:
Potential Technologies
>Environment:
System: FreeBSD working.pt.com 5.1-RELEASE FreeBSD 5.1-RELEASE #0: Tue Sep 9 08:41:45 EDT 2003 wmoran at working.pt.com:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
	Mail section of the handbook does not offer information no how to set
	up FreeBSD for send-only configuration.
>How-To-Repeat:
	Peruse handbook for information on how to configure for outgoing mail
	only.
>Fix:
	Apply provided patch to mail/chapter.sgml (diff against 1.88)
	A rendered view of this is available:
	http://www.potentialtech.com/wmoran/handbook/outgoing-only.html
	This has been discussed on the doc mailing list:
	http://www.freebsd.org/cgi/getmsg.cgi?fetch=118774+121447+/usr/local/www/db/text/2003/freebsd-doc/20031207.freebsd-doc

--- chapter.diff begins here ---
--- chapter.orig.sgml	Sun Nov 30 19:11:42 2003
+++ chapter.sgml	Fri Dec 12 12:38:22 2003
@@ -1278,6 +1278,82 @@
 <prompt>></prompt> <userinput>^D</userinput></screen>
   </sect1>
 
+  <sect1 id="outgoing-only">
+    <sect1info>
+      <authorgroup>
+        <author>
+          <firstname>Bill</firstname>
+          <surname>Moran</surname>
+          <contrib>Contributed by </contrib>
+        </author>
+      </authorgroup>
+    </sect1info>
+    <title>Setting up to send only</title>
+    
+    <para>There are many instances where you may only want to send
+      mail through a relay. Some examples are:</para>
+      
+    <itemizedlist>
+      <listitem>
+    <para>Your computer is a desktop machine, but you'll want to use FreeBSD
+      programs such as &man.send-pr.1;.  To do so, you should use your ISP's
+      mail relay.</para>
+      </listitem>
+      
+      <listitem>
+    <para>The computer is a server that does not handle mail locally, but needs
+      to pass off all mail to a relay for processing.</para>
+      </listitem>
+    </itemizedlist>
+    
+    <para>Just about any MTA is capable of filling this particular niche.
+      Unfortunately, it can be very difficult to properly configure a full-
+      featured MTA to properly handle just offloading mail.  Programs such
+      as <application>sendmail</application> and
+      <application>postfix</application> are largely overkill for this use.
+    </para>
+    
+    <para>Additionally, if you're using a typical Internet access service, your
+      agreement may forbid you from running a "mail server".</para>
+      
+    <para>The easiest way to fulfill these needs is to install the
+      <filename role="package">mail/ssmtp</filename> port.  Execute the
+      following commands as root:</para>
+      
+    <screen>&prompt.root; <userinput>cd /usr/ports/mail/ssmtp
+&prompt.root; make install && make replace && make clean</userinput></screen>
+
+    <para>Once installed, <filename role="package">mail/ssmtp</filename> can
+      be configured with a four-line file in
+      <filename>/usr/local/etc/ssmtp/ssmtp.conf</filename></para>
+        
+    <programlisting>
+root=yourrealeamil at yourisp.com
+mailhub=mail.yourisp.com
+rewriteDomain=yourisp.com
+hostname=_HOSTNAME_</programlisting>
+
+    <para>Make sure you use your real email address for
+      <literal>root=</literal>.  Enter your ISP's outgoing mail relay in place
+      of <literal>mail.yourisp.com</literal> (some ISPs call this the
+      "outgoing mail server" or "smtp server").</para>
+        
+    <para>Make sure you disable <application>sendmail</application> by entering
+      <programlisting>sendmail_enable="NONE"</programlisting> in
+      <filename>/etc/rc.conf</filename>.</para>
+        
+    <para><filename role="package">mail/ssmtp</filename> has some other
+      options available.  See the example config file in
+      <filename>/usr/local/etc/ssmtp</filename> or the manual page for
+      <application>ssmtp</application>.</para>
+      
+    <para>Setting up <application>ssmtp</application> in this manner will allow any
+      software on your computer that needs to send mail to function properly,
+      while not violating your ISP's usage policy or allowing your computer to
+      be hijacked for spamming.</para>
+        
+  </sect1>
+
   <sect1 id="SMTP-dialup">
     <title>Using Mail with a Dialup Connection</title> 
 
--- chapter.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: