From wmoran@potentialtech.com  Fri Dec 12 11:07:49 2003
Return-Path: <wmoran@potentialtech.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 7226516A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 12 Dec 2003 11:07:49 -0800 (PST)
Received: from mta10.adelphia.net (mta10.adelphia.net [68.168.78.202])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A3D7143D31
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 12 Dec 2003 11:07:47 -0800 (PST)
	(envelope-from wmoran@potentialtech.com)
Received: from [68.68.113.33] by mta10.adelphia.net
          (InterMail vM.5.01.06.05 201-253-122-130-105-20030824) with SMTP
          id <20031212190747.BKSB25110.mta10.adelphia.net@[68.68.113.33]>
          for <FreeBSD-gnats-submit@freebsd.org>;
          Fri, 12 Dec 2003 14:07:47 -0500
Received: by _HOSTNAME_ (sSMTP sendmail emulation); Fri, 12 Dec 2003 14:07:46 -0500
Message-Id: <20031212190747.BKSB25110.mta10.adelphia.net@[68.68.113.33]>
Date: Fri, 12 Dec 2003 14:07:46 -0500
From: "Bill Moran" <wmoran@potentialtech.com>
Reply-To: Bill Moran <wmoran@potentialtech.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] Addition of new section to mail chapter of handbook
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         60186
>Category:       docs
>Synopsis:       [patch] Addition of new section to mail chapter of handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Dec 12 11:10:20 PST 2003
>Closed-Date:    Thu Mar 04 04:39:46 PST 2004
>Last-Modified:  Thu Mar 04 04:39:46 PST 2004
>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@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>&gt;</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@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:

From: Josef El-Rayes <josef@FreeBSD.org>
To: freebsd-gnats-submit@FreeBSD.org, wmoran@potentialtech.com
Cc:  
Subject: Re: docs/60186: [patch] Addition of new section to mail chapter of handbook
Date: Fri, 16 Jan 2004 00:48:20 +0100

 --YkJPYEFdoxh/AXLE
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Hi Bill!
 
 As i pointed out in an answer to your review request,
 I do not think that it makes sense to spend a whole
 section on this issue.
 I would, however, if you agree, commit a 2-liner
 pointing out that there is this tool for easy set up.
 
 What do you think of this?
 
 greets, josef
 
 --YkJPYEFdoxh/AXLE
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.2.2 (FreeBSD)
 
 iQEVAwUBQAcmxFnFItmnnbU8AQLDhgf/UJoFUCZkxO/NMByMjGwc7gdqbt4YVXnT
 mONILpSS1dqKECoF/sveYxgOefqt4qwn87XjRQ8WRjbK/5iX+i69ikxeHnHcs+fP
 nuKMX+R9dQVJ6wZ8CJsUuPydY+El1VeGfFNS5zeZgVAHsnMZD7W6fj2WUxsw2p7/
 s/1h2nd/X+0AHGxXGFEt6eiSX7W63L8bZLsxftXLkKvyenwA1nU9UW8fqV4IVoS7
 azsah2kRjLgDAY08tTqSGsteRlQCSppekpZkAKflzhmzQBcnUpUF8xrYYsZaWsQD
 drvoOMJE34YBzxVMQfAsN0+zwIfMhTnGqSh1ZLj2c9ORMRbRll1ftQ==
 =YBJp
 -----END PGP SIGNATURE-----
 
 --YkJPYEFdoxh/AXLE--

From: Bill Moran <wmoran@potentialtech.com>
To: freebsd-gnats-submit@FreeBSD.org, wmoran@potentialtech.com
Cc:  
Subject: Re: docs/60186: [patch] Addition of new section to mail chapter of
 handbook
Date: Fri, 16 Jan 2004 14:47:22 -0500

 I must have missed your responsed ...
 
  > I do not think that it makes sense to spend a whole
  > section on this issue.
 
 I do think it warrants a chapter, as I pointed out in
 the list discussion, because there should be other
 explanations (such as how to accomplish the same thing
 with sendmail) and this will provide a _location_ for
 those things to go.
 
  > I would, however, if you agree, commit a 2-liner
  > pointing out that there is this tool for easy set up.
 
 Well, I don't agree, however:
 1) I'm not a comitter
 2) I'd rather see something than nothing
 
 so if you're completely against this chapter, please
 commit the 2-liner you describe.  I guess I could
 write the 2-liner, if it would help, but part of the
 reason I wrote this entire section was because I
 really wasn't sure _where_ to put a 2-liner.
 
 -- 
 Bill Moran
 Potential Technologies
 http://www.potentialtech.com
 
Responsible-Changed-From-To: freebsd-doc->josef 
Responsible-Changed-By: josef 
Responsible-Changed-When: Fri Jan 16 12:15:31 PST 2004 
Responsible-Changed-Why:  
I'll take this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=60186 
Responsible-Changed-From-To: josef->trhodes 
Responsible-Changed-By: josef 
Responsible-Changed-When: Fri Jan 16 12:20:39 PST 2004 
Responsible-Changed-Why:  
Pass it to tom. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=60186 
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Thu Mar 4 04:38:55 PST 2004 
State-Changed-Why:  
See, Bill, I told you over the phone the other day that I'd get this.  :) 

Patch committed with minor modifications, thanks for the submission! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=60186 
>Unformatted:
