Initial import
[samba] / docs / htmldocs / Samba3-HOWTO / cfgsmarts.html
diff --git a/docs/htmldocs/Samba3-HOWTO/cfgsmarts.html b/docs/htmldocs/Samba3-HOWTO/cfgsmarts.html
new file mode 100644 (file)
index 0000000..ece82e9
--- /dev/null
@@ -0,0 +1,180 @@
+<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter 33. Advanced Configuration Techniques</title><link rel="stylesheet" href="samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.68.1"><link rel="start" href="index.html" title="The Official Samba-3 HOWTO and Reference Guide"><link rel="up" href="optional.html" title="Part III. Advanced Configuration"><link rel="prev" href="largefile.html" title="Chapter 32. Handling Large Directories"><link rel="next" href="migration.html" title="Part IV. Migration and Updating"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter 33. Advanced Configuration Techniques</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="largefile.html">Prev</a> </td><th width="60%" align="center">Part III. Advanced Configuration</th><td width="20%" align="right"> <a accesskey="n" href="migration.html">Next</a></td></tr></table><hr></div><div class="chapter" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="cfgsmarts"></a>Chapter 33. Advanced Configuration Techniques</h2></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a href="mailto:jht@samba.org">jht@samba.org</a>&gt;</code></p></div></div></div></div><div><p class="pubdate">June 30, 2005</p></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="cfgsmarts.html#id2640518">Implementation</a></span></dt><dd><dl><dt><span class="sect2"><a href="cfgsmarts.html#id2640527">Multiple Server Hosting</a></span></dt><dt><span class="sect2"><a href="cfgsmarts.html#id2640886">Multiple Virtual Server Personalities</a></span></dt><dt><span class="sect2"><a href="cfgsmarts.html#id2641888">Multiple Virtual Server Hosting</a></span></dt></dl></dd></dl></div><p>
+<a class="indexterm" name="id2640367"></a>
+<a class="indexterm" name="id2640374"></a>
+Since the release of the first edition of this book there have been repeated requests to better document
+configuration techniques that may help a network administrator to get more out of Samba. Some users have asked
+for documentation regarding the use of the <a class="indexterm" name="id2640386"></a>include = file-name parameter.
+</p><p>
+<a class="indexterm" name="id2640396"></a>
+<a class="indexterm" name="id2640403"></a>
+Commencing around mid-2004 there has been increasing interest in the ability to host multiple Samba servers on
+one machine. There has also been an interest in the hosting of multiple Samba server personalities on one
+server.
+</p><p>
+<a class="indexterm" name="id2640418"></a>
+<a class="indexterm" name="id2640424"></a>
+Feedback from technical reviewers made the inclusion of this chapter a necessity. So, here is an 
+answer the questions that have to date not been adequately addressed. Additional user input is welcome as
+it will help this chapter to mature. What is presented here is just a small beginning.
+</p><p>
+<a class="indexterm" name="id2640440"></a>
+<a class="indexterm" name="id2640446"></a>
+<a class="indexterm" name="id2640453"></a>
+There are a number of ways in which multiple servers can be hosted on a single Samba server. Multiple server
+hosting makes it possible to host multiple domain controllers on one machine. Each such machine is
+independent, and each can be stopped or started without affecting another.
+</p><p>
+<a class="indexterm" name="id2640468"></a>
+<a class="indexterm" name="id2640475"></a>
+<a class="indexterm" name="id2640482"></a>
+Sometimes it is desirable to host multiple servers, each with its own security mode. For example, a single
+UNIX/Linux host may be a domain member server (DMS) as well as a generic anonymous print server. In this case,
+only domain member machines and domain users can access the DMS, but even guest users can access the generic
+print server. Another example of a situation where it may be beneficial to host a generic (anonymous) server
+is to host a CDROM server.
+</p><p>
+<a class="indexterm" name="id2640500"></a>
+<a class="indexterm" name="id2640507"></a>
+Some environments dictate the need to have separate servers, each with their own resources, each of which are
+accessible only by certain users or groups. This is one of the simple, but highly effective, ways that Samba
+can replace many physical Windows servers in one Samba installation.
+</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2640518"></a>Implementation</h2></div></div></div><p>
+</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2640527"></a>Multiple Server Hosting</h3></div></div></div><p>
+<a class="indexterm" name="id2640535"></a>
+<a class="indexterm" name="id2640542"></a>
+<a class="indexterm" name="id2640549"></a>
+<a class="indexterm" name="id2640556"></a>
+<a class="indexterm" name="id2640563"></a>
+<a class="indexterm" name="id2640570"></a>
+<a class="indexterm" name="id2640576"></a>
+The use of multiple server hosting involves running multiple separate instances of Samba, each with it's own
+configuration file. This method is complicated by the fact that each instance of <span class="application">nmbd</span>, <span class="application">smbd</span> and <span class="application">winbindd</span>
+must have write access to entirely separate TDB files. The ability to keep separate the TDB files used by
+<span class="application">nmbd</span>, <span class="application">smbd</span> and <span class="application">winbindd</span> can be enabled either by recompiling Samba for each server hosted so each has its
+own default TDB directories, or by configuring these in the <code class="filename">smb.conf</code> file, in which case each instance of
+<span class="application">nmbd</span>, <span class="application">smbd</span> and <span class="application">winbindd</span> must be told to start up with its own <code class="filename">smb.conf</code> configuration file.
+</p><p>
+<a class="indexterm" name="id2640660"></a>
+<a class="indexterm" name="id2640667"></a>
+<a class="indexterm" name="id2640674"></a>
+<a class="indexterm" name="id2640680"></a>
+Each instance should operate on its own IP address (that independent IP address can be an IP Alias).
+Each instance of <span class="application">nmbd</span>, <span class="application">smbd</span> and <span class="application">winbindd</span> should listen only on its own IP socket. This can be secured
+using the <a class="indexterm" name="id2640708"></a>socket address parameter. Each instance of the Samba server will have its
+own SID also, this means that the servers are discrete and independent of each other.
+</p><p>
+<a class="indexterm" name="id2640721"></a>
+<a class="indexterm" name="id2640728"></a>
+<a class="indexterm" name="id2640735"></a>
+<a class="indexterm" name="id2640742"></a>
+<a class="indexterm" name="id2640749"></a>
+<a class="indexterm" name="id2640755"></a>
+<a class="indexterm" name="id2640762"></a>
+<a class="indexterm" name="id2640769"></a>
+<a class="indexterm" name="id2640776"></a>
+The user of multiple server hosting is non-trivial, and requires careful configuration of each aspect of
+process management and start up. The <code class="filename">smb.conf</code> parameters that must be carefully configured includes:
+<a class="indexterm" name="id2640792"></a>private dir, <a class="indexterm" name="id2640800"></a>pid directory,<a class="indexterm" name="id2640807"></a>lock directory, <a class="indexterm" name="id2640814"></a>interfaces, <a class="indexterm" name="id2640822"></a>bind interfaces only, <a class="indexterm" name="id2640829"></a>netbios name, <a class="indexterm" name="id2640836"></a>workgroup, <a class="indexterm" name="id2640844"></a>socket address.
+</p><p>
+<a class="indexterm" name="id2640854"></a>
+<a class="indexterm" name="id2640861"></a>
+<a class="indexterm" name="id2640868"></a>
+Those who elect to create multiple Samba servers should have the ability to read and follow
+the Samba source code, and to modify it as needed. This mode of deployment is considered beyond the scope of
+this book. However, if someone will contribute more comprehensive documentation we will gladly review it, and
+if it is suitable extend this section of this chapter. Until such documentation becomes available the hosting
+of multiple samba servers on a single host is considered not supported for Samba-3 by the Samba Team.
+</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2640886"></a>Multiple Virtual Server Personalities</h3></div></div></div><p>
+<a class="indexterm" name="id2640894"></a>
+<a class="indexterm" name="id2640901"></a>
+<a class="indexterm" name="id2640908"></a>
+Samba has the ability to host multiple virtual servers, each of which have their own personality.  This is
+achieved by configuring an <code class="filename">smb.conf</code> file that is common to all personalities hosted.  Each server
+personality is hosted using its own <a class="indexterm" name="id2640925"></a>netbios alias name, and each has its own distinct
+<a class="indexterm" name="id2640933"></a>[global] section. Each server may have its own stanzas for services and meta-services.
+</p><p>
+<a class="indexterm" name="id2640944"></a>
+<a class="indexterm" name="id2640951"></a>
+<a class="indexterm" name="id2640958"></a>
+When hosting multiple virtual servers, each with their own personality, each can be in a different workgroup.
+Only the primary server can be a domain member or a domain controller. The personality is defined by the
+combination of the <a class="indexterm" name="id2640969"></a>security mode it is operating in, the <a class="indexterm" name="id2640977"></a>netbios aliases it has, and the <a class="indexterm" name="id2640984"></a>workgroup that is defined for it.
+</p><p>
+<a class="indexterm" name="id2640995"></a>
+<a class="indexterm" name="id2641002"></a>
+<a class="indexterm" name="id2641009"></a>
+<a class="indexterm" name="id2641016"></a>
+<a class="indexterm" name="id2641022"></a>
+<a class="indexterm" name="id2641029"></a>
+This configuration style can be used either with NetBIOS names, or using NetBIOS-less SMB over TCP services.
+If run using NetBIOS mode (the most common method) it is important that the parameter <a class="indexterm" name="id2641039"></a>smb ports = 139 should be specified in the primary <code class="filename">smb.conf</code> file. Failure to do this will result
+in Samba operating over TCP port 445 and problematic operation at best, and at worst only being able to obtain
+the functionality that is specified in the primary <code class="filename">smb.conf</code> file. The use of NetBIOS over TCP/IP using only
+TCP port 139 means that the use of the <code class="literal">%L</code> macro is fully enabled. If the <a class="indexterm" name="id2641070"></a>smb ports = 139 is not specified (the default is <em class="parameter"><code>445 139</code></em>, or if
+the value of this parameter is set at <em class="parameter"><code>139 445</code></em> then the <code class="literal">%L</code> macro
+is not serviceable.
+</p><p>
+<a class="indexterm" name="id2641099"></a>
+<a class="indexterm" name="id2641106"></a>
+<a class="indexterm" name="id2641114"></a>
+<a class="indexterm" name="id2641120"></a>
+It is possible to host multiple servers, each with their own personality, using port 445 (the NetBIOS-less SMB
+port), in which case the <code class="literal">%i</code> macro can be used to provide separate server identities (by
+IP Address). Each can have its own <a class="indexterm" name="id2641137"></a>security mode. It will be necessary to use the
+<a class="indexterm" name="id2641145"></a>interfaces, <a class="indexterm" name="id2641152"></a>bind interfaces only and IP aliases in addition to
+the <a class="indexterm" name="id2641160"></a>netbios name parameters to create the virtual servers. This method is considerably
+more complex than that using NetBIOS names only using TCP port 139.
+</p><p>
+<a class="indexterm" name="id2641173"></a>
+Consider an example environment that consists of a standalone, user-mode security Samba server and a read-only
+Windows 95 file server that has to be replaced. Instead of replacing the Windows 95 machine with a new PC, it
+is possible to add this server as a read-only anonymous file server that is hosted on the Samba server. Here
+are some parameters:
+</p><p>
+The Samba server is called <code class="literal">ELASTIC</code>, its workgroup name is <code class="literal">ROBINSNEST</code>.
+The CDROM server is called <code class="literal">CDSERVER</code> and its workgroup is <code class="literal">ARTSDEPT</code>. A
+possible implementation is shown here:
+</p><p>
+<a class="indexterm" name="id2641218"></a>
+<a class="indexterm" name="id2641225"></a>
+<a class="indexterm" name="id2641232"></a>
+<a class="indexterm" name="id2641239"></a>
+The <code class="filename">smb.conf</code> file for the master server is shown in <a href="cfgsmarts.html#elastic" title="Example 33.1. Elastic smb.conf File">Elastic smb.conf File</a>.
+This file is placed in the <code class="filename">/etc/samba</code> directory. Only the <span class="application">nmbd</span> and the <span class="application">smbd</span> daemons
+are needed. When started the server will appear in Windows Network Neighborhood as the machine
+<code class="literal">ELASTIC</code> under the workgroup <code class="literal">ROBINSNEST</code>. It is helpful if the Windows
+clients that must access this server are also in the workgroup <code class="literal">ROBINSNEST</code> as this will make
+browsing much more reliable.
+</p><div class="example"><a name="elastic"></a><p class="title"><b>Example 33.1. Elastic smb.conf File</b></p><table class="simplelist" border="0" summary="Simple list"><tr><td># Global parameters</td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2641329"></a><em class="parameter"><code>workgroup = ROBINSNEST</code></em></td></tr><tr><td><a class="indexterm" name="id2641342"></a><em class="parameter"><code>netbios name = ELASTIC</code></em></td></tr><tr><td><a class="indexterm" name="id2641355"></a><em class="parameter"><code>netbios aliases = CDSERVER</code></em></td></tr><tr><td><a class="indexterm" name="id2641368"></a><em class="parameter"><code>smb ports = 139</code></em></td></tr><tr><td><a class="indexterm" name="id2641380"></a><em class="parameter"><code>printcap name = cups</code></em></td></tr><tr><td><a class="indexterm" name="id2641393"></a><em class="parameter"><code>disable spoolss = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2641406"></a><em class="parameter"><code>show add printer wizard = No</code></em></td></tr><tr><td><a class="indexterm" name="id2641420"></a><em class="parameter"><code>printing = cups</code></em></td></tr><tr><td><a class="indexterm" name="id2641432"></a><em class="parameter"><code>include = /etc/samba/smb-%L.conf</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[homes]</code></em></td></tr><tr><td><a class="indexterm" name="id2641454"></a><em class="parameter"><code>comment = Home Directories</code></em></td></tr><tr><td><a class="indexterm" name="id2641467"></a><em class="parameter"><code>valid users = %S</code></em></td></tr><tr><td><a class="indexterm" name="id2641480"></a><em class="parameter"><code>read only = No</code></em></td></tr><tr><td><a class="indexterm" name="id2641492"></a><em class="parameter"><code>browseable = No</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[office]</code></em></td></tr><tr><td><a class="indexterm" name="id2641514"></a><em class="parameter"><code>comment = Data</code></em></td></tr><tr><td><a class="indexterm" name="id2641526"></a><em class="parameter"><code>path = /data</code></em></td></tr><tr><td><a class="indexterm" name="id2641539"></a><em class="parameter"><code>read only = No</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[printers]</code></em></td></tr><tr><td><a class="indexterm" name="id2641561"></a><em class="parameter"><code>comment = All Printers</code></em></td></tr><tr><td><a class="indexterm" name="id2641574"></a><em class="parameter"><code>path = /var/spool/samba</code></em></td></tr><tr><td><a class="indexterm" name="id2641586"></a><em class="parameter"><code>create mask = 0600</code></em></td></tr><tr><td><a class="indexterm" name="id2641599"></a><em class="parameter"><code>guest ok = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2641612"></a><em class="parameter"><code>printable = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2641624"></a><em class="parameter"><code>use client driver = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2641637"></a><em class="parameter"><code>browseable = No</code></em></td></tr></table></div><p>
+<a class="indexterm" name="id2641653"></a>
+The configuration file for the CDROM server is listed in <a href="cfgsmarts.html#cdserver" title="Example 33.2. CDROM Server smb-cdserver.conf file">CDROM Server
+smb-cdserver.conf file</a>. This file is called <code class="filename">smb-cdserver.conf</code> and it should be
+located in the <code class="filename">/etc/samba</code> directory. Machines that are in the workgroup
+<code class="literal">ARTSDEPT</code> will be able to browse this server freely.
+</p><div class="example"><a name="cdserver"></a><p class="title"><b>Example 33.2. CDROM Server smb-cdserver.conf file</b></p><table class="simplelist" border="0" summary="Simple list"><tr><td># Global parameters</td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2641719"></a><em class="parameter"><code>workgroup = ARTSDEPT</code></em></td></tr><tr><td><a class="indexterm" name="id2641732"></a><em class="parameter"><code>netbios name = CDSERVER</code></em></td></tr><tr><td><a class="indexterm" name="id2641744"></a><em class="parameter"><code>map to guest = Bad User</code></em></td></tr><tr><td><a class="indexterm" name="id2641757"></a><em class="parameter"><code>guest ok = Yes</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[carousel]</code></em></td></tr><tr><td><a class="indexterm" name="id2641779"></a><em class="parameter"><code>comment = CDROM Share</code></em></td></tr><tr><td><a class="indexterm" name="id2641792"></a><em class="parameter"><code>path = /export/cddata</code></em></td></tr><tr><td><a class="indexterm" name="id2641805"></a><em class="parameter"><code>read only = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2641817"></a><em class="parameter"><code>guest ok = Yes</code></em></td></tr></table></div><p>
+<a class="indexterm" name="id2641833"></a>
+<a class="indexterm" name="id2641840"></a>
+<a class="indexterm" name="id2641847"></a>
+<a class="indexterm" name="id2641854"></a>
+The two servers have different resources and are in separate workgroups. The server <code class="literal">ELASTIC</code>
+can only be accessed by uses who have an appropriate account on the host server. All users will be able to
+access the CDROM data that is stored in the <code class="filename">/export/cddata</code> directory. File system
+permissions should set so that the <code class="literal">others</code> user has read-only access to the directory and its
+contents. The files can be owned by root (any user other than the nobody account).
+</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2641888"></a>Multiple Virtual Server Hosting</h3></div></div></div><p>
+<a class="indexterm" name="id2641896"></a>
+<a class="indexterm" name="id2641903"></a>
+<a class="indexterm" name="id2641910"></a>
+In this example, the requirement is for a primary domain controller for the domain called
+<code class="literal">MIDEARTH</code>. The PDC will be called <code class="literal">MERLIN</code>. An extra machine called
+<code class="literal">SAURON</code> is required. Each machine will have only its own shares. Both machines belong to the
+same domain/workgroup.
+</p><p>
+<a class="indexterm" name="id2641942"></a>
+<a class="indexterm" name="id2641949"></a>
+<a class="indexterm" name="id2641956"></a>
+The master <code class="filename">smb.conf</code> file is shown in <a href="cfgsmarts.html#mastersmbc" title="Example 33.3. Master smb.conf File Global Section">the Master smb.conf File Global Section</a>.
+The two files that specify the share information for each server are shown in <a href="cfgsmarts.html#merlinsmbc" title="Example 33.4. MERLIN smb-merlin.conf File Share Section">the
+smb-merlin.conf File Share Section</a>, and <a href="cfgsmarts.html#sauronsmbc" title="Example 33.5. SAURON smb-sauron.conf File Share Section">the smb-sauron.conf File Share
+Section</a>. All three files are locate in the <code class="filename">/etc/samba</code> directory.
+</p><div class="example"><a name="mastersmbc"></a><p class="title"><b>Example 33.3. Master smb.conf File Global Section</b></p><table class="simplelist" border="0" summary="Simple list"><tr><td># Global parameters</td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2642031"></a><em class="parameter"><code>workgroup = MIDEARTH</code></em></td></tr><tr><td><a class="indexterm" name="id2642044"></a><em class="parameter"><code>netbios name = MERLIN</code></em></td></tr><tr><td><a class="indexterm" name="id2642057"></a><em class="parameter"><code>netbios aliases = SAURON</code></em></td></tr><tr><td><a class="indexterm" name="id2642070"></a><em class="parameter"><code>passdb backend = tdbsam</code></em></td></tr><tr><td><a class="indexterm" name="id2642083"></a><em class="parameter"><code>smb ports = 139</code></em></td></tr><tr><td><a class="indexterm" name="id2642096"></a><em class="parameter"><code>syslog = 0</code></em></td></tr><tr><td><a class="indexterm" name="id2642108"></a><em class="parameter"><code>printcap name = CUPS</code></em></td></tr><tr><td><a class="indexterm" name="id2642121"></a><em class="parameter"><code>show add printer wizard = No</code></em></td></tr><tr><td><a class="indexterm" name="id2642134"></a><em class="parameter"><code>add user script = /usr/sbin/useradd -m '%u'</code></em></td></tr><tr><td><a class="indexterm" name="id2642148"></a><em class="parameter"><code>delete user script = /usr/sbin/userdel -r '%u'</code></em></td></tr><tr><td><a class="indexterm" name="id2642161"></a><em class="parameter"><code>add group script = /usr/sbin/groupadd '%g'</code></em></td></tr><tr><td><a class="indexterm" name="id2642174"></a><em class="parameter"><code>delete group script = /usr/sbin/groupdel '%g'</code></em></td></tr><tr><td><a class="indexterm" name="id2642187"></a><em class="parameter"><code>add user to group script = /usr/sbin/usermod -G '%g' '%u'</code></em></td></tr><tr><td><a class="indexterm" name="id2642201"></a><em class="parameter"><code>add machine script = /usr/sbin/useradd -s /bin/false -d /var/lib/nobody '%u'</code></em></td></tr><tr><td><a class="indexterm" name="id2642215"></a><em class="parameter"><code>logon script = scripts\login.bat</code></em></td></tr><tr><td><a class="indexterm" name="id2642228"></a><em class="parameter"><code>logon path =  </code></em></td></tr><tr><td><a class="indexterm" name="id2642241"></a><em class="parameter"><code>logon drive = X:</code></em></td></tr><tr><td><a class="indexterm" name="id2642253"></a><em class="parameter"><code>domain logons = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2642266"></a><em class="parameter"><code>preferred master = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2642279"></a><em class="parameter"><code>wins support = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2642292"></a><em class="parameter"><code>printing = CUPS</code></em></td></tr><tr><td><a class="indexterm" name="id2642304"></a><em class="parameter"><code>include = /etc/samba/smb-%L.conf</code></em></td></tr></table></div><div class="example"><a name="merlinsmbc"></a><p class="title"><b>Example 33.4. MERLIN smb-merlin.conf File Share Section</b></p><table class="simplelist" border="0" summary="Simple list"><tr><td># Global parameters</td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2642346"></a><em class="parameter"><code>workgroup = MIDEARTH</code></em></td></tr><tr><td><a class="indexterm" name="id2642359"></a><em class="parameter"><code>netbios name = MERLIN</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[homes]</code></em></td></tr><tr><td><a class="indexterm" name="id2642381"></a><em class="parameter"><code>comment = Home Directories</code></em></td></tr><tr><td><a class="indexterm" name="id2642394"></a><em class="parameter"><code>valid users = %S</code></em></td></tr><tr><td><a class="indexterm" name="id2642406"></a><em class="parameter"><code>read only = No</code></em></td></tr><tr><td><a class="indexterm" name="id2642419"></a><em class="parameter"><code>browseable = No</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[office]</code></em></td></tr><tr><td><a class="indexterm" name="id2642441"></a><em class="parameter"><code>comment = Data</code></em></td></tr><tr><td><a class="indexterm" name="id2642453"></a><em class="parameter"><code>path = /data</code></em></td></tr><tr><td><a class="indexterm" name="id2642466"></a><em class="parameter"><code>read only = No</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[netlogon]</code></em></td></tr><tr><td><a class="indexterm" name="id2642488"></a><em class="parameter"><code>comment = NETLOGON</code></em></td></tr><tr><td><a class="indexterm" name="id2642500"></a><em class="parameter"><code>path = /var/lib/samba/netlogon</code></em></td></tr><tr><td><a class="indexterm" name="id2642513"></a><em class="parameter"><code>read only = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2642526"></a><em class="parameter"><code>browseable = No</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[printers]</code></em></td></tr><tr><td><a class="indexterm" name="id2642547"></a><em class="parameter"><code>comment = All Printers</code></em></td></tr><tr><td><a class="indexterm" name="id2642560"></a><em class="parameter"><code>path = /var/spool/samba</code></em></td></tr><tr><td><a class="indexterm" name="id2642573"></a><em class="parameter"><code>printable = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2642586"></a><em class="parameter"><code>use client driver = Yes</code></em></td></tr><tr><td><a class="indexterm" name="id2642599"></a><em class="parameter"><code>browseable = No</code></em></td></tr></table></div><div class="example"><a name="sauronsmbc"></a><p class="title"><b>Example 33.5. SAURON smb-sauron.conf File Share Section</b></p><table class="simplelist" border="0" summary="Simple list"><tr><td># Global parameters</td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[global]</code></em></td></tr><tr><td><a class="indexterm" name="id2642640"></a><em class="parameter"><code>workgroup = MIDEARTH</code></em></td></tr><tr><td><a class="indexterm" name="id2642653"></a><em class="parameter"><code>netbios name = SAURON</code></em></td></tr><tr><td> </td></tr><tr><td><em class="parameter"><code>[www]</code></em></td></tr><tr><td><a class="indexterm" name="id2642675"></a><em class="parameter"><code>comment = Web Pages</code></em></td></tr><tr><td><a class="indexterm" name="id2642687"></a><em class="parameter"><code>path = /srv/www/htdocs</code></em></td></tr><tr><td><a class="indexterm" name="id2642700"></a><em class="parameter"><code>read only = No</code></em></td></tr></table></div></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="largefile.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="optional.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="migration.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 32. Handling Large Directories </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Part IV. Migration and Updating</td></tr></table></div></body></html>