docs/53575: Change to Handbook Section 20.9

[Douglas Denault]

>Number:         53575
>Category:       docs
>Synopsis:       Change to Handbook Section 20.9
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jun 20 22:40:17 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Douglas Denault
>Release:        FreeBSD 4.8-RC i386
>Organization:
>Environment:
System: FreeBSD lighthouse.safeport.com 4.8-RC FreeBSD 4.8-RC #0: Tue Jun 3 17:30:51 EDT 2003 doug at pemaquid.safeport.com:/usr/obj/usr/src/sys/LIGHTHOUSE i386


	
>Description:
     The Handbook section 20.9, SMTP Authentication needs a small change.
     
     Sendmail 8.12.9 documentation for confDEF_AUTH_INFO says in part:

        Notice: this option is deprecated and will be removed in future 
        versions; it doesn't work for the MSP since it can't read the file.  
        Use the authinfo ruleset instead.  See also the section SMTP 
        AUTHENTICATION.

     So the section in the handbook that says:

     Add these lines to it:

        dnl set SASL options
        TRUST_AUTH_MECH(`GSSAPI DIGEST-MD5 CRAM-MD5 LOGIN')dnl
        define(`confAUTH_MECHANISMS', `GSSAPI DIGEST-MD5 CRAM-MD5 LOGIN')dnl
        define(`confDEF_AUTH_INFO', `/etc/mail/auth-info')dnl
   
     should be changed to:

        FEATURE(authinfo, `hash -o /etc/mail/authinfo')dnl

     then add a line something like:

        AuthInfo: domain.tld "U:user" "P:password" "M:PLAIN
   
     then makemap hash authinfo < authinfo

>How-To-Repeat:
	n/a
>Fix:

	Change the one line. It would be helpful to describe the format of the 
	authinfo entries


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