From owner-svn-doc-all@FreeBSD.ORG Thu Apr 3 14:26:28 2014 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id D883E6F3; Thu, 3 Apr 2014 14:26:28 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id C3C1228C; Thu, 3 Apr 2014 14:26:28 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s33EQSui017879; Thu, 3 Apr 2014 14:26:28 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s33EQScb017878; Thu, 3 Apr 2014 14:26:28 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201404031426.s33EQScb017878@svn.freebsd.org> From: Dru Lavigne Date: Thu, 3 Apr 2014 14:26:28 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44427 - head/en_US.ISO8859-1/books/handbook/network-servers X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 03 Apr 2014 14:26:29 -0000 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 Samba 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. - - Samba 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 net/samba36 port or - package. + software package that provides file and print services using the + SMB/CIFS protocol. This protocol is built + into µsoft.windows; systems. It can be added to + non-µsoft.windows; systems by installing the + Samba 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. + + On &os;, the Samba client + libraries can be installed using the + net/samba-libsmbclient port or package. The + client provides the ability for a &os; system to access + SMB/CIFS shares in a µsoft.windows; + network. + + A &os; system can also be configured to act as a + Samba server. This allows the + administrator to create SMB/CIFS shares on + the &os; system which can be accessed by clients running + µsoft.windows; or the Samba + client libraries. In order to configure a + Samba server on &os;, the + net/samba36 port or + package must first be installed. The rest of this section + provides an overview of how to configure a + Samba server on &os;. @@ -5006,10 +5023,9 @@ DocumentRoot /www/someotherdomain.tld The Samba Web Administration Tool (SWAT) runs as a daemon from inetd. Therefore, inetd must be enabled as shown in - , and the following line in - /etc/inetd.conf should be uncommented - before swat can be used to - configure Samba: + . To enable + swat, uncomment the following line in + /etc/inetd.conf: swat stream tcp nowait/400 root /usr/local/sbin/swat swat @@ -5017,21 +5033,20 @@ DocumentRoot /www/someotherdomain.tld the inetd configuration must be reloaded after this configuration file is changed. - Once swat has been enabled in - inetd.conf, a web browser may be used + Once swat has been enabled, + use a web browser to connect to http://localhost:901. - At first login, the system root account must be - used. + At first login, enter the credentials for root. - Once successfully logging on to the main - Samba configuration page, the - system documentation will be available, or configuration may - begin by clicking on the Globals tab. + Once logged in, the main + Samba configuration page and the + system documentation will be available. Begin configuration + by clicking on the Globals tab. The Globals section corresponds to the variables that are set in the [global] section of @@ -5041,8 +5056,8 @@ DocumentRoot /www/someotherdomain.tld Global Settings - Whether swat is being used or - /usr/local/etc/smb.conf is being edited + Whether swat is used or + /usr/local/etc/smb.conf is edited directly, the first directives encountered when configuring Samba are: @@ -5051,7 +5066,7 @@ DocumentRoot /www/someotherdomain.tld workgroup - NT Domain-Name or Workgroup-Name for the computers + The domain name or workgroup name for the computers that will be accessing this server. @@ -5060,7 +5075,7 @@ DocumentRoot /www/someotherdomain.tld netbios name - This sets the NetBIOS name by which a + The NetBIOS name by which a Samba server is known. By default it is the same as the first component of the host's DNS name. @@ -5071,7 +5086,7 @@ DocumentRoot /www/someotherdomain.tld server string - This sets the string that will be displayed with + The string that will be displayed with the net view command and some other networking tools that seek to display descriptive text about the server. @@ -5085,7 +5100,7 @@ DocumentRoot /www/someotherdomain.tld Two of the most important settings in /usr/local/etc/smb.conf 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: @@ -5094,11 +5109,11 @@ DocumentRoot /www/someotherdomain.tld security - The two most common options here are + The two most common options are security = share and security = user. 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. @@ -5133,74 +5148,59 @@ DocumentRoot /www/someotherdomain.tld backend is used, the /usr/local/etc/samba/smbpasswd file must be created to allow Samba to - authenticate clients. To provide the &unix; user accounts + authenticate clients. To provide &unix; user accounts access from &windows; clients, use the following - command: + command to add each required user to that file: - &prompt.root; smbpasswd -a username + &prompt.root; smbpasswd -a username The recommended backend is now - tdbsam, and the following command - should be used to add user accounts: + tdbsam. If this backend is selected, use the following command + to add user accounts: &prompt.root; pdbedit -a -u username - Please see the This section has only mentioned the most commonly used + settings. Refer to the Official - Samba HOWTO for additional information about - configuration options. With the basics outlined here, the - minimal required start running - Samba will be explained. Other - documentation should be consulted in addition to the - information here. + Samba HOWTO for additional information about the + available configuration options. Starting <application>Samba</application> - The net/samba36 port adds a new startup - script, which can be used to control - Samba. To enable this script, so - that it can be used for example to start, stop or restart - Samba, add the following line to - the /etc/rc.conf file: + To enable + Samba at boot time, add the following line to + /etc/rc.conf: samba_enable="YES" - Or, for fine grain control: + Alternately, its services can be started separately: nmbd_enable="YES" smbd_enable="YES" - - This will also configure - Samba to automatically start at - system boot time. - - - It is possible then to start - Samba at any time by typing: + To start + Samba now: &prompt.root; service samba start Starting SAMBA: removing stale tdbs : Starting nmbd. Starting smbd. - Please refer to for - more information about using rc scripts. - - Samba actually consists of - three separate daemons. Notice that both the + Samba consists of + three separate daemons. Both the nmbd and - smbd daemons are started by the - samba script. If winbind, - name resolution services were enabled in + smbd daemons are started by + samba_enable. If winbind + name resolution services are enabled in smb.conf, - the winbindd daemon will be + the winbindd daemon is started as well. Samba may be stopped at any @@ -5211,8 +5211,8 @@ Starting smbd. Samba 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 http://www.samba.org.