From nobody@FreeBSD.org  Sat Aug  6 16:24:25 2005
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 2C93A16A41F
	for <freebsd-gnats-submit@FreeBSD.org>; Sat,  6 Aug 2005 16:24:25 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id BF15943D5A
	for <freebsd-gnats-submit@FreeBSD.org>; Sat,  6 Aug 2005 16:24:24 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id j76GOOm5016068
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 6 Aug 2005 16:24:24 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id j76GOODs016067;
	Sat, 6 Aug 2005 16:24:24 GMT
	(envelope-from nobody)
Message-Id: <200508061624.j76GOODs016067@www.freebsd.org>
Date: Sat, 6 Aug 2005 16:24:24 GMT
From: Sam Lawrance <lawrance@FreeBSD.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: handbook - document the correct use of rc.conf "sendmail_enable" variable for 5.x and later
X-Send-Pr-Version: www-2.3

>Number:         84621
>Category:       docs
>Synopsis:       handbook - document the correct use of rc.conf "sendmail_enable" variable for 5.x and later
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    jcamou
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Aug 06 16:30:16 GMT 2005
>Closed-Date:    Thu Sep 08 10:06:52 GMT 2005
>Last-Modified:  Thu Sep 08 10:06:52 GMT 2005
>Originator:     Sam Lawrance
>Release:        
>Organization:
>Environment:
>Description:
      The mail chapter of the handbook incorrectly specifies the method of disabling sendmail.  In particular, the rc.conf variables are different for RELENG_5 and later (because sendmail_enable="NONE" is deprecated; see rc.sendmail).
>How-To-Repeat:

>Fix:
Patch here:

http://people.tecnik93.com/~sam/patch-handbook-mail

Notes:
- I don't know my way around FDP very well.
- Needs review from somebody who knows their way around sendmail and its rc.conf vars.
- I used "FreeBSD 5.0-STABLE and Later" as title; perhaps there is a better choice.
- Since the warning (see patch) applies to all versions, I moved it to the top of the section and tweaked it a tiny bit.

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->jcamou  
Responsible-Changed-By: jcamou 
Responsible-Changed-When: Wed Aug 10 04:54:31 GMT 2005 
Responsible-Changed-Why:  
I'll take a look at this.  

http://www.freebsd.org/cgi/query-pr.cgi?pr=84621 

From: Sam Lawrance <lawrance@FreeBSD.org>
To: FreeBSD-gnats-submit@FreeBSD.org
Cc:  
Subject: Re: docs/84621: handbook - document the correct use of rc.conf
	"sendmail_enable" variable for 5.x and later
