svn commit: r44427 - head/en_US.ISO8859-1/books/handbook/network-servers

Dru Lavigne dru at
Thu Apr 3 14:26:29 UTC 2014

Author: dru
Date: Thu Apr  3 14:26:28 2014
New Revision: 44427

  Editorial review of Samba chapter.
  Sponsored by:	iXsystems


Modified: head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml
--- head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml	Thu Apr  3 14:15:46 2014	(r44426)
+++ head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml	Thu Apr  3 14:26:28 2014	(r44427)
@@ -4967,16 +4967,33 @@ DocumentRoot /www/someotherdomain.tld
     <para><application>Samba</application> is a popular open source
-      software package that provides file and print services for
-      &; clients.  Such clients can connect to and
-      use &os; filespace as if it was a local disk drive, or
-      &os; printers as if they were local printers.</para>
-    <para><application>Samba</application> software packages should
-      be included on the &os; installation media.  If they were not
-      installed when first installing &os;, then they may be
-      installed from the <package>net/samba36</package> port or
-      package.</para>
+      software package that provides file and print services using the
+      <acronym>SMB/CIFS</acronym> protocol.  This protocol is built
+      into &; systems.  It can be added to
+      non-&; systems by installing the 
+      <application>Samba</application> client libraries.  The protocol
+      allows clients to access
+      shared data and printers.  These shares can be mapped as a local disk drive and
+      shared printers can be used as if they were local printers.</para>
+    <para>On &os;, the <application>Samba</application> client
+      libraries can be installed using the
+      <package>net/samba-libsmbclient</package> port or package.  The
+      client provides the ability for a &os; system to access
+      <acronym>SMB/CIFS</acronym> shares in a &;
+      network.</para>
+    <para>A &os; system can also be configured to act as a
+      <application>Samba</application> server.  This allows the
+      administrator to create <acronym>SMB/CIFS</acronym> shares on
+      the &os; system which can be accessed by clients running
+      &; or the <application>Samba</application>
+      client libraries.  In order to configure a
+      <application>Samba</application> server on &os;, the 
+      <package>net/samba36</package> port or
+      package must first be installed.  The rest of this section
+      provides an overview of how to configure a
+      <application>Samba</application> server on &os;.</para>
 <!-- mention LDAP, Active Directory, WinBIND, ACL, Quotas, PAM, .. -->
@@ -5006,10 +5023,9 @@ DocumentRoot /www/someotherdomain.tld
 	<para>The Samba Web Administration Tool (SWAT) runs as a
 	  daemon from <application>inetd</application>.  Therefore,
 	  <application>inetd</application> must be enabled as shown in
-	  <xref linkend="network-inetd"/>, and the following line in
-	  <filename>/etc/inetd.conf</filename> should be uncommented
-	  before <application>swat</application> can be used to
-	  configure <application>Samba</application>:</para>
+	  <xref linkend="network-inetd"/>.  To enable
+	  <application>swat</application>, uncomment the following line in
+	  <filename>/etc/inetd.conf</filename>:</para>
 	<programlisting>swat   stream  tcp     nowait/400      root    /usr/local/sbin/swat    swat</programlisting>
@@ -5017,21 +5033,20 @@ DocumentRoot /www/someotherdomain.tld
 	  the <application>inetd</application> configuration must be
 	  reloaded after this configuration file is changed.</para>
-	<para>Once <application>swat</application> has been enabled in
-	  <filename>inetd.conf</filename>, a web browser may be used
+	<para>Once <application>swat</application> has been enabled,
+	  use a web browser
 	  to connect to <uri
-	  At first login, the system <systemitem
-	    class="username">root</systemitem> account must be
-	  used.</para>
+	  At first login, enter the credentials for <systemitem
+	    class="username">root</systemitem>.</para>
 <!-- XXX screenshots go here, loader is creating them
      XXXTR: I'll believe it when I see it.  -->
-	<para>Once successfully logging on to the main
-	  <application>Samba</application> configuration page, the
-	  system documentation will be available, or configuration may
-	  begin by clicking on the <guimenu>Globals</guimenu> tab.
+	<para>Once logged in, the main
+	  <application>Samba</application> configuration page and the
+	  system documentation will be available.  Begin configuration
+	  by clicking on the <guimenu>Globals</guimenu> tab.
 	  The <guimenu>Globals</guimenu> section corresponds to the
 	  variables that are set in the <literal>[global]</literal>
 	  section of
@@ -5041,8 +5056,8 @@ DocumentRoot /www/someotherdomain.tld
 	<title>Global Settings</title>
-	<para>Whether <application>swat</application> is being used or
-	  <filename>/usr/local/etc/smb.conf</filename> is being edited
+	<para>Whether <application>swat</application> is used or
+	  <filename>/usr/local/etc/smb.conf</filename> is edited
 	  directly, the first directives encountered when configuring
 	  <application>Samba</application> are:</para>
@@ -5051,7 +5066,7 @@ DocumentRoot /www/someotherdomain.tld
-	      <para>NT Domain-Name or Workgroup-Name for the computers
+	      <para>The domain name or workgroup name for the computers
 		that will be accessing this server.</para>
