docs/99768: [patch] Handbook 25.9 make_smbpasswd is useless to mapping passwd

[Cheng-Lung Sung]

>Number:         99768
>Category:       docs
>Synopsis:       [patch] Handbook 25.9 make_smbpasswd is useless to mapping passwd
>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:   Tue Jul 04 09:50:10 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Cheng-Lung Sung
>Release:        FreeBSD 6.1-PRERELEASE i386
>Organization:
FreeBSD @ Taiwan
>Environment:
System: FreeBSD.csie.nctu.edu.tw 6.1-STABLE FreeBSD 6.1-STABLE #9: Thu May 11 14:31:45 CST 2006     root at FreeBSD.csie.nctu.edu.tw:/home/usr.obj/usr/src/sys/FREEBSD  i386

>Description:
- /etc/passwd contains fake passwd, and encrypted passwd can not be 
  used for make_smbpasswd, too.
- also point the document url.

>How-To-Repeat:
>Fix:

Index: network-servers/chapter.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml,v
retrieving revision 1.87
diff -u -r1.87 chapter.sgml
--- network-servers/chapter.sgml	25 Jun 2006 07:08:13 -0000	1.87
+++ network-servers/chapter.sgml	4 Jul 2006 09:34:36 -0000
@@ -4455,15 +4455,16 @@
 	  backend is used, the
 	  <filename>/usr/local/private/smbpasswd</filename> file must
 	  be created to allow <application>Samba</application> to
-	  authenticate clients.  If you would like to give all of
+	  authenticate clients.  If you would like to give 
 	  your &unix; user accounts access from &windows; clients, use the
 	  following command:</para>
 
-	<screen>&prompt.root; <userinput>grep -v "^#" /etc/passwd | make_smbpasswd > /usr/local/private/smbpasswd</userinput>
-&prompt.root; <userinput>chmod 600 /usr/local/private/smbpasswd</userinput></screen>
+	<screen>&prompt.root; <userinput>smbpasswd -a username</userinput></screen>
 
-	<para>Please see the <application>Samba</application>
-	  documentation for additional information about configuration
+	<para>Please see the
+	  <ulink 
+	  url="http://us2.samba.org/samba/docs/man/Samba-HOWTO-Collection/">Official Samba HOWTO</ulink> 
+	  for additional information about configuration
 	  options.  With the basics outlined here, you should have
 	  everything you need to start running
 	  <application>Samba</application>.</para>

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