svn commit: r44427 - head/en_US.ISO8859-1/books/handbook/network-servers
Dru Lavigne
dru at FreeBSD.org
Thu Apr 3 14:26:29 UTC 2014
Author: dru
Date: Thu Apr 3 14:26:28 2014
New Revision: 44427
URL: http://svnweb.freebsd.org/changeset/doc/44427
Log:
Editorial review of Samba chapter.
Sponsored by: iXsystems
Modified:
head/en_US.ISO8859-1/books/handbook/network-servers/chapter.xml
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
</indexterm>
<para><application>Samba</application> is a popular open source
- software package that provides file and print services for
- µsoft.windows; 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 µsoft.windows; systems. It can be added to
+ non-µsoft.windows; 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 µsoft.windows;
+ 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
+ µsoft.windows; 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
xlink:href="http://localhost:901">http://localhost:901</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
<sect3>
<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
<term><literal>workgroup</literal></term>
<listitem>
- <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>
</listitem>
</varlistentry>
@@ -5060,7 +5075,7 @@ DocumentRoot /www/someotherdomain.tld
<term><literal>netbios name</literal></term>
<listitem>
- <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>
<listitem>
- <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
options:</para>
@@ -5094,11 +5109,11 @@ DocumentRoot /www/someotherdomain.tld
<term><literal>security</literal></term>
<listitem>
- <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>
<note>
<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>
</note>
- <para>Please see the <link
+ <para>This section has only mentioned the most commonly used
+ settings. Refer to the <link
xlink:href="http://www.samba.org/samba/docs/man/Samba-HOWTO-Collection/">Official
- 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>
</sect3>
</sect2>
<sect2>
<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>
<programlisting>samba_enable="YES"</programlisting>
- <para>Or, for fine grain control:</para>
+ <para>Alternately, its services can be started separately:</para>
<programlisting>nmbd_enable="YES"</programlisting>
<programlisting>smbd_enable="YES"</programlisting>
- <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
<filename>smb.conf</filename>,
- 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
µsoft.windows; 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
xlink:href="http://www.samba.org">http://www.samba.org</uri>.</para>
</sect2>
</sect1>
More information about the svn-doc-head
mailing list