Date: Thu, 08 Sep 2005 12:11:04 +1000

 Here's the patch which was deleted from the URL I supplied.  It's lucky
 that I use /tmp as such a dumping ground :-D
 
 Index: chapter.sgml
 ===================================================================
 RCS file: /home/ncvs/FreeBSD/doc/en_US.ISO8859-1/books/handbook/mail/chapter.sgml,v
 retrieving revision 1.129
 diff -u -r1.129 chapter.sgml
 --- chapter.sgml	8 Jun 2005 21:10:07 -0000	1.129
 +++ chapter.sgml	6 Aug 2005 16:07:36 -0000
 @@ -699,13 +699,29 @@
  	chosen.</para>
      </sect2>
  
 -    <sect2>
 +    <sect2 id="mail-disable-sendmail">
        <title>Disable <application>sendmail</application></title>
  
        <para>The procedure used to start
  	<application>sendmail</application> changed significantly
 -	between 4.5-RELEASE and 4.6-RELEASE.  Therefore, the procedure
 -	used to disable it is subtly different.</para>
 +	between 4.5-RELEASE, 4.6-RELEASE, and later releases.
 +	Therefore, the procedure used to disable it is subtly
 +	different.</para>
 +
 +	<warning>
 +	  <para>If you disable <application>sendmail</application>'s
 +	    outgoing mail service, it is important that you replace it
 +	    with a fully working alternative mail delivery system.  If
 +	    you choose not to, system functions such as &man.periodic.8;
 +	    will be unable to deliver their results by e-mail as they
 +	    would normally expect to.  Many parts of your system may
 +	    expect to have a functional
 +	    <application>sendmail</application>-compatible system.  If
 +	    applications continue to use
 +	    <application>sendmail</application>'s binaries to try to send
 +	    e-mail after you have disabled them, mail could go into an
 +	    inactive <application>sendmail</application> queue, and never be delivered.</para>
 +	</warning>
  
        <sect3>
  	<title>FreeBSD 4.5-STABLE before 2002/4/4 and Earlier
 @@ -727,26 +743,37 @@
  	  (Including 4.6-RELEASE and Later)</title>
  
  	<para>In order to completely disable
 -	  <application>sendmail</application> you must use</para>
 +	  <application>sendmail</application>, including the outgoing
 +	  mail service, you must use</para>
  
  	  <programlisting>sendmail_enable="NONE"</programlisting>
  
  	  <para>in <filename>/etc/rc.conf.</filename></para>
  
 -	<warning>
 -	  <para>If you disable <application>sendmail</application>'s
 -	    outgoing mail service in this way, it is important that you
 -	    replace it with a fully working alternative mail delivery
 -	    system.  If you choose not to, system functions such as
 -	    &man.periodic.8; will be unable to deliver their results by
 -	    e-mail as they would normally expect to.  Many parts of your
 -	    system may expect to have a functional
 -	    <application>sendmail</application>-compatible system.  If
 -	    applications continue to use
 -	    <application>sendmail</application>'s binaries to try to send
 -	    e-mail after you have disabled them, mail could go into an
 -	    inactive <application>sendmail</application> queue, and never be delivered.</para>
 -	</warning>
 +	<para>If you only want to disable
 +	  <application>sendmail</application>'s incoming mail service,
 +	  you should set</para>
 +
 +	  <programlisting>sendmail_enable="NO"</programlisting>
 +
 +	<para>in <filename>/etc/rc.conf</filename>.  More information on
 +	  <application>sendmail</application>'s startup options is
 +	  available from the &man.rc.sendmail.8; manual page.</para>
 +      </sect3>
 +
 +      <sect3>
 +	<title>FreeBSD 5.0-STABLE and Later</title>
 +
 +	<para>In order to completely disable
 +	  <application>sendmail</application>, including the outgoing
 +	  mail service, you must use</para>
 +
 +	  <programlisting>sendmail_submit="NO"</programlisting>
 +	  <programlisting>sendmail_submit_enable="NO"</programlisting>
 +	  <programlisting>sendmail_outbound_enable="NO"</programlisting>
 +	  <programlisting>sendmail_msp_queue_enable="NO"</programlisting>
 +
 +	  <para>in <filename>/etc/rc.conf.</filename></para>
  
  	<para>If you only want to disable
  	  <application>sendmail</application>'s incoming mail service,
 @@ -1497,9 +1524,9 @@
        this the <quote>outgoing mail server</quote> or
        <quote>SMTP server</quote>).</para>
  
 -    <para>Make sure you disable <application>sendmail</application> by
 -      setting <literal>sendmail_enable="NONE"</literal>
 -      in <filename>/etc/rc.conf</filename>.</para>
 +    <para>Make sure you disable <application>sendmail</application>,
 +      including the outgoing mail service. See
 +      <xref linkend="mail-disable-sendmail"> for details.</para>
  
      <para><filename role="package">mail/ssmtp</filename> has some
        other options available.  See the example configuration file in
 
 
State-Changed-From-To: open->closed  
State-Changed-By: jcamou 
State-Changed-When: Thu Sep 8 10:05:14 GMT 2005 
State-Changed-Why:  
I applied a slightly different version of the patch.  
Thanks Sam for the submission. 

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