Initial import
[samba] / docs / htmldocs / Samba3-HOWTO / cfgsmarts.html
1 <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>
2 <a class="indexterm" name="id2640367"></a>
3 <a class="indexterm" name="id2640374"></a>
4 Since the release of the first edition of this book there have been repeated requests to better document
5 configuration techniques that may help a network administrator to get more out of Samba. Some users have asked
6 for documentation regarding the use of the <a class="indexterm" name="id2640386"></a>include = file-name parameter.
7 </p><p>
8 <a class="indexterm" name="id2640396"></a>
9 <a class="indexterm" name="id2640403"></a>
10 Commencing around mid-2004 there has been increasing interest in the ability to host multiple Samba servers on
11 one machine. There has also been an interest in the hosting of multiple Samba server personalities on one
12 server.
13 </p><p>
14 <a class="indexterm" name="id2640418"></a>
15 <a class="indexterm" name="id2640424"></a>
16 Feedback from technical reviewers made the inclusion of this chapter a necessity. So, here is an 
17 answer the questions that have to date not been adequately addressed. Additional user input is welcome as
18 it will help this chapter to mature. What is presented here is just a small beginning.
19 </p><p>
20 <a class="indexterm" name="id2640440"></a>
21 <a class="indexterm" name="id2640446"></a>
22 <a class="indexterm" name="id2640453"></a>
23 There are a number of ways in which multiple servers can be hosted on a single Samba server. Multiple server
24 hosting makes it possible to host multiple domain controllers on one machine. Each such machine is
25 independent, and each can be stopped or started without affecting another.
26 </p><p>
27 <a class="indexterm" name="id2640468"></a>
28 <a class="indexterm" name="id2640475"></a>
29 <a class="indexterm" name="id2640482"></a>
30 Sometimes it is desirable to host multiple servers, each with its own security mode. For example, a single
31 UNIX/Linux host may be a domain member server (DMS) as well as a generic anonymous print server. In this case,
32 only domain member machines and domain users can access the DMS, but even guest users can access the generic
33 print server. Another example of a situation where it may be beneficial to host a generic (anonymous) server
34 is to host a CDROM server.
35 </p><p>
36 <a class="indexterm" name="id2640500"></a>
37 <a class="indexterm" name="id2640507"></a>
38 Some environments dictate the need to have separate servers, each with their own resources, each of which are
39 accessible only by certain users or groups. This is one of the simple, but highly effective, ways that Samba
40 can replace many physical Windows servers in one Samba installation.
41 </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>
42 </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>
43 <a class="indexterm" name="id2640535"></a>
44 <a class="indexterm" name="id2640542"></a>
45 <a class="indexterm" name="id2640549"></a>
46 <a class="indexterm" name="id2640556"></a>
47 <a class="indexterm" name="id2640563"></a>
48 <a class="indexterm" name="id2640570"></a>
49 <a class="indexterm" name="id2640576"></a>
50 The use of multiple server hosting involves running multiple separate instances of Samba, each with it's own
51 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>
52 must have write access to entirely separate TDB files. The ability to keep separate the TDB files used by
53 <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
54 own default TDB directories, or by configuring these in the <code class="filename">smb.conf</code> file, in which case each instance of
55 <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.
56 </p><p>
57 <a class="indexterm" name="id2640660"></a>
58 <a class="indexterm" name="id2640667"></a>
59 <a class="indexterm" name="id2640674"></a>
60 <a class="indexterm" name="id2640680"></a>
61 Each instance should operate on its own IP address (that independent IP address can be an IP Alias).
62 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
63 using the <a class="indexterm" name="id2640708"></a>socket address parameter. Each instance of the Samba server will have its
64 own SID also, this means that the servers are discrete and independent of each other.
65 </p><p>
66 <a class="indexterm" name="id2640721"></a>
67 <a class="indexterm" name="id2640728"></a>
68 <a class="indexterm" name="id2640735"></a>
69 <a class="indexterm" name="id2640742"></a>
70 <a class="indexterm" name="id2640749"></a>
71 <a class="indexterm" name="id2640755"></a>
72 <a class="indexterm" name="id2640762"></a>
73 <a class="indexterm" name="id2640769"></a>
74 <a class="indexterm" name="id2640776"></a>
75 The user of multiple server hosting is non-trivial, and requires careful configuration of each aspect of
76 process management and start up. The <code class="filename">smb.conf</code> parameters that must be carefully configured includes:
77 <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.
78 </p><p>
79 <a class="indexterm" name="id2640854"></a>
80 <a class="indexterm" name="id2640861"></a>
81 <a class="indexterm" name="id2640868"></a>
82 Those who elect to create multiple Samba servers should have the ability to read and follow
83 the Samba source code, and to modify it as needed. This mode of deployment is considered beyond the scope of
84 this book. However, if someone will contribute more comprehensive documentation we will gladly review it, and
85 if it is suitable extend this section of this chapter. Until such documentation becomes available the hosting
86 of multiple samba servers on a single host is considered not supported for Samba-3 by the Samba Team.
87 </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>
88 <a class="indexterm" name="id2640894"></a>
89 <a class="indexterm" name="id2640901"></a>
90 <a class="indexterm" name="id2640908"></a>
91 Samba has the ability to host multiple virtual servers, each of which have their own personality.  This is
92 achieved by configuring an <code class="filename">smb.conf</code> file that is common to all personalities hosted.  Each server
93 personality is hosted using its own <a class="indexterm" name="id2640925"></a>netbios alias name, and each has its own distinct
94 <a class="indexterm" name="id2640933"></a>[global] section. Each server may have its own stanzas for services and meta-services.
95 </p><p>
96 <a class="indexterm" name="id2640944"></a>
97 <a class="indexterm" name="id2640951"></a>
98 <a class="indexterm" name="id2640958"></a>
99 When hosting multiple virtual servers, each with their own personality, each can be in a different workgroup.
100 Only the primary server can be a domain member or a domain controller. The personality is defined by the
101 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.
102 </p><p>
103 <a class="indexterm" name="id2640995"></a>
104 <a class="indexterm" name="id2641002"></a>
105 <a class="indexterm" name="id2641009"></a>
106 <a class="indexterm" name="id2641016"></a>
107 <a class="indexterm" name="id2641022"></a>
108 <a class="indexterm" name="id2641029"></a>
109 This configuration style can be used either with NetBIOS names, or using NetBIOS-less SMB over TCP services.
110 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
111 in Samba operating over TCP port 445 and problematic operation at best, and at worst only being able to obtain
112 the functionality that is specified in the primary <code class="filename">smb.conf</code> file. The use of NetBIOS over TCP/IP using only
113 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
114 the value of this parameter is set at <em class="parameter"><code>139 445</code></em> then the <code class="literal">%L</code> macro
115 is not serviceable.
116 </p><p>
117 <a class="indexterm" name="id2641099"></a>
118 <a class="indexterm" name="id2641106"></a>
119 <a class="indexterm" name="id2641114"></a>
120 <a class="indexterm" name="id2641120"></a>
121 It is possible to host multiple servers, each with their own personality, using port 445 (the NetBIOS-less SMB
122 port), in which case the <code class="literal">%i</code> macro can be used to provide separate server identities (by
123 IP Address). Each can have its own <a class="indexterm" name="id2641137"></a>security mode. It will be necessary to use the
124 <a class="indexterm" name="id2641145"></a>interfaces, <a class="indexterm" name="id2641152"></a>bind interfaces only and IP aliases in addition to
125 the <a class="indexterm" name="id2641160"></a>netbios name parameters to create the virtual servers. This method is considerably
126 more complex than that using NetBIOS names only using TCP port 139.
127 </p><p>
128 <a class="indexterm" name="id2641173"></a>
129 Consider an example environment that consists of a standalone, user-mode security Samba server and a read-only
130 Windows 95 file server that has to be replaced. Instead of replacing the Windows 95 machine with a new PC, it
131 is possible to add this server as a read-only anonymous file server that is hosted on the Samba server. Here
132 are some parameters:
133 </p><p>
134 The Samba server is called <code class="literal">ELASTIC</code>, its workgroup name is <code class="literal">ROBINSNEST</code>.
135 The CDROM server is called <code class="literal">CDSERVER</code> and its workgroup is <code class="literal">ARTSDEPT</code>. A
136 possible implementation is shown here:
137 </p><p>
138 <a class="indexterm" name="id2641218"></a>
139 <a class="indexterm" name="id2641225"></a>
140 <a class="indexterm" name="id2641232"></a>
141 <a class="indexterm" name="id2641239"></a>
142 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>.
143 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
144 are needed. When started the server will appear in Windows Network Neighborhood as the machine
145 <code class="literal">ELASTIC</code> under the workgroup <code class="literal">ROBINSNEST</code>. It is helpful if the Windows
146 clients that must access this server are also in the workgroup <code class="literal">ROBINSNEST</code> as this will make
147 browsing much more reliable.
148 </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>
149 <a class="indexterm" name="id2641653"></a>
150 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
151 smb-cdserver.conf file</a>. This file is called <code class="filename">smb-cdserver.conf</code> and it should be
152 located in the <code class="filename">/etc/samba</code> directory. Machines that are in the workgroup
153 <code class="literal">ARTSDEPT</code> will be able to browse this server freely.
154 </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>
155 <a class="indexterm" name="id2641833"></a>
156 <a class="indexterm" name="id2641840"></a>
157 <a class="indexterm" name="id2641847"></a>
158 <a class="indexterm" name="id2641854"></a>
159 The two servers have different resources and are in separate workgroups. The server <code class="literal">ELASTIC</code>
160 can only be accessed by uses who have an appropriate account on the host server. All users will be able to
161 access the CDROM data that is stored in the <code class="filename">/export/cddata</code> directory. File system
162 permissions should set so that the <code class="literal">others</code> user has read-only access to the directory and its
163 contents. The files can be owned by root (any user other than the nobody account).
164 </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>
165 <a class="indexterm" name="id2641896"></a>
166 <a class="indexterm" name="id2641903"></a>
167 <a class="indexterm" name="id2641910"></a>
168 In this example, the requirement is for a primary domain controller for the domain called
169 <code class="literal">MIDEARTH</code>. The PDC will be called <code class="literal">MERLIN</code>. An extra machine called
170 <code class="literal">SAURON</code> is required. Each machine will have only its own shares. Both machines belong to the
171 same domain/workgroup.
172 </p><p>
173 <a class="indexterm" name="id2641942"></a>
174 <a class="indexterm" name="id2641949"></a>
175 <a class="indexterm" name="id2641956"></a>
176 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>.
177 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
178 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
179 Section</a>. All three files are locate in the <code class="filename">/etc/samba</code> directory.
180 </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>