@@ -5060,7 +5075,7 @@ DocumentRoot /www/someotherdomain.tld
 	    <term><literal>netbios name</literal></term>
-	      <para>This sets the NetBIOS name by which a
+	      <para>The NetBIOS name by which a
 		<application>Samba</application> server is known.
 		By default it is the same as the first component of
 		the host's <acronym>DNS</acronym> name.</para>
@@ -5071,7 +5086,7 @@ DocumentRoot /www/someotherdomain.tld
 	    <term><literal>server string</literal></term>
-	      <para>This sets the string that will be displayed with
+	      <para>The string that will be displayed with
 		the <command>net view</command> command and some other
 		networking tools that seek to display descriptive text
 		about the server.</para>
@@ -5085,7 +5100,7 @@ DocumentRoot /www/someotherdomain.tld
 	<para>Two of the most important settings in
 	  <filename>/usr/local/etc/smb.conf</filename> are the
-	  security model chosen, and the backend password format for
+	  security model and the backend password format for
 	  client users.  The following directives control these
@@ -5094,11 +5109,11 @@ DocumentRoot /www/someotherdomain.tld
-	      <para>The two most common options here are
+	      <para>The two most common options are
 		<literal>security = share</literal> and
 		<literal>security = user</literal>.  If the clients
 		use usernames that are the same as their usernames on
-		the &os; machine then user level security should be
+		the &os; machine, user level security should be
 		used.  This is the default security policy and it
 		requires clients to first log on before they can
 		access shared resources.</para>
@@ -5133,74 +5148,59 @@ DocumentRoot /www/someotherdomain.tld
 	  backend is used, the
 	  <filename>/usr/local/etc/samba/smbpasswd</filename> file
 	  must be created to allow <application>Samba</application> to
-	  authenticate clients.  To provide the &unix; user accounts
+	  authenticate clients.  To provide &unix; user accounts
 	  access from &windows; clients, use the following
-	  command:</para>
+	  command to add each required user to that file:</para>
-	<screen>&prompt.root; <userinput>smbpasswd -a username</userinput></screen>
+	<screen>&prompt.root; <userinput>smbpasswd -a <replaceable>username</replaceable></userinput></screen>
 	  <para>The recommended backend is now
-	    <literal>tdbsam</literal>, and the following command
-	    should be used to add user accounts:</para>
+	    <literal>tdbsam</literal>.  If this backend is selected, use the following command
+	    to add user accounts:</para>
 	  <screen>&prompt.root; <userinput>pdbedit -a -u <replaceable>username</replaceable></userinput></screen>
-	<para>Please see the <link
+	<para>This section has only mentioned the most commonly used
+	  settings.  Refer to the <link
-	    Samba HOWTO</link> for additional information about
-	  configuration options.  With the basics outlined here, the
-	  minimal required start running
-	  <application>Samba</application> will be explained.  Other
-	  documentation should be consulted in addition to the
-	  information here.</para>
+	    Samba HOWTO</link> for additional information about the
+	  available configuration options.</para>
       <title>Starting <application>Samba</application></title>
-      <para>The <package>net/samba36</package> port adds a new startup
-	script, which can be used to control
-	<application>Samba</application>.  To enable this script, so
-	that it can be used for example to start, stop or restart
-	<application>Samba</application>, add the following line to
-	the <filename>/etc/rc.conf</filename> file:</para>
+      <para>To enable
+	<application>Samba</application> at boot time, add the following line to
+	<filename>/etc/rc.conf</filename>:</para>
-      <para>Or, for fine grain control:</para>
+      <para>Alternately, its services can be started separately:</para>
-      <note>
-	<para>This will also configure
-	  <application>Samba</application> to automatically start at
-	  system boot time.</para>
-      </note>
-      <para>It is possible then to start
-	<application>Samba</application> at any time by typing:</para>
+      <para>To start
+	<application>Samba</application> now:</para>
       <screen>&prompt.root; <userinput>service samba start</userinput>
 Starting SAMBA: removing stale tdbs :
 Starting nmbd.
 Starting smbd.</screen>
-      <para>Please refer to <xref linkend="configtuning-rcd"/> for
-	more information about using rc scripts.</para>
-      <para><application>Samba</application> actually consists of
-	three separate daemons.  Notice that both the
+      <para><application>Samba</application> consists of
+	three separate daemons.  Both the
 	<application>nmbd</application> and
-	<application>smbd</application> daemons are started by the
-	<filename>samba</filename> script.  If winbind,
-	name resolution services were enabled in
+	<application>smbd</application> daemons are started by
+	<varname>samba_enable</varname>.  If winbind
+	name resolution services are enabled in
-	the <application>winbindd</application> daemon will be
+	the <application>winbindd</application> daemon is
 	started as well.</para>
       <para><application>Samba</application> may be stopped at any
@@ -5211,8 +5211,8 @@ Starting smbd.</screen>
       <para><application>Samba</application> is a complex software
 	suite with functionality that allows broad integration with
 	&; networks.  For more information about
-	functionality beyond the basic installation described here,
-	please see <uri
+	functionality beyond the basic configuration described here,
+	refer to <uri

More information about the svn-doc-all mailing list