Ignore:
Timestamp:
Sep 24, 2009, 9:15:13 AM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update 3.2 to 3.2.14 (final)

File:
1 edited

Legend:

Unmodified
Added
Removed

  • branches/samba-3.2.x/docs/htmldocs/manpages/smb.conf.5.html

    r272 r335  
    943943    that uses cracklib to check the password quality.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>check password script</code></em> = <code class="literal">Disabled</code>
    944944</em></span>
    945 </p><p>Example: <span class="emphasis"><em><em class="parameter"><code>check password script</code></em> = <code class="literal">check password script = /usr/local/sbin/crackcheck</code>
    946 </em></span>
    947 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536718"></a>
     945</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>check password script</code></em> = <code class="literal">/usr/local/sbin/crackcheck</code>
     946</em></span>
     947</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536717"></a>
    948948
    949949client lanman auth (G)
    950 </h3></div></div></div><a class="indexterm" name="id2536719"></a><a name="CLIENTLANMANAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbclient.8.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(8)</span></a> and other samba client
     950</h3></div></div></div><a class="indexterm" name="id2536718"></a><a name="CLIENTLANMANAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbclient.8.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(8)</span></a> and other samba client
    951951    tools will attempt to authenticate itself to servers using the
    952952    weaker LANMAN password hash. If disabled, only server which support NT
    … …  
    959959    attempted.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client lanman auth</code></em> = <code class="literal">no</code>
    960960</em></span>
    961 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536794"></a>
     961</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536793"></a>
    962962
    963963client ldap sasl wrapping (G)
    964 </h3></div></div></div><a class="indexterm" name="id2536795"></a><a name="CLIENTLDAPSASLWRAPPING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     964</h3></div></div></div><a class="indexterm" name="id2536794"></a><a name="CLIENTLDAPSASLWRAPPING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    965965        The <a class="link" href="smb.conf.5.html#CLIENTLDAPSASLWRAPPING" target="_top">client ldap sasl wrapping</a> defines whether
    966966        ldap traffic will be signed or signed and encrypted (sealed).
    … …  
    990990        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client ldap sasl wrapping</code></em> = <code class="literal">plain</code>
    991991</em></span>
    992 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536910"></a>
     992</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536909"></a>
    993993
    994994client ntlmv2 auth (G)
    995 </h3></div></div></div><a class="indexterm" name="id2536911"></a><a name="CLIENTNTLMV2AUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbclient.8.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(8)</span></a> will attempt to
     995</h3></div></div></div><a class="indexterm" name="id2536910"></a><a name="CLIENTNTLMV2AUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbclient.8.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(8)</span></a> will attempt to
    996996    authenticate itself to servers using the NTLMv2 encrypted password
    997997    response.</p><p>If enabled, only an NTLMv2 and LMv2 response (both much more
    … …  
    10051005        responses, and not the weaker LM or NTLM.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client ntlmv2 auth</code></em> = <code class="literal">no</code>
    10061006</em></span>
    1007 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536997"></a>
     1007</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2536996"></a>
    10081008
    10091009client plaintext auth (G)
    … …  
    10111011                password if the server does not support encrypted passwords.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client plaintext auth</code></em> = <code class="literal">no</code>
    10121012</em></span>
    1013 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537037"></a>
     1013</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537036"></a>
    10141014
    10151015client schannel (G)
    1016 </h3></div></div></div><a class="indexterm" name="id2537038"></a><a name="CLIENTSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1016</h3></div></div></div><a class="indexterm" name="id2537037"></a><a name="CLIENTSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    10171017    This controls whether the client offers or even demands the use of the netlogon schannel.
    10181018    <a class="link" href="smb.conf.5.html#CLIENTSCHANNEL" target="_top">client schannel = no</a> does not offer the schannel,
    … …  
    10241024</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>client schannel</code></em> = <code class="literal">yes</code>
    10251025</em></span>
    1026 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537121"></a>
     1026</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537120"></a>
    10271027
    10281028client signing (G)
    1029 </h3></div></div></div><a class="indexterm" name="id2537122"></a><a name="CLIENTSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
     1029</h3></div></div></div><a class="indexterm" name="id2537121"></a><a name="CLIENTSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
    10301030    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    10311031    and <span class="emphasis"><em>disabled</em></span>.
    … …  
    10351035</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client signing</code></em> = <code class="literal">auto</code>
    10361036</em></span>
    1037 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537175"></a>
     1037</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537174"></a>
    10381038
    10391039client use spnego (G)
    1040 </h3></div></div></div><a class="indexterm" name="id2537176"></a><a name="CLIENTUSESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p> This variable controls whether Samba clients will try
     1040</h3></div></div></div><a class="indexterm" name="id2537175"></a><a name="CLIENTUSESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p> This variable controls whether Samba clients will try
    10411041    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    10421042    supporting servers (including WindowsXP, Windows2000 and Samba
    … …  
    10441044    mechanism.  This enables Kerberos authentication in particular.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>client use spnego</code></em> = <code class="literal">yes</code>
    10451045</em></span>
    1046 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537217"></a>
     1046</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537216"></a>
    10471047
    10481048cluster addresses (G)
    1049 </h3></div></div></div><a class="indexterm" name="id2537218"></a><a name="CLUSTERADDRESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>With this parameter you can add additional addresses
     1049</h3></div></div></div><a class="indexterm" name="id2537217"></a><a name="CLUSTERADDRESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>With this parameter you can add additional addresses
    10501050        nmbd will register with a WINS server. These addresses are not
    10511051        necessarily present on all nodes simultaneously, but they will
    … …  
    10561056</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cluster addresses</code></em> = <code class="literal">10.0.0.1 10.0.0.2 10.0.0.3</code>
    10571057</em></span>
    1058 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537273"></a>
     1058</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537272"></a>
    10591059
    10601060clustering (G)
    1061 </h3></div></div></div><a class="indexterm" name="id2537274"></a><a name="CLUSTERING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should contact
     1061</h3></div></div></div><a class="indexterm" name="id2537273"></a><a name="CLUSTERING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should contact
    10621062        ctdb for accessing its tdb files and use ctdb as a backend
    10631063        for its messaging backend.
    … …  
    10661066        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>clustering</code></em> = <code class="literal">no</code>
    10671067</em></span>
    1068 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537322"></a>
     1068</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537321"></a>
    10691069
    10701070comment (S)
    1071 </h3></div></div></div><a class="indexterm" name="id2537323"></a><a name="COMMENT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a text field that is seen next to a share
     1071</h3></div></div></div><a class="indexterm" name="id2537322"></a><a name="COMMENT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a text field that is seen next to a share
    10721072        when a client does a queries the server, either via the network
    10731073        neighborhood or via <code class="literal">net view</code> to list what shares
    … …  
    10781078</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>comment</code></em> = <code class="literal">Fred's Files</code>
    10791079</em></span>
    1080 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537396"></a>
     1080</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537395"></a>
    10811081
    10821082config backend (G)
    1083 </h3></div></div></div><a class="indexterm" name="id2537397"></a><a name="CONFIGBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1083</h3></div></div></div><a class="indexterm" name="id2537396"></a><a name="CONFIGBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    10841084                This controls the backend for storing the configuration.
    10851085                Possible values are <span class="emphasis"><em>file</em></span> (the default)
    … …  
    10991099</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>config backend</code></em> = <code class="literal">registry</code>
    11001100</em></span>
    1101 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537486"></a>
     1101</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537485"></a>
    11021102
    11031103config file (G)
    1104 </h3></div></div></div><a class="indexterm" name="id2537487"></a><a name="CONFIGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the config file
     1104</h3></div></div></div><a class="indexterm" name="id2537486"></a><a name="CONFIGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the config file
    11051105        to use, instead of the default (usually <code class="filename">smb.conf</code>).
    11061106        There is a chicken and egg problem here as this option is set
    … …  
    11121112        clients).</p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>config file</code></em> = <code class="literal">/usr/local/samba/lib/smb.conf.%m</code>
    11131113</em></span>
    1114 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537552"></a>
     1114</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537551"></a>
    11151115
    11161116copy (S)
    1117 </h3></div></div></div><a class="indexterm" name="id2537553"></a><a name="COPY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows you to "clone" service
     1117</h3></div></div></div><a class="indexterm" name="id2537552"></a><a name="COPY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows you to "clone" service
    11181118        entries. The specified service is simply duplicated under the
    11191119        current service's name. Any parameters specified in the current
    … …  
    11251125</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>copy</code></em> = <code class="literal">otherservice</code>
    11261126</em></span>
    1127 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537614"></a>
     1127</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537613"></a>
    11281128
    11291129<a name="CREATEMODE"></a>create mode
    1130 </h3></div></div></div><a class="indexterm" name="id2537615"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#CREATEMASK">create mask</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537641"></a>
     1130</h3></div></div></div><a class="indexterm" name="id2537614"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#CREATEMASK">create mask</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537640"></a>
    11311131
    11321132create mask (S)
    1133 </h3></div></div></div><a class="indexterm" name="id2537642"></a><a name="CREATEMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1133</h3></div></div></div><a class="indexterm" name="id2537641"></a><a name="CREATEMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11341134        When a file is created, the necessary permissions are calculated according to the mapping from DOS modes to
    11351135        UNIX permissions, and the resulting UNIX mode is then bit-wise 'AND'ed with this parameter. This parameter may
    … …  
    11521152</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>create mask</code></em> = <code class="literal">0775</code>
    11531153</em></span>
    1154 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537761"></a>
     1154</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537760"></a>
    11551155
    11561156csc policy (S)
    1157 </h3></div></div></div><a class="indexterm" name="id2537762"></a><a name="CSCPOLICY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1157</h3></div></div></div><a class="indexterm" name="id2537761"></a><a name="CSCPOLICY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11581158        This stands for <span class="emphasis"><em>client-side caching policy</em></span>, and specifies how clients capable of offline
    11591159        caching will cache the files in the share. The valid values are: manual, documents, programs, disable.
    … …  
    11671167</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>csc policy</code></em> = <code class="literal">programs</code>
    11681168</em></span>
    1169 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537837"></a>
     1169</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537836"></a>
    11701170
    11711171ctdbd socket (G)
    1172 </h3></div></div></div><a class="indexterm" name="id2537838"></a><a name="CTDBDSOCKET"></a><div class="variablelist"><dl><dt></dt><dd><p>If you set <code class="literal">clustering=yes</code>,
     1172</h3></div></div></div><a class="indexterm" name="id2537837"></a><a name="CTDBDSOCKET"></a><div class="variablelist"><dl><dt></dt><dd><p>If you set <code class="literal">clustering=yes</code>,
    11731173        you need to tell Samba where ctdbd listens on its unix domain
    11741174        socket. The default path as of ctdb 1.0 is /tmp/ctdb.socket which
    … …  
    11781178</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ctdbd socket</code></em> = <code class="literal">/tmp/ctdb.socket</code>
    11791179</em></span>
    1180 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537897"></a>
     1180</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537896"></a>
    11811181
    11821182cups options (S)
    1183 </h3></div></div></div><a class="indexterm" name="id2537898"></a><a name="CUPSOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1183</h3></div></div></div><a class="indexterm" name="id2537897"></a><a name="CUPSOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    11841184    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is
    11851185    set to <code class="constant">cups</code>.  Its value is a free form string of options
    … …  
    12031203</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups options</code></em> = <code class="literal">"raw media=a4"</code>
    12041204</em></span>
    1205 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537995"></a>
     1205</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2537994"></a>
    12061206
    12071207cups server (G)
    1208 </h3></div></div></div><a class="indexterm" name="id2537996"></a><a name="CUPSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1208</h3></div></div></div><a class="indexterm" name="id2537995"></a><a name="CUPSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12091209    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is set to <code class="constant">cups</code>.
    12101210    </p><p>
    … …  
    12201220</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>cups server</code></em> = <code class="literal">mycupsserver:1631</code>
    12211221</em></span>
    1222 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538093"></a>
     1222</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538092"></a>
    12231223
    12241224deadtime (G)
    1225 </h3></div></div></div><a class="indexterm" name="id2538094"></a><a name="DEADTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a decimal integer)
     1225</h3></div></div></div><a class="indexterm" name="id2538093"></a><a name="DEADTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a decimal integer)
    12261226    represents the number of minutes of inactivity before a connection
    12271227    is considered dead, and it is disconnected. The deadtime only takes
    … …  
    12351235</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>deadtime</code></em> = <code class="literal">15</code>
    12361236</em></span>
    1237 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538170"></a>
     1237</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538169"></a>
    12381238
    12391239debug class (G)
    1240 </h3></div></div></div><a class="indexterm" name="id2538171"></a><a name="DEBUGCLASS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1240</h3></div></div></div><a class="indexterm" name="id2538170"></a><a name="DEBUGCLASS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12411241    With this boolean parameter enabled, the debug class (DBGC_CLASS)
    12421242    will be displayed in the debug header.
    … …  
    12461246    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug class</code></em> = <code class="literal">no</code>
    12471247</em></span>
    1248 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538221"></a>
     1248</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538220"></a>
    12491249
    12501250debug hires timestamp (G)
    1251 </h3></div></div></div><a class="indexterm" name="id2538222"></a><a name="DEBUGHIRESTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1251</h3></div></div></div><a class="indexterm" name="id2538221"></a><a name="DEBUGHIRESTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12521252    Sometimes the timestamps in the log messages are needed with a resolution of higher that seconds, this
    12531253    boolean parameter adds microsecond resolution to the timestamp  message header when turned on.
    … …  
    12561256    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug hires timestamp</code></em> = <code class="literal">no</code>
    12571257</em></span>
    1258 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538276"></a>
     1258</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538275"></a>
    12591259
    12601260debug pid (G)
    1261 </h3></div></div></div><a class="indexterm" name="id2538277"></a><a name="DEBUGPID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1261</h3></div></div></div><a class="indexterm" name="id2538276"></a><a name="DEBUGPID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12621262    When using only one log file for more then one forked <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>-process there may be hard to follow which process outputs which
    12631263    message. This boolean parameter is adds the process-id to the timestamp message headers in the
    … …  
    12671267    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug pid</code></em> = <code class="literal">no</code>
    12681268</em></span>
    1269 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538338"></a>
     1269</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538337"></a>
    12701270
    12711271debug prefix timestamp (G)
    1272 </h3></div></div></div><a class="indexterm" name="id2538339"></a><a name="DEBUGPREFIXTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1272</h3></div></div></div><a class="indexterm" name="id2538338"></a><a name="DEBUGPREFIXTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12731273    With this option enabled, the timestamp message header is prefixed to the debug message without the
    12741274    filename and function information that is included with the <a class="link" href="smb.conf.5.html#DEBUGTIMESTAMP" target="_top">debug timestamp</a>
    … …  
    12781278    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug prefix timestamp</code></em> = <code class="literal">no</code>
    12791279</em></span>
    1280 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538401"></a>
     1280</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538400"></a>
    12811281
    12821282<a name="TIMESTAMPLOGS"></a>timestamp logs
    1283 </h3></div></div></div><a class="indexterm" name="id2538402"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DEBUGTIMESTAMP">debug timestamp</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538428"></a>
     1283</h3></div></div></div><a class="indexterm" name="id2538401"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DEBUGTIMESTAMP">debug timestamp</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538427"></a>
    12841284
    12851285debug timestamp (G)
    1286 </h3></div></div></div><a class="indexterm" name="id2538429"></a><a name="DEBUGTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1286</h3></div></div></div><a class="indexterm" name="id2538428"></a><a name="DEBUGTIMESTAMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12871287    Samba debug log messages are timestamped by default. If you are running at a high
    12881288    <a class="link" href="smb.conf.5.html#DEBUGLEVEL" target="_top">debug level</a> these timestamps can be distracting. This
    … …  
    12931293
    12941294debug uid (G)
    1295 </h3></div></div></div><a class="indexterm" name="id2538478"></a><a name="DEBUGUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1295</h3></div></div></div><a class="indexterm" name="id2538477"></a><a name="DEBUGUID"></a><div class="variablelist"><dl><dt></dt><dd><p>
    12961296    Samba is sometimes run as root and sometime run as the connected user, this boolean parameter inserts the
    12971297    current euid, egid, uid and gid to the timestamp message headers in the log file if turned on.
    … …  
    13001300    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>debug uid</code></em> = <code class="literal">no</code>
    13011301</em></span>
    1302 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538530"></a>
     1302</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538529"></a>
    13031303
    13041304default case (S)
    1305 </h3></div></div></div><a class="indexterm" name="id2538531"></a><a name="DEFAULTCASE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>.
     1305</h3></div></div></div><a class="indexterm" name="id2538530"></a><a name="DEFAULTCASE"></a><div class="variablelist"><dl><dt></dt><dd><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>.
    13061306        Also note the <a class="link" href="smb.conf.5.html#SHORTPRESERVECASE" target="_top">short preserve case</a> parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>default case</code></em> = <code class="literal">lower</code>
    13071307</em></span>
    1308 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538584"></a>
     1308</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538583"></a>
    13091309
    13101310default devmode (S)
    1311 </h3></div></div></div><a class="indexterm" name="id2538585"></a><a name="DEFAULTDEVMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only applicable to <a class="link" href="smb.conf.5.html#PRINTABLE" target="_top">printable</a> services.
     1311</h3></div></div></div><a class="indexterm" name="id2538584"></a><a name="DEFAULTDEVMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only applicable to <a class="link" href="smb.conf.5.html#PRINTABLE" target="_top">printable</a> services.
    13121312    When smbd is serving Printer Drivers to Windows NT/2k/XP clients, each printer on the Samba
    13131313    server has a Device Mode which defines things such as paper size and
    … …  
    13321332</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>default devmode</code></em> = <code class="literal">yes</code>
    13331333</em></span>
    1334 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538672"></a>
     1334</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538671"></a>
    13351335
    13361336<a name="DEFAULT"></a>default
    1337 </h3></div></div></div><a class="indexterm" name="id2538673"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DEFAULTSERVICE">default service</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538699"></a>
     1337</h3></div></div></div><a class="indexterm" name="id2538672"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DEFAULTSERVICE">default service</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538698"></a>
    13381338
    13391339default service (G)
    1340 </h3></div></div></div><a class="indexterm" name="id2538700"></a><a name="DEFAULTSERVICE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a service
     1340</h3></div></div></div><a class="indexterm" name="id2538699"></a><a name="DEFAULTSERVICE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the name of a service
    13411341        which will be connected to if the service actually requested cannot
    13421342        be found. Note that the square brackets are <span class="emphasis"><em>NOT</em></span>
    … …  
    13521352</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>default service</code></em> = <code class="literal">pub</code>
    13531353</em></span>
    1354 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538801"></a>
     1354</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538800"></a>
    13551355
    13561356defer sharing violations (G)
    1357 </h3></div></div></div><a class="indexterm" name="id2538802"></a><a name="DEFERSHARINGVIOLATIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1357</h3></div></div></div><a class="indexterm" name="id2538801"></a><a name="DEFERSHARINGVIOLATIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    13581358        Windows allows specifying how a file will be shared with
    13591359        other processes when it is opened. Sharing violations occur when
    … …  
    13681368        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>defer sharing violations</code></em> = <code class="literal">True</code>
    13691369</em></span>
    1370 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538856"></a>
     1370</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538855"></a>
    13711371
    13721372delete group script (G)
    1373 </h3></div></div></div><a class="indexterm" name="id2538857"></a><a name="DELETEGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
     1373</h3></div></div></div><a class="indexterm" name="id2538856"></a><a name="DELETEGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
    13741374        be run <span class="emphasis"><em>AS ROOT</em></span> <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when a group is requested to be deleted.
    13751375        It will expand any <em class="parameter"><code>%g</code></em> to the group name passed. 
    … …  
    13771377        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>delete group script</code></em> = <code class="literal"></code>
    13781378</em></span>
    1379 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538912"></a>
     1379</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2538911"></a>
    13801380
    13811381deleteprinter command (G)
    1382 </h3></div></div></div><a class="indexterm" name="id2538913"></a><a name="DELETEPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printer
     1382</h3></div></div></div><a class="indexterm" name="id2538912"></a><a name="DELETEPRINTERCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printer
    13831383    support for Windows NT/2000 clients in Samba 2.2, it is now
    13841384    possible to delete a printer at run time by issuing the
    … …  
    13981398</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>deleteprinter command</code></em> = <code class="literal">/usr/bin/removeprinter</code>
    13991399</em></span>
    1400 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539039"></a>
     1400</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539038"></a>
    14011401
    14021402delete readonly (S)
    1403 </h3></div></div></div><a class="indexterm" name="id2539040"></a><a name="DELETEREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows readonly files to be deleted. 
     1403</h3></div></div></div><a class="indexterm" name="id2539039"></a><a name="DELETEREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows readonly files to be deleted. 
    14041404        This is not normal DOS semantics, but is allowed by UNIX.</p><p>This option may be useful for running applications such
    14051405        as rcs, where UNIX file ownership prevents changing file
    … …  
    14091409
    14101410delete share command (G)
    1411 </h3></div></div></div><a class="indexterm" name="id2539086"></a><a name="DELETESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1411</h3></div></div></div><a class="indexterm" name="id2539085"></a><a name="DELETESHARECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14121412        Samba 2.2.0 introduced the ability to dynamically add and delete shares via the Windows NT 4.0 Server
    14131413        Manager.  The <em class="parameter"><code>delete share command</code></em> is used to define an external
    … …  
    14351435</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>delete share command</code></em> = <code class="literal">/usr/local/bin/delshare</code>
    14361436</em></span>
    1437 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539236"></a>
     1437</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539235"></a>
    14381438
    14391439delete user from group script (G)
    1440 </h3></div></div></div><a class="indexterm" name="id2539237"></a><a name="DELETEUSERFROMGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Full path to the script that will be called when
     1440</h3></div></div></div><a class="indexterm" name="id2539236"></a><a name="DELETEUSERFROMGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Full path to the script that will be called when
    14411441        a user is removed from a group using the Windows NT domain administration
    14421442        tools. It will be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> <span class="emphasis"><em>AS ROOT</em></span>.
    … …  
    14471447</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>delete user from group script</code></em> = <code class="literal">/usr/sbin/deluser %u %g</code>
    14481448</em></span>
    1449 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539316"></a>
     1449</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539315"></a>
    14501450
    14511451delete user script (G)
    1452 </h3></div></div></div><a class="indexterm" name="id2539317"></a><a name="DELETEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
     1452</h3></div></div></div><a class="indexterm" name="id2539316"></a><a name="DELETEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the full pathname to a script that will
    14531453        be run by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when managing users
    14541454        with remote RPC (NT) tools.
    … …  
    14621462
    14631463delete veto files (S)
    1464 </h3></div></div></div><a class="indexterm" name="id2539394"></a><a name="DELETEVETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used when Samba is attempting to
     1464</h3></div></div></div><a class="indexterm" name="id2539393"></a><a name="DELETEVETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used when Samba is attempting to
    14651465        delete a directory that contains one or more vetoed directories
    14661466        (see the <a class="link" href="smb.conf.5.html#VETOFILES" target="_top">veto files</a>
    … …  
    14761476        is deleted (so long as the user has permissions to do so).</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>delete veto files</code></em> = <code class="literal">no</code>
    14771477</em></span>
    1478 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539478"></a>
     1478</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539477"></a>
    14791479
    14801480dfree cache time (S)
    1481 </h3></div></div></div><a class="indexterm" name="id2539479"></a><a name="DFREECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1481</h3></div></div></div><a class="indexterm" name="id2539478"></a><a name="DFREECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14821482        The <em class="parameter"><code>dfree cache time</code></em> should only be used on systems where a problem
    14831483        occurs with the internal disk space calculations. This has been known to happen with Ultrix, but may occur
    … …  
    14921492        </p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>dfree cache time</code></em> = <code class="literal">dfree cache time = 60</code>
    14931493</em></span>
    1494 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539551"></a>
     1494</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539550"></a>
    14951495
    14961496dfree command (S)
    1497 </h3></div></div></div><a class="indexterm" name="id2539552"></a><a name="DFREECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1497</h3></div></div></div><a class="indexterm" name="id2539551"></a><a name="DFREECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    14981498        The <em class="parameter"><code>dfree command</code></em> setting should only be used on systems where a
    14991499        problem occurs with the internal disk space calculations. This has been known to happen with Ultrix, but may
    … …  
    15331533        </p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>dfree command</code></em> = <code class="literal">/usr/local/samba/bin/dfree</code>
    15341534</em></span>
    1535 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539672"></a>
     1535</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539671"></a>
    15361536
    15371537<a name="DIRECTORYMODE"></a>directory mode
    1538 </h3></div></div></div><a class="indexterm" name="id2539673"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DIRECTORYMASK">directory mask</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539699"></a>
     1538</h3></div></div></div><a class="indexterm" name="id2539672"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#DIRECTORYMASK">directory mask</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539698"></a>
    15391539
    15401540directory mask (S)
    1541 </h3></div></div></div><a class="indexterm" name="id2539700"></a><a name="DIRECTORYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is the octal modes which are
     1541</h3></div></div></div><a class="indexterm" name="id2539699"></a><a name="DIRECTORYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is the octal modes which are
    15421542    used when converting DOS modes to UNIX modes when creating UNIX
    15431543    directories.</p><p>When a directory is created, the necessary permissions are
    … …  
    15571557</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>directory mask</code></em> = <code class="literal">0775</code>
    15581558</em></span>
    1559 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539804"></a>
     1559</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539803"></a>
    15601560
    15611561directory security mask (S)
    1562 </h3></div></div></div><a class="indexterm" name="id2539805"></a><a name="DIRECTORYSECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls what UNIX permission bits
     1562</h3></div></div></div><a class="indexterm" name="id2539804"></a><a name="DIRECTORYSECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls what UNIX permission bits
    15631563    will be set when a Windows NT client is manipulating the UNIX
    15641564    permission on a directory using the native NT security dialog
    … …  
    15801580</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>directory security mask</code></em> = <code class="literal">0700</code>
    15811581</em></span>
    1582 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539905"></a>
     1582</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539904"></a>
    15831583
    15841584disable netbios (G)
    1585 </h3></div></div></div><a class="indexterm" name="id2539906"></a><a name="DISABLENETBIOS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable netbios support
     1585</h3></div></div></div><a class="indexterm" name="id2539905"></a><a name="DISABLENETBIOS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable netbios support
    15861586    in Samba. Netbios is the only available form of browsing in
    15871587    all windows versions except for 2000 and XP. </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>Clients that only support netbios won't be able to
    … …  
    15891589        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>disable netbios</code></em> = <code class="literal">no</code>
    15901590</em></span>
    1591 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539951"></a>
     1591</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2539950"></a>
    15921592
    15931593disable spoolss (G)
    1594 </h3></div></div></div><a class="indexterm" name="id2539952"></a><a name="DISABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable Samba's support
     1594</h3></div></div></div><a class="indexterm" name="id2539951"></a><a name="DISABLESPOOLSS"></a><div class="variablelist"><dl><dt></dt><dd><p>Enabling this parameter will disable Samba's support
    15951595    for the SPOOLSS set of MS-RPC's and will yield identical behavior
    15961596    as Samba 2.0.x.  Windows NT/2000 clients will downgrade to using
    … …  
    16041604</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>disable spoolss</code></em> = <code class="literal">no</code>
    16051605</em></span>
    1606 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540002"></a>
     1606</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540001"></a>
    16071607
    16081608display charset (G)
    1609 </h3></div></div></div><a class="indexterm" name="id2540003"></a><a name="DISPLAYCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1609</h3></div></div></div><a class="indexterm" name="id2540002"></a><a name="DISPLAYCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16101610        Specifies the charset that samba will use to print messages to stdout and stderr.
    16111611        The default value is "LOCALE", which means automatically set, depending on the
    … …  
    16161616</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>display charset</code></em> = <code class="literal">UTF8</code>
    16171617</em></span>
    1618 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540068"></a>
     1618</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540067"></a>
    16191619
    16201620dmapi support (S)
    1621 </h3></div></div></div><a class="indexterm" name="id2540069"></a><a name="DMAPISUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should use DMAPI to
     1621</h3></div></div></div><a class="indexterm" name="id2540068"></a><a name="DMAPISUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether Samba should use DMAPI to
    16221622        determine whether a file is offline or not. This would typically
    16231623        be used in conjunction with a hierarchical storage system that
    … …  
    16341634        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dmapi support</code></em> = <code class="literal">no</code>
    16351635</em></span>
    1636 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540127"></a>
     1636</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540126"></a>
    16371637
    16381638dns proxy (G)
    1639 </h3></div></div></div><a class="indexterm" name="id2540128"></a><a name="DNSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies that <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> when acting as a WINS server and
     1639</h3></div></div></div><a class="indexterm" name="id2540127"></a><a name="DNSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies that <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> when acting as a WINS server and
    16401640        finding that a NetBIOS name has not been registered, should treat the
    16411641        NetBIOS name word-for-word as a DNS name and do a lookup with the DNS server
    … …  
    16461646        action.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dns proxy</code></em> = <code class="literal">yes</code>
    16471647</em></span>
    1648 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540191"></a>
     1648</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540190"></a>
    16491649
    16501650domain logons (G)
    1651 </h3></div></div></div><a class="indexterm" name="id2540192"></a><a name="DOMAINLOGONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1651</h3></div></div></div><a class="indexterm" name="id2540191"></a><a name="DOMAINLOGONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16521652        If set to <code class="constant">yes</code>, the Samba server will
    16531653        provide the netlogon service for Windows 9X network logons for the
    … …  
    16591659        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>domain logons</code></em> = <code class="literal">no</code>
    16601660</em></span>
    1661 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540244"></a>
     1661</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540243"></a>
    16621662
    16631663domain master (G)
    1664 </h3></div></div></div><a class="indexterm" name="id2540245"></a><a name="DOMAINMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1664</h3></div></div></div><a class="indexterm" name="id2540244"></a><a name="DOMAINMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    16651665        Tell <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> to enable
    16661666        WAN-wide browse list collation. Setting this option causes <code class="literal">nmbd</code> to claim a
    … …  
    16881688        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>domain master</code></em> = <code class="literal">auto</code>
    16891689</em></span>
    1690 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540435"></a>
     1690</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540434"></a>
    16911691
    16921692dont descend (S)
    1693 </h3></div></div></div><a class="indexterm" name="id2540436"></a><a name="DONTDESCEND"></a><div class="variablelist"><dl><dt></dt><dd><p>There are certain directories on some systems
     1693</h3></div></div></div><a class="indexterm" name="id2540435"></a><a name="DONTDESCEND"></a><div class="variablelist"><dl><dt></dt><dd><p>There are certain directories on some systems
    16941694        (e.g., the <code class="filename">/proc</code> tree under Linux) that are either not
    16951695        of interest to clients or are infinitely deep (recursive). This
    … …  
    17021702</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>dont descend</code></em> = <code class="literal">/proc,/dev</code>
    17031703</em></span>
    1704 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540513"></a>
     1704</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540512"></a>
    17051705
    17061706dos charset (G)
    1707 </h3></div></div></div><a class="indexterm" name="id2540514"></a><a name="DOSCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>DOS SMB clients assume the server has
     1707</h3></div></div></div><a class="indexterm" name="id2540513"></a><a name="DOSCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>DOS SMB clients assume the server has
    17081708        the same charset as they do. This option specifies which
    17091709        charset Samba should talk to DOS clients.
    … …  
    17131713
    17141714dos filemode (S)
    1715 </h3></div></div></div><a class="indexterm" name="id2540556"></a><a name="DOSFILEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p> The default behavior in Samba is to provide
     1715</h3></div></div></div><a class="indexterm" name="id2540555"></a><a name="DOSFILEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p> The default behavior in Samba is to provide
    17161716        UNIX-like behavior where only the owner of a file/directory is
    17171717        able to change the permissions on it.  However, this behavior
    … …  
    17241724        file/directory may also be changed.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filemode</code></em> = <code class="literal">no</code>
    17251725</em></span>
    1726 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540601"></a>
     1726</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540600"></a>
    17271727
    17281728dos filetime resolution (S)
    1729 </h3></div></div></div><a class="indexterm" name="id2540602"></a><a name="DOSFILETIMERESOLUTION"></a><div class="variablelist"><dl><dt></dt><dd><p>Under the DOS and Windows FAT filesystem, the finest
     1729</h3></div></div></div><a class="indexterm" name="id2540601"></a><a name="DOSFILETIMERESOLUTION"></a><div class="variablelist"><dl><dt></dt><dd><p>Under the DOS and Windows FAT filesystem, the finest
    17301730        granularity on time resolution is two seconds. Setting this parameter
    17311731        for a share causes Samba to round the reported time down to the
    … …  
    17421742        happy.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filetime resolution</code></em> = <code class="literal">no</code>
    17431743</em></span>
    1744 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540665"></a>
     1744</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540664"></a>
    17451745
    17461746dos filetimes (S)
    1747 </h3></div></div></div><a class="indexterm" name="id2540666"></a><a name="DOSFILETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>Under DOS and Windows, if a user can write to a
     1747</h3></div></div></div><a class="indexterm" name="id2540665"></a><a name="DOSFILETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>Under DOS and Windows, if a user can write to a
    17481748        file they can change the timestamp on it. Under POSIX semantics,
    17491749        only the owner of the file or root may change the timestamp. By
    … …  
    17591759        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>dos filetimes</code></em> = <code class="literal">yes</code>
    17601760</em></span>
    1761 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540730"></a>
     1761</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540729"></a>
    17621762
    17631763ea support (S)
    1764 </h3></div></div></div><a class="indexterm" name="id2540731"></a><a name="EASUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will allow clients to attempt to store OS/2 style Extended
     1764</h3></div></div></div><a class="indexterm" name="id2540730"></a><a name="EASUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will allow clients to attempt to store OS/2 style Extended
    17651765    attributes on a share. In order to enable this parameter the underlying filesystem exported by
    17661766    the share must support extended attributes (such as provided on XFS and EXT3 on Linux, with the
    … …  
    17691769                extended attributes must be compiled into the Linux kernel.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ea support</code></em> = <code class="literal">no</code>
    17701770</em></span>
    1771 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540784"></a>
     1771</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540783"></a>
    17721772
    17731773enable asu support (G)
    1774 </h3></div></div></div><a class="indexterm" name="id2540785"></a><a name="ENABLEASUSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>Hosts running the "Advanced Server for Unix (ASU)" product
     1774</h3></div></div></div><a class="indexterm" name="id2540784"></a><a name="ENABLEASUSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>Hosts running the "Advanced Server for Unix (ASU)" product
    17751775    require some special accomodations such as creating a builtin [ADMIN$]
    17761776    share that only supports IPC connections.  The has been the default
    … …  
    17801780    an [ADMIN$] file share in smb.conf.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enable asu support</code></em> = <code class="literal">no</code>
    17811781</em></span>
    1782 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540828"></a>
     1782</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540827"></a>
    17831783
    17841784enable privileges (G)
    1785 </h3></div></div></div><a class="indexterm" name="id2540829"></a><a name="ENABLEPRIVILEGES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1785</h3></div></div></div><a class="indexterm" name="id2540828"></a><a name="ENABLEPRIVILEGES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    17861786        This parameter controls whether or not smbd will honor privileges assigned to specific SIDs via either
    17871787         <code class="literal">net rpc rights</code> or one of the Windows user and group manager tools.  This parameter is
    … …  
    17961796        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enable privileges</code></em> = <code class="literal">yes</code>
    17971797</em></span>
    1798 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540889"></a>
     1798</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540888"></a>
    17991799
    18001800encrypt passwords (G)
    1801 </h3></div></div></div><a class="indexterm" name="id2540890"></a><a name="ENCRYPTPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls whether encrypted passwords
     1801</h3></div></div></div><a class="indexterm" name="id2540889"></a><a name="ENCRYPTPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls whether encrypted passwords
    18021802    will be negotiated with the client. Note that Windows NT 4.0 SP3 and
    18031803    above and also Windows 98 will by default expect encrypted passwords
    … …  
    18221822        server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>encrypt passwords</code></em> = <code class="literal">yes</code>
    18231823</em></span>
    1824 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540993"></a>
     1824</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2540992"></a>
    18251825
    18261826enhanced browsing (G)
    1827 </h3></div></div></div><a class="indexterm" name="id2540994"></a><a name="ENHANCEDBROWSING"></a><div class="variablelist"><dl><dt></dt><dd><p>This option enables a couple of enhancements to
     1827</h3></div></div></div><a class="indexterm" name="id2540993"></a><a name="ENHANCEDBROWSING"></a><div class="variablelist"><dl><dt></dt><dd><p>This option enables a couple of enhancements to
    18281828        cross-subnet browse propagation that have been added in Samba
    18291829        but which are not standard in Microsoft implementations. 
    … …  
    18381838        cross-subnet browse propagation much more reliable.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>enhanced browsing</code></em> = <code class="literal">yes</code>
    18391839</em></span>
    1840 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541055"></a>
     1840</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541054"></a>
    18411841
    18421842enumports command (G)
    1843 </h3></div></div></div><a class="indexterm" name="id2541056"></a><a name="ENUMPORTSCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The concept of a "port" is fairly foreign
     1843</h3></div></div></div><a class="indexterm" name="id2541055"></a><a name="ENUMPORTSCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The concept of a "port" is fairly foreign
    18441844    to UNIX hosts.  Under Windows NT/2000 print servers, a port
    18451845    is associated with a port monitor and generally takes the form of
    … …  
    18581858</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>enumports command</code></em> = <code class="literal">/usr/bin/listports</code>
    18591859</em></span>
    1860 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541135"></a>
     1860</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541134"></a>
    18611861
    18621862eventlog list (G)
    … …  
    18771877
    18781878fake directory create times (S)
    1879 </h3></div></div></div><a class="indexterm" name="id2541210"></a><a name="FAKEDIRECTORYCREATETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>NTFS and Windows VFAT file systems keep a create
     1879</h3></div></div></div><a class="indexterm" name="id2541209"></a><a name="FAKEDIRECTORYCREATETIMES"></a><div class="variablelist"><dl><dt></dt><dd><p>NTFS and Windows VFAT file systems keep a create
    18801880        time for all files and directories. This is not the same as the
    18811881        ctime - status change time - that Unix keeps, so Samba by default
    … …  
    18991899        will proceed as expected.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>fake directory create times</code></em> = <code class="literal">no</code>
    19001900</em></span>
    1901 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541284"></a>
     1901</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541283"></a>
    19021902
    19031903fake oplocks (S)
    1904 </h3></div></div></div><a class="indexterm" name="id2541285"></a><a name="FAKEOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>Oplocks are the way that SMB clients get permission
     1904</h3></div></div></div><a class="indexterm" name="id2541284"></a><a name="FAKEOPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>Oplocks are the way that SMB clients get permission
    19051905        from a server to locally cache file operations. If a server grants
    19061906        an oplock (opportunistic lock) then the client is free to assume
    … …  
    19181918        this option carefully!</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>fake oplocks</code></em> = <code class="literal">no</code>
    19191919</em></span>
    1920 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541368"></a>
     1920</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541367"></a>
    19211921
    19221922follow symlinks (S)
    1923 </h3></div></div></div><a class="indexterm" name="id2541369"></a><a name="FOLLOWSYMLINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1923</h3></div></div></div><a class="indexterm" name="id2541368"></a><a name="FOLLOWSYMLINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    19241924        This parameter allows the Samba administrator to stop <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>       from following symbolic links in a particular share. Setting this
    19251925        parameter to <code class="constant">no</code> prevents any file or directory that is a symbolic link from being
    … …  
    19311931        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>follow symlinks</code></em> = <code class="literal">yes</code>
    19321932</em></span>
    1933 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541438"></a>
     1933</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541437"></a>
    19341934
    19351935force create mode (S)
    1936 </h3></div></div></div><a class="indexterm" name="id2541439"></a><a name="FORCECREATEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
     1936</h3></div></div></div><a class="indexterm" name="id2541438"></a><a name="FORCECREATEMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
    19371937    permissions that will <span class="emphasis"><em>always</em></span> be set on a
    19381938    file created by Samba. This is done by bitwise 'OR'ing these bits onto
    … …  
    19461946</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force create mode</code></em> = <code class="literal">0755</code>
    19471947</em></span>
    1948 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541512"></a>
     1948</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541511"></a>
    19491949
    19501950force directory mode (S)
    1951 </h3></div></div></div><a class="indexterm" name="id2541513"></a><a name="FORCEDIRECTORYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
     1951</h3></div></div></div><a class="indexterm" name="id2541512"></a><a name="FORCEDIRECTORYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a set of UNIX mode bit
    19521952    permissions that will <span class="emphasis"><em>always</em></span> be set on a directory
    19531953    created by Samba. This is done by bitwise 'OR'ing these bits onto the
    … …  
    19621962</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force directory mode</code></em> = <code class="literal">0755</code>
    19631963</em></span>
    1964 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541586"></a>
     1964</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541585"></a>
    19651965
    19661966force directory security mode (S)
    1967 </h3></div></div></div><a class="indexterm" name="id2541587"></a><a name="FORCEDIRECTORYSECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     1967</h3></div></div></div><a class="indexterm" name="id2541586"></a><a name="FORCEDIRECTORYSECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    19681968        This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating
    19691969        the UNIX permission on a directory using the native NT security dialog box.
    … …  
    19861986</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force directory security mode</code></em> = <code class="literal">700</code>
    19871987</em></span>
    1988 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541683"></a>
     1988</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541682"></a>
    19891989
    19901990<a name="GROUP"></a>group
    1991 </h3></div></div></div><a class="indexterm" name="id2541684"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#FORCEGROUP">force group</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541710"></a>
     1991</h3></div></div></div><a class="indexterm" name="id2541683"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#FORCEGROUP">force group</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541709"></a>
    19921992
    19931993force group (S)
    1994 </h3></div></div></div><a class="indexterm" name="id2541711"></a><a name="FORCEGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX group name that will be
     1994</h3></div></div></div><a class="indexterm" name="id2541710"></a><a name="FORCEGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX group name that will be
    19951995    assigned as the default primary group for all users connecting
    19961996    to this service. This is useful for sharing files by ensuring
    … …  
    20162016</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force group</code></em> = <code class="literal">agroup</code>
    20172017</em></span>
    2018 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541815"></a>
     2018</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541814"></a>
    20192019
    20202020force printername (S)
    2021 </h3></div></div></div><a class="indexterm" name="id2541816"></a><a name="FORCEPRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>When printing from Windows NT (or later),
     2021</h3></div></div></div><a class="indexterm" name="id2541815"></a><a name="FORCEPRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>When printing from Windows NT (or later),
    20222022    each printer in <code class="filename">smb.conf</code> has two
    20232023    associated names which can be used by the client.  The first
    … …  
    20422042    folder.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force printername</code></em> = <code class="literal">no</code>
    20432043</em></span>
    2044 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541900"></a>
     2044</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2541899"></a>
    20452045
    20462046force security mode (S)
    2047 </h3></div></div></div><a class="indexterm" name="id2541901"></a><a name="FORCESECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2047</h3></div></div></div><a class="indexterm" name="id2541900"></a><a name="FORCESECURITYMODE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    20482048        This parameter controls what UNIX permission bits can be modified when a Windows NT client is manipulating
    20492049    the UNIX permission on a file using the native NT security dialog box.
    … …  
    20822082    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>force unknown acl user</code></em> = <code class="literal">no</code>
    20832083</em></span>
    2084 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542063"></a>
     2084</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542062"></a>
    20852085
    20862086force user (S)
    2087 </h3></div></div></div><a class="indexterm" name="id2542064"></a><a name="FORCEUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX user name that will be
     2087</h3></div></div></div><a class="indexterm" name="id2542063"></a><a name="FORCEUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies a UNIX user name that will be
    20882088    assigned as the default user for all users connecting to this service.
    20892089    This is useful for sharing files. You should also use it carefully
    … …  
    20992099</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>force user</code></em> = <code class="literal">auser</code>
    21002100</em></span>
    2101 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542139"></a>
     2101</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542138"></a>
    21022102
    21032103fstype (S)
    2104 </h3></div></div></div><a class="indexterm" name="id2542140"></a><a name="FSTYPE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2104</h3></div></div></div><a class="indexterm" name="id2542139"></a><a name="FSTYPE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    21052105        This parameter allows the administrator to configure the string that specifies the type of filesystem a share
    21062106        is using that is reported by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    … …  
    21122112</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>fstype</code></em> = <code class="literal">Samba</code>
    21132113</em></span>
    2114 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542221"></a>
     2114</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542220"></a>
    21152115
    21162116get quota command (G)
    … …  
    21282128</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>get quota command</code></em> = <code class="literal">/usr/local/sbin/query_quota</code>
    21292129</em></span>
    2130 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542408"></a>
     2130</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542407"></a>
    21312131
    21322132getwd cache (G)
    2133 </h3></div></div></div><a class="indexterm" name="id2542409"></a><a name="GETWDCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a tuning option. When this is enabled a
     2133</h3></div></div></div><a class="indexterm" name="id2542408"></a><a name="GETWDCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a tuning option. When this is enabled a
    21342134    caching algorithm will be used to reduce the time taken for getwd()
    21352135    calls. This can have a significant impact on performance, especially
    … …  
    21572157</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>guest account</code></em> = <code class="literal">ftp</code>
    21582158</em></span>
    2159 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542576"></a>
     2159</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542575"></a>
    21602160
    21612161<a name="PUBLIC"></a>public
    2162 </h3></div></div></div><a class="indexterm" name="id2542577"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#GUESTOK">guest ok</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542607"></a>
     2162</h3></div></div></div><a class="indexterm" name="id2542576"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#GUESTOK">guest ok</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2542606"></a>
    21632163
    21642164guest ok (S)
    2165 </h3></div></div></div><a class="indexterm" name="id2542608"></a><a name="GUESTOK"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
     2165</h3></div></div></div><a class="indexterm" name="id2542607"></a><a name="GUESTOK"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code> for
    21662166    a service, then no password is required to connect to the service.
    21672167    Privileges will be those of the <a class="link" href="smb.conf.5.html#GUESTACCOUNT" target="_top">guest account</a>.</p><p>This paramater nullifies the benifits of setting
    … …  
    22232223
    22242224hide unreadable (S)
    2225 </h3></div></div></div><a class="indexterm" name="id2542976"></a><a name="HIDEUNREADABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter prevents clients from seeing the
     2225</h3></div></div></div><a class="indexterm" name="id2542975"></a><a name="HIDEUNREADABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter prevents clients from seeing the
    22262226                existance of files that cannot be read. Defaults to off.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide unreadable</code></em> = <code class="literal">no</code>
    22272227</em></span>
    2228 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543017"></a>
     2228</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543016"></a>
    22292229
    22302230hide unwriteable files (S)
    2231 </h3></div></div></div><a class="indexterm" name="id2543018"></a><a name="HIDEUNWRITEABLEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2231</h3></div></div></div><a class="indexterm" name="id2543017"></a><a name="HIDEUNWRITEABLEFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22322232    This parameter prevents clients from seeing the existance of files that cannot be written to.
    22332233    Defaults to off. Note that unwriteable directories are shown as usual.
    22342234    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>hide unwriteable files</code></em> = <code class="literal">no</code>
    22352235</em></span>
    2236 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543062"></a>
     2236</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543061"></a>
    22372237
    22382238homedir map (G)
    2239 </h3></div></div></div><a class="indexterm" name="id2543063"></a><a name="HOMEDIRMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2239</h3></div></div></div><a class="indexterm" name="id2543062"></a><a name="HOMEDIRMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    22402240        If <a class="link" href="smb.conf.5.html#NISHOMEDIR" target="_top">nis homedir</a> is <code class="constant">yes</code>, and <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> is also acting         as a Win95/98 <em class="parameter"><code>logon server</code></em>
    22412241        then this parameter specifies the NIS (or YP) map from which the server for the user's  home directory should be extracted. 
    … …  
    23032303
    23042304<a name="DENYHOSTS"></a>deny hosts
    2305 </h3></div></div></div><a class="indexterm" name="id2543548"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#HOSTSDENY">hosts deny</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543578"></a>
     2305</h3></div></div></div><a class="indexterm" name="id2543547"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#HOSTSDENY">hosts deny</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543577"></a>
    23062306
    23072307hosts deny (S)
    2308 </h3></div></div></div><a class="indexterm" name="id2543579"></a><a name="HOSTSDENY"></a><div class="variablelist"><dl><dt></dt><dd><p>The opposite of <em class="parameter"><code>hosts allow</code></em>
     2308</h3></div></div></div><a class="indexterm" name="id2543578"></a><a name="HOSTSDENY"></a><div class="variablelist"><dl><dt></dt><dd><p>The opposite of <em class="parameter"><code>hosts allow</code></em>
    23092309    - hosts listed here are <span class="emphasis"><em>NOT</em></span> permitted access to
    23102310    services unless the specific services have their own lists to override
    … …  
    23202320</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>hosts deny</code></em> = <code class="literal">150.203.4. badhost.mynet.edu.au</code>
    23212321</em></span>
    2322 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543680"></a>
     2322</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543679"></a>
    23232323
    23242324idmap alloc backend (G)
    2325 </h3></div></div></div><a class="indexterm" name="id2543681"></a><a name="IDMAPALLOCBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2325</h3></div></div></div><a class="indexterm" name="id2543680"></a><a name="IDMAPALLOCBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23262326        The idmap alloc backend provides a plugin interface for Winbind to use
    23272327        when allocating Unix uids/gids for Windows SIDs.  This option is
    … …  
    23432343        parameter.  Refer to the man page for each idmap plugin regarding
    23442344        specific configuration details.
    2345         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543823"></a>
     2345        </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543822"></a>
    23462346
    23472347idmap backend (G)
    2348 </h3></div></div></div><a class="indexterm" name="id2543824"></a><a name="IDMAPBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2348</h3></div></div></div><a class="indexterm" name="id2543823"></a><a name="IDMAPBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23492349        The idmap backend provides a plugin interface for Winbind to use
    23502350        varying backends to store SID/uid/gid mapping tables.  This
    … …  
    23592359        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap backend</code></em> = <code class="literal">tdb</code>
    23602360</em></span>
    2361 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543918"></a>
     2361</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543917"></a>
    23622362
    23632363idmap cache time (G)
    2364 </h3></div></div></div><a class="indexterm" name="id2543919"></a><a name="IDMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
     2364</h3></div></div></div><a class="indexterm" name="id2543918"></a><a name="IDMAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
    23652365        idmap interface will cache positive SID/uid/gid query results.
    23662366        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap cache time</code></em> = <code class="literal">900</code>
    23672367</em></span>
    2368 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543962"></a>
     2368</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2543961"></a>
    23692369
    23702370idmap config (G)
    2371 </h3></div></div></div><a class="indexterm" name="id2543963"></a><a name="IDMAPCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2371</h3></div></div></div><a class="indexterm" name="id2543962"></a><a name="IDMAPCONFIG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    23722372        The idmap config prefix provides a means of managing each domain
    23732373        defined by the <a class="link" href="smb.conf.5.html#IDMAPDOMAINS" target="_top">idmap domains</a> option using Samba's
    … …  
    24022402        idmap config TRUSTEDDOMAINS:default = yes
    24032403        idmap config TRUSTEDDOMAINS:range   = 1000 - 9999
    2404         </pre><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544099"></a>
     2404        </pre><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544098"></a>
    24052405
    24062406idmap domains (G)
    2407 </h3></div></div></div><a class="indexterm" name="id2544100"></a><a name="IDMAPDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2407</h3></div></div></div><a class="indexterm" name="id2544099"></a><a name="IDMAPDOMAINS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    24082408        The idmap domains option defines a list of Windows domains which will each
    24092409        have a separately configured backend for managing Winbind's SID/uid/gid
    … …  
    24182418        </p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap domains</code></em> = <code class="literal">default AD CORP</code>
    24192419</em></span>
    2420 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544183"></a>
     2420</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544182"></a>
    24212421
    24222422<a name="WINBINDGID"></a>winbind gid
    2423 </h3></div></div></div><a class="indexterm" name="id2544184"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#IDMAPGID">idmap gid</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544215"></a>
     2423</h3></div></div></div><a class="indexterm" name="id2544183"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#IDMAPGID">idmap gid</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544215"></a>
    24242424
    24252425idmap gid (G)
    … …  
    24332433</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>idmap gid</code></em> = <code class="literal">10000-20000</code>
    24342434</em></span>
    2435 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544314"></a>
     2435</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544313"></a>
    24362436
    24372437idmap negative cache time (G)
    2438 </h3></div></div></div><a class="indexterm" name="id2544315"></a><a name="IDMAPNEGATIVECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
     2438</h3></div></div></div><a class="indexterm" name="id2544314"></a><a name="IDMAPNEGATIVECACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of seconds that Winbind's
    24392439        idmap interface will cache negative SID/uid/gid query results.
    24402440        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>idmap negative cache time</code></em> = <code class="literal">120</code>
    … …  
    25022502
    25032503inherit permissions (S)
    2504 </h3></div></div></div><a class="indexterm" name="id2544690"></a><a name="INHERITPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2504</h3></div></div></div><a class="indexterm" name="id2544689"></a><a name="INHERITPERMISSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25052505        The permissions on new files and directories are normally governed by <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a>,
    25062506        <a class="link" href="smb.conf.5.html#DIRECTORYMASK" target="_top">directory mask</a>, <a class="link" href="smb.conf.5.html#FORCECREATEMODE" target="_top">force create mode</a> and <a class="link" href="smb.conf.5.html#FORCEDIRECTORYMODE" target="_top">force directory mode</a> but the boolean inherit permissions parameter overrides this.
    … …  
    25142514    share to be used flexibly by each user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>inherit permissions</code></em> = <code class="literal">no</code>
    25152515</em></span>
    2516 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544838"></a>
     2516</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544837"></a>
    25172517
    25182518interfaces (G)
    2519 </h3></div></div></div><a class="indexterm" name="id2544839"></a><a name="INTERFACES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to override the default
     2519</h3></div></div></div><a class="indexterm" name="id2544838"></a><a name="INTERFACES"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to override the default
    25202520        network interfaces list that Samba will use for browsing, name
    25212521        registration and other NetBIOS over TCP/IP (NBT) traffic. By default Samba will query
    … …  
    25412541</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>interfaces</code></em> = <code class="literal">eth0 192.168.2.10/24 192.168.3.10/255.255.255.0</code>
    25422542</em></span>
    2543 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544955"></a>
     2543</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2544954"></a>
    25442544
    25452545invalid users (S)
    2546 </h3></div></div></div><a class="indexterm" name="id2544956"></a><a name="INVALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users that should not be allowed
     2546</h3></div></div></div><a class="indexterm" name="id2544955"></a><a name="INVALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of users that should not be allowed
    25472547    to login to this service. This is really a <span class="emphasis"><em>paranoid</em></span>
    25482548    check to absolutely ensure an improper setting does not breach
    … …  
    25672567
    25682568iprint server (G)
    2569 </h3></div></div></div><a class="indexterm" name="id2545070"></a><a name="IPRINTSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2569</h3></div></div></div><a class="indexterm" name="id2545069"></a><a name="IPRINTSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    25702570    This parameter is only applicable if <a class="link" href="smb.conf.5.html#PRINTING" target="_top">printing</a> is set to <code class="constant">iprint</code>.
    25712571    </p><p>
    … …  
    25762576</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>iprint server</code></em> = <code class="literal">MYCUPSSERVER</code>
    25772577</em></span>
    2578 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545155"></a>
     2578</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545154"></a>
    25792579
    25802580keepalive (G)
    2581 </h3></div></div></div><a class="indexterm" name="id2545156"></a><a name="KEEPALIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (an integer) represents
     2581</h3></div></div></div><a class="indexterm" name="id2545155"></a><a name="KEEPALIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (an integer) represents
    25822582    the number of seconds between <em class="parameter"><code>keepalive</code></em>
    25832583    packets. If this parameter is zero, no keepalive packets will be
    … …  
    26122612        You should never need to touch this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>kernel oplocks</code></em> = <code class="literal">yes</code>
    26132613</em></span>
    2614 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545381"></a>
     2614</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545380"></a>
    26152615
    26162616lanman auth (G)
    2617 </h3></div></div></div><a class="indexterm" name="id2545382"></a><a name="LANMANAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to
     2617</h3></div></div></div><a class="indexterm" name="id2545381"></a><a name="LANMANAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to
    26182618    authenticate users or permit password changes
    26192619    using the LANMAN password hash. If disabled, only clients which support NT
    … …  
    26442644        tested as some other Samba code paths.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>large readwrite</code></em> = <code class="literal">yes</code>
    26452645</em></span>
    2646 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545530"></a>
     2646</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545529"></a>
    26472647
    26482648ldap admin dn (G)
    2649 </h3></div></div></div><a class="indexterm" name="id2545531"></a><a name="LDAPADMINDN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2649</h3></div></div></div><a class="indexterm" name="id2545530"></a><a name="LDAPADMINDN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    26502650        The <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a> defines the Distinguished  Name (DN) name used by Samba to contact
    26512651        the ldap server when retreiving  user account information. The <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a> is used
    … …  
    26552655        </p><p>
    26562656        The <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a> requires a fully specified DN. The <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap  suffix</a> is not appended to the <a class="link" href="smb.conf.5.html#LDAPADMINDN" target="_top">ldap admin dn</a>.
    2657         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545639"></a>
     2657        </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545638"></a>
    26582658
    26592659ldap connection timeout (G)
    … …  
    27022702</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap debug threshold</code></em> = <code class="literal">5</code>
    27032703</em></span>
    2704 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545860"></a>
     2704</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545859"></a>
    27052705
    27062706ldap delete dn (G)
    2707 </h3></div></div></div><a class="indexterm" name="id2545861"></a><a name="LDAPDELETEDN"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter specifies whether a delete
     2707</h3></div></div></div><a class="indexterm" name="id2545860"></a><a name="LDAPDELETEDN"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter specifies whether a delete
    27082708        operation in the ldapsam deletes the complete entry or only the attributes
    27092709        specific to Samba.
    27102710        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap delete dn</code></em> = <code class="literal">no</code>
    27112711</em></span>
    2712 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545904"></a>
     2712</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2545903"></a>
    27132713
    27142714ldap group suffix (G)
    2715 </h3></div></div></div><a class="indexterm" name="id2545905"></a><a name="LDAPGROUPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the suffix that is
     2715</h3></div></div></div><a class="indexterm" name="id2545904"></a><a name="LDAPGROUPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the suffix that is
    27162716        used for groups when these are added to the LDAP directory.
    27172717        If this parameter is unset, the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix string is pre-pended to the
    … …  
    27312731</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>ldap idmap suffix</code></em> = <code class="literal">ou=Idmap</code>
    27322732</em></span>
    2733 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546070"></a>
     2733</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546069"></a>
    27342734
    27352735ldap machine suffix (G)
    2736 </h3></div></div></div><a class="indexterm" name="id2546071"></a><a name="LDAPMACHINESUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2736</h3></div></div></div><a class="indexterm" name="id2546070"></a><a name="LDAPMACHINESUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27372737        It specifies where machines should be added to the ldap tree.  If this parameter is unset, the value of
    27382738        <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix string is pre-pended to the
    … …  
    27722772        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap replication sleep</code></em> = <code class="literal">1000</code>
    27732773</em></span>
    2774 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546317"></a>
     2774</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546316"></a>
    27752775
    27762776ldapsam:editposix (G)
    2777 </h3></div></div></div><a class="indexterm" name="id2546318"></a><a name="LDAPSAM:EDITPOSIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2777</h3></div></div></div><a class="indexterm" name="id2546317"></a><a name="LDAPSAM:EDITPOSIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    27782778        Editposix is an option that leverages ldapsam:trusted to make it simpler to manage a domain controller
    27792779        eliminating the need to set up custom scripts to add and manage the posix users and groups. This option
    … …  
    28532853        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldapsam:editposix</code></em> = <code class="literal">no</code>
    28542854</em></span>
    2855 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546454"></a>
     2855</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546453"></a>
    28562856
    28572857ldapsam:trusted (G)
    2858 </h3></div></div></div><a class="indexterm" name="id2546455"></a><a name="LDAPSAM:TRUSTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2858</h3></div></div></div><a class="indexterm" name="id2546454"></a><a name="LDAPSAM:TRUSTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    28592859        By default, Samba as a Domain Controller with an LDAP backend needs to use the Unix-style NSS subsystem to
    28602860        access user and group information. Due to the way Unix stores user information in /etc/passwd and /etc/group
    … …  
    28742874        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldapsam:trusted</code></em> = <code class="literal">no</code>
    28752875</em></span>
    2876 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546543"></a>
     2876</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546542"></a>
    28772877
    28782878ldap ssl (G)
    2879 </h3></div></div></div><a class="indexterm" name="id2546544"></a><a name="LDAPSSL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
     2879</h3></div></div></div><a class="indexterm" name="id2546543"></a><a name="LDAPSSL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used to define whether or not Samba should
    28802880        use SSL when connecting to the ldap server
    28812881        This is <span class="emphasis"><em>NOT</em></span> related to
    … …  
    28932893                        communicating with the directory server.</p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap ssl</code></em> = <code class="literal">no</code>
    28942894</em></span>
    2895 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546675"></a>
     2895</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546674"></a>
    28962896
    28972897ldap suffix (G)
    2898 </h3></div></div></div><a class="indexterm" name="id2546676"></a><a name="LDAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the base for all ldap suffixes and for storing the sambaDomain object.</p><p>
     2898</h3></div></div></div><a class="indexterm" name="id2546675"></a><a name="LDAPSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the base for all ldap suffixes and for storing the sambaDomain object.</p><p>
    28992899        The ldap suffix will be appended to the values specified for the <a class="link" href="smb.conf.5.html#LDAPUSERSUFFIX" target="_top">ldap user suffix</a>,
    29002900         <a class="link" href="smb.conf.5.html#LDAPGROUPSUFFIX" target="_top">ldap group suffix</a>, <a class="link" href="smb.conf.5.html#LDAPMACHINESUFFIX" target="_top">ldap machine suffix</a>, and the
    … …  
    29122912        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ldap timeout</code></em> = <code class="literal">15</code>
    29132913</em></span>
    2914 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546840"></a>
     2914</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2546839"></a>
    29152915
    29162916ldap user suffix (G)
    2917 </h3></div></div></div><a class="indexterm" name="id2546841"></a><a name="LDAPUSERSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
     2917</h3></div></div></div><a class="indexterm" name="id2546840"></a><a name="LDAPUSERSUFFIX"></a><div class="variablelist"><dl><dt></dt><dd><p>
    29182918        This parameter specifies where users are added to the tree. If this parameter is unset,
    29192919        the value of <a class="link" href="smb.conf.5.html#LDAPSUFFIX" target="_top">ldap suffix</a> will be used instead.  The suffix
    … …  
    29782978</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lm interval</code></em> = <code class="literal">120</code>
    29792979</em></span>
    2980 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547235"></a>
     2980</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547234"></a>
    29812981
    29822982load printers (G)
    2983 </h3></div></div></div><a class="indexterm" name="id2547236"></a><a name="LOADPRINTERS"></a><div class="variablelist"><dl><dt></dt><dd><p>A boolean variable that controls whether all
     2983</h3></div></div></div><a class="indexterm" name="id2547235"></a><a name="LOADPRINTERS"></a><div class="variablelist"><dl><dt></dt><dd><p>A boolean variable that controls whether all
    29842984    printers in the printcap will be loaded for browsing by default.
    29852985    See the <a class="link" href="smb.conf.5.html#PRINTERS" target="_top">printers</a> section for
    29862986    more details.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>load printers</code></em> = <code class="literal">yes</code>
    29872987</em></span>
    2988 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547291"></a>
     2988</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547290"></a>
    29892989
    29902990local master (G)
    2991 </h3></div></div></div><a class="indexterm" name="id2547292"></a><a name="LOCALMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> to try and become a local master browser
     2991</h3></div></div></div><a class="indexterm" name="id2547291"></a><a name="LOCALMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> to try and become a local master browser
    29922992        on a subnet. If set to <code class="constant">no</code> then <code class="literal">
    29932993        nmbd</code> will not attempt to become a local master browser
    … …  
    29992999master browser.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>local master</code></em> = <code class="literal">yes</code>
    30003000</em></span>
    3001 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547391"></a>
     3001</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547390"></a>
    30023002
    30033003<a name="LOCKDIR"></a>lock dir
    3004 </h3></div></div></div><a class="indexterm" name="id2547392"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#LOCKDIRECTORY">lock directory</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547423"></a>
     3004</h3></div></div></div><a class="indexterm" name="id2547391"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#LOCKDIRECTORY">lock directory</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547422"></a>
    30053005
    30063006lock directory (G)
    3007 </h3></div></div></div><a class="indexterm" name="id2547424"></a><a name="LOCKDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the directory where lock
     3007</h3></div></div></div><a class="indexterm" name="id2547423"></a><a name="LOCKDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the directory where lock
    30083008        files will be placed.  The lock files are used to implement the
    30093009        <a class="link" href="smb.conf.5.html#MAXCONNECTIONS" target="_top">max connections</a> option.
    … …  
    30283028        is not really recommended even in this case.</p><p>Be careful about disabling locking either globally or in a
    30293029        specific service, as lack of locking may result in data corruption.
    3030         You should never need to set this parameter.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547577"></a>
     3030        You should never need to set this parameter.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547576"></a>
    30313031
    30323032lock spin count (G)
    3033 </h3></div></div></div><a class="indexterm" name="id2547578"></a><a name="LOCKSPINCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter has been made inoperative in Samba 3.0.24.
     3033</h3></div></div></div><a class="indexterm" name="id2547577"></a><a name="LOCKSPINCOUNT"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter has been made inoperative in Samba 3.0.24.
    30343034        The functionality it contolled is now controlled by the parameter
    30353035        <a class="link" href="smb.conf.5.html#LOCKSPINTIME" target="_top">lock spin time</a>.
    … …  
    30393039
    30403040lock spin time (G)
    3041 </h3></div></div></div><a class="indexterm" name="id2547634"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in microseconds that smbd should
     3041</h3></div></div></div><a class="indexterm" name="id2547633"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in microseconds that smbd should
    30423042        keep waiting to see if a failed lock request can
    30433043        be granted. This parameter has changed in default
    … …  
    30473047        to change the value of this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>lock spin time</code></em> = <code class="literal">200</code>
    30483048</em></span>
    3049 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547691"></a>
     3049</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2547690"></a>
    30503050
    30513051log file (G)
    3052 </h3></div></div></div><a class="indexterm" name="id2547692"></a><a name="LOGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3052</h3></div></div></div><a class="indexterm" name="id2547691"></a><a name="LOGFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30533053    This option allows you to override the name of the Samba log file (also known as the debug file).
    30543054    </p><p>
    … …  
    30733073</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>log level</code></em> = <code class="literal">3 passdb:5 auth:10 winbind:2</code>
    30743074</em></span>
    3075 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548008"></a>
     3075</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548007"></a>
    30763076
    30773077logon drive (G)
    3078 </h3></div></div></div><a class="indexterm" name="id2548009"></a><a name="LOGONDRIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3078</h3></div></div></div><a class="indexterm" name="id2548008"></a><a name="LOGONDRIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    30793079        This parameter specifies the local path to which the home directory will be
    30803080        connected (see <a class="link" href="smb.conf.5.html#LOGONHOME" target="_top">logon home</a>) and is only used by NT
    … …  
    31203120</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>logon home</code></em> = <code class="literal">\\remote_smb_server\%U</code>
    31213121</em></span>
    3122 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548247"></a>
     3122</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548246"></a>
    31233123
    31243124logon path (G)
    … …  
    31673167        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>logon path</code></em> = <code class="literal">\\%N\%U\profile</code>
    31683168</em></span>
    3169 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548416"></a>
     3169</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548415"></a>
    31703170
    31713171logon script (G)
    3172 </h3></div></div></div><a class="indexterm" name="id2548417"></a><a name="LOGONSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3172</h3></div></div></div><a class="indexterm" name="id2548416"></a><a name="LOGONSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    31733173        This parameter specifies the batch file (<code class="filename">.bat</code>) or NT command file
    31743174        (<code class="filename">.cmd</code>) to be downloaded and run on a machine when a user successfully logs in.  The file
    … …  
    32443244</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>lpq cache time</code></em> = <code class="literal">10</code>
    32453245</em></span>
    3246 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548852"></a>
     3246</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2548851"></a>
    32473247
    32483248lpq command (S)
    3249 </h3></div></div></div><a class="indexterm" name="id2548853"></a><a name="LPQCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     3249</h3></div></div></div><a class="indexterm" name="id2548852"></a><a name="LPQCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    32503250    executed on the server host in order to obtain <code class="literal">lpq
    32513251    </code>-style printer status information.</p><p>This command should be a program or script which
    … …  
    33083308
    33093309machine password timeout (G)
    3310 </h3></div></div></div><a class="indexterm" name="id2549220"></a><a name="MACHINEPASSWORDTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3310</h3></div></div></div><a class="indexterm" name="id2549219"></a><a name="MACHINEPASSWORDTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    33113311        If a Samba server is a member of a Windows NT Domain (see the <a class="link" href="smb.conf.5.html#SECURITY" target="_top">security = domain</a> parameter) then periodically a running smbd process will try and change
    33123312        the MACHINE ACCOUNT PASSWORD stored in the TDB called <code class="filename">private/secrets.tdb
    … …  
    33493349</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>magic script</code></em> = <code class="literal">user.csh</code>
    33503350</em></span>
    3351 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549496"></a>
     3351</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549495"></a>
    33523352
    33533353mangled names (S)
    3354 </h3></div></div></div><a class="indexterm" name="id2549497"></a><a name="MANGLEDNAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether non-DOS names under UNIX
     3354</h3></div></div></div><a class="indexterm" name="id2549496"></a><a name="MANGLEDNAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether non-DOS names under UNIX
    33553355        should be mapped to DOS-compatible names ("mangled") and made visible,
    33563356        or whether non-DOS names should simply be ignored.</p><p>See the section on <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a> for
    … …  
    33773377        do not change between sessions.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>mangled names</code></em> = <code class="literal">yes</code>
    33783378</em></span>
    3379 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549633"></a>
     3379</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549632"></a>
    33803380
    33813381mangle prefix (G)
    3382 </h3></div></div></div><a class="indexterm" name="id2549634"></a><a name="MANGLEPREFIX"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the number of prefix
     3382</h3></div></div></div><a class="indexterm" name="id2549633"></a><a name="MANGLEPREFIX"></a><div class="variablelist"><dl><dt></dt><dd><p> controls the number of prefix
    33833383        characters from the original name used when generating
    33843384        the mangled names. A larger value will give a weaker
    … …  
    33903390</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>mangle prefix</code></em> = <code class="literal">4</code>
    33913391</em></span>
    3392 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549700"></a>
     3392</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549699"></a>
    33933393
    33943394mangling char (S)
    3395 </h3></div></div></div><a class="indexterm" name="id2549701"></a><a name="MANGLINGCHAR"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what character is used as
     3395</h3></div></div></div><a class="indexterm" name="id2549700"></a><a name="MANGLINGCHAR"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what character is used as
    33963396        the <span class="emphasis"><em>magic</em></span> character in <a class="link" href="smb.conf.5.html#NAMEMANGLING" target="_top">name mangling</a>. The
    33973397        default is a '~' but this may interfere with some software. Use this option to set
    … …  
    34253425    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map acl inherit</code></em> = <code class="literal">no</code>
    34263426</em></span>
    3427 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549908"></a>
     3427</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549901"></a>
    34283428
    34293429map archive (S)
    3430 </h3></div></div></div><a class="indexterm" name="id2549909"></a><a name="MAPARCHIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3430</h3></div></div></div><a class="indexterm" name="id2549902"></a><a name="MAPARCHIVE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34313431        This controls whether the DOS archive attribute
    34323432        should be mapped to the UNIX owner execute bit.  The DOS archive bit
    … …  
    34413441        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map archive</code></em> = <code class="literal">yes</code>
    34423442</em></span>
    3443 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549984"></a>
     3443</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2549976"></a>
    34443444
    34453445map hidden (S)
    3446 </h3></div></div></div><a class="indexterm" name="id2549985"></a><a name="MAPHIDDEN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3446</h3></div></div></div><a class="indexterm" name="id2549977"></a><a name="MAPHIDDEN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34473447        This controls whether DOS style hidden files should be mapped to the UNIX world execute bit.
    34483448        </p><p>
    … …  
    34503450        bit is not masked out (i.e. it must include 001). See the parameter <a class="link" href="smb.conf.5.html#CREATEMASK" target="_top">create mask</a>
    34513451        for details.
    3452         </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550041"></a>
     3452        </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550034"></a>
    34533453
    34543454map read only (S)
    3455 </h3></div></div></div><a class="indexterm" name="id2550042"></a><a name="MAPREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3455</h3></div></div></div><a class="indexterm" name="id2550035"></a><a name="MAPREADONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34563456        This controls how the DOS read only attribute should be mapped from a UNIX filesystem.
    34573457        </p><p>
    … …  
    34783478                </p></li></ul></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>map read only</code></em> = <code class="literal">yes</code>
    34793479</em></span>
    3480 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550198"></a>
     3480</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550190"></a>
    34813481
    34823482map system (S)
    3483 </h3></div></div></div><a class="indexterm" name="id2550199"></a><a name="MAPSYSTEM"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3483</h3></div></div></div><a class="indexterm" name="id2550191"></a><a name="MAPSYSTEM"></a><div class="variablelist"><dl><dt></dt><dd><p>
    34843484        This controls whether DOS style system files should be mapped to the UNIX group execute bit.
    34853485        </p><p>
    … …  
    34893489        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>map system</code></em> = <code class="literal">no</code>
    34903490</em></span>
    3491 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550267"></a>
     3491</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550260"></a>
    34923492
    34933493map to guest (G)
    3494 </h3></div></div></div><a class="indexterm" name="id2550268"></a><a name="MAPTOGUEST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only useful in <a class="link" href="smb.conf.5.html#SECURITY" target="_top">SECURITY =
     3494</h3></div></div></div><a class="indexterm" name="id2550261"></a><a name="MAPTOGUEST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only useful in <a class="link" href="smb.conf.5.html#SECURITY" target="_top">SECURITY =
    34953495    security</a> modes other than <em class="parameter"><code>security = share</code></em>
    34963496    and <em class="parameter"><code>security = server</code></em>
    … …  
    35343534</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>map to guest</code></em> = <code class="literal">Bad User</code>
    35353535</em></span>
    3536 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550507"></a>
     3536</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550500"></a>
    35373537
    35383538max connections (S)
    3539 </h3></div></div></div><a class="indexterm" name="id2550508"></a><a name="MAXCONNECTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the number of simultaneous connections to a service to be limited.
     3539</h3></div></div></div><a class="indexterm" name="id2550501"></a><a name="MAXCONNECTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the number of simultaneous connections to a service to be limited.
    35403540    If <em class="parameter"><code>max connections</code></em> is greater than 0 then connections
    35413541    will be refused if this number of connections to the service are already open. A value
    … …  
    35453545</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max connections</code></em> = <code class="literal">10</code>
    35463546</em></span>
    3547 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550593"></a>
     3547</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550586"></a>
    35483548
    35493549max disk size (G)
    3550 </h3></div></div></div><a class="indexterm" name="id2550594"></a><a name="MAXDISKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to put an upper limit
     3550</h3></div></div></div><a class="indexterm" name="id2550587"></a><a name="MAXDISKSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to put an upper limit
    35513551    on the apparent size of disks. If you set this option to 100
    35523552    then all shares will appear to be not larger than 100 MB in
    … …  
    35623562</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max disk size</code></em> = <code class="literal">1000</code>
    35633563</em></span>
    3564 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550685"></a>
     3564</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533628"></a>
    35653565
    35663566max log size (G)
    3567 </h3></div></div></div><a class="indexterm" name="id2550686"></a><a name="MAXLOGSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3567</h3></div></div></div><a class="indexterm" name="id2533629"></a><a name="MAXLOGSIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    35683568    This option (an integer in kilobytes) specifies the max size the log file should grow to.
    35693569    Samba periodically checks the size and if it is exceeded it will rename the file, adding
    … …  
    35743574</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max log size</code></em> = <code class="literal">1000</code>
    35753575</em></span>
    3576 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550756"></a>
     3576</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533699"></a>
    35773577
    35783578max mux (G)
    3579 </h3></div></div></div><a class="indexterm" name="id2550757"></a><a name="MAXMUX"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of
     3579</h3></div></div></div><a class="indexterm" name="id2533700"></a><a name="MAXMUX"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum number of
    35803580    outstanding simultaneous SMB operations that Samba tells the client
    35813581        it will allow. You should never need to set this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>max mux</code></em> = <code class="literal">50</code>
    35823582</em></span>
    3583 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550799"></a>
     3583</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533742"></a>
    35843584
    35853585max open files (G)
    3586 </h3></div></div></div><a class="indexterm" name="id2550800"></a><a name="MAXOPENFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
     3586</h3></div></div></div><a class="indexterm" name="id2533743"></a><a name="MAXOPENFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
    35873587    open files that one <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> file
    35883588    serving process may have open for a client at any one time. The
    … …  
    35923592    this parameter so you should never need to touch this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>max open files</code></em> = <code class="literal">10000</code>
    35933593</em></span>
    3594 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550859"></a>
     3594</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2533802"></a>
    35953595
    35963596max print jobs (S)
    3597 </h3></div></div></div><a class="indexterm" name="id2550860"></a><a name="MAXPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
     3597</h3></div></div></div><a class="indexterm" name="id2533803"></a><a name="MAXPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of
    35983598    jobs allowable in a Samba printer queue at any given moment.
    35993599    If this number is exceeded, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will remote "Out of Space" to the client.
    … …  
    36023602</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max print jobs</code></em> = <code class="literal">5000</code>
    36033603</em></span>
    3604 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550929"></a>
     3604</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551194"></a>
    36053605
    36063606<a name="PROTOCOL"></a>protocol
    3607 </h3></div></div></div><a class="indexterm" name="id2550930"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#MAXPROTOCOL">max protocol</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2550962"></a>
     3607</h3></div></div></div><a class="indexterm" name="id2551196"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#MAXPROTOCOL">max protocol</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551227"></a>
    36083608
    36093609max protocol (G)
    3610 </h3></div></div></div><a class="indexterm" name="id2550963"></a><a name="MAXPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the highest
     3610</h3></div></div></div><a class="indexterm" name="id2551228"></a><a name="MAXPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the highest
    36113611    protocol level that will be supported by the server.</p><p>Possible values are :</p><div class="itemizedlist"><ul type="disc"><li><p><code class="constant">CORE</code>: Earliest version. No
    36123612            concept of user names.</p></li><li><p><code class="constant">COREPLUS</code>: Slight improvements on
    … …  
    36203620</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max protocol</code></em> = <code class="literal">LANMAN1</code>
    36213621</em></span>
    3622 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551087"></a>
     3622</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551352"></a>
    36233623
    36243624max reported print jobs (S)
    3625 </h3></div></div></div><a class="indexterm" name="id2551088"></a><a name="MAXREPORTEDPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3625</h3></div></div></div><a class="indexterm" name="id2551354"></a><a name="MAXREPORTEDPRINTJOBS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    36263626    This parameter limits the maximum number of jobs displayed in a port monitor for
    36273627    Samba printer queue at any given moment. If this number is exceeded, the excess
    … …  
    36323632</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max reported print jobs</code></em> = <code class="literal">1000</code>
    36333633</em></span>
    3634 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551151"></a>
     3634</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551416"></a>
    36353635
    36363636max smbd processes (G)
    3637 </h3></div></div></div><a class="indexterm" name="id2551152"></a><a name="MAXSMBDPROCESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> processes concurrently running on a system and is intended
     3637</h3></div></div></div><a class="indexterm" name="id2551418"></a><a name="MAXSMBDPROCESSES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the maximum number of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> processes concurrently running on a system and is intended
    36383638    as a stopgap to prevent degrading service to clients in the event that the server has insufficient
    36393639    resources to handle more than this number of connections.  Remember that under normal operating
    … …  
    36433643</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max smbd processes</code></em> = <code class="literal">1000</code>
    36443644</em></span>
    3645 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551232"></a>
     3645</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551498"></a>
    36463646
    36473647max stat cache size (G)
    3648 </h3></div></div></div><a class="indexterm" name="id2551233"></a><a name="MAXSTATCACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the size in memory of any
     3648</h3></div></div></div><a class="indexterm" name="id2551499"></a><a name="MAXSTATCACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter limits the size in memory of any
    36493649          <em class="parameter"><code>stat cache</code></em> being used
    36503650          to speed up case insensitive name mappings. It represents
    … …  
    36573657</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max stat cache size</code></em> = <code class="literal">100</code>
    36583658</em></span>
    3659 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551302"></a>
     3659</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551568"></a>
    36603660
    36613661max ttl (G)
    3662 </h3></div></div></div><a class="indexterm" name="id2551303"></a><a name="MAXTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> what the default 'time to live'
     3662</h3></div></div></div><a class="indexterm" name="id2551569"></a><a name="MAXTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> what the default 'time to live'
    36633663    of NetBIOS names should be (in seconds) when <code class="literal">nmbd</code> is
    36643664    requesting a name using either a broadcast packet or from a WINS server. You should
    36653665        never need to change this parameter. The default is 3 days.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>max ttl</code></em> = <code class="literal">259200</code>
    36663666</em></span>
    3667 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551361"></a>
     3667</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551627"></a>
    36683668
    36693669max wins ttl (G)
    3670 </h3></div></div></div><a class="indexterm" name="id2551362"></a><a name="MAXWINSTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when acting as a WINS server
     3670</h3></div></div></div><a class="indexterm" name="id2551628"></a><a name="MAXWINSTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when acting as a WINS server
    36713671        (<a class="link" href="smb.conf.5.html#WINSSUPPORT" target="_top">wins support = yes</a>) what the maximum
    36723672    'time to live' of NetBIOS names that <code class="literal">nmbd</code>
    … …  
    36743674        parameter.  The default is 6 days (518400 seconds).</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>max wins ttl</code></em> = <code class="literal">518400</code>
    36753675</em></span>
    3676 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551433"></a>
     3676</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551699"></a>
    36773677
    36783678max xmit (G)
    3679 </h3></div></div></div><a class="indexterm" name="id2551434"></a><a name="MAXXMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum packet size
     3679</h3></div></div></div><a class="indexterm" name="id2551700"></a><a name="MAXXMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum packet size
    36803680    that will be negotiated by Samba. The default is 16644, which
    36813681    matches the behavior of Windows 2000.  A value below 2048 is likely to cause problems.
    … …  
    36853685</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>max xmit</code></em> = <code class="literal">8192</code>
    36863686</em></span>
    3687 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551495"></a>
     3687</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551761"></a>
    36883688
    36893689message command (G)
    3690 </h3></div></div></div><a class="indexterm" name="id2551496"></a><a name="MESSAGECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what command to run when the
     3690</h3></div></div></div><a class="indexterm" name="id2551762"></a><a name="MESSAGECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies what command to run when the
    36913691        server receives a WinPopup style message.</p><p>This would normally be a command that would
    36923692        deliver the message somehow. How this is to be done is
    … …  
    37273727</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>message command</code></em> = <code class="literal">csh -c 'xedit %s; rm %s' &amp;</code>
    37283728</em></span>
    3729 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551705"></a>
     3729</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551971"></a>
    37303730
    37313731min print space (S)
    3732 </h3></div></div></div><a class="indexterm" name="id2551706"></a><a name="MINPRINTSPACE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the minimum amount of free disk
     3732</h3></div></div></div><a class="indexterm" name="id2551972"></a><a name="MINPRINTSPACE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the minimum amount of free disk
    37333733    space that must be available before a user will be able to spool
    37343734    a print job. It is specified in kilobytes. The default is 0, which
    … …  
    37373737</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>min print space</code></em> = <code class="literal">2000</code>
    37383738</em></span>
    3739 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551768"></a>
     3739</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552034"></a>
    37403740
    37413741min protocol (G)
    3742 </h3></div></div></div><a class="indexterm" name="id2551769"></a><a name="MINPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the
     3742</h3></div></div></div><a class="indexterm" name="id2552035"></a><a name="MINPROTOCOL"></a><div class="variablelist"><dl><dt></dt><dd><p>The value of the parameter (a string) is the
    37433743    lowest SMB protocol dialect than Samba will support.  Please refer
    37443744    to the <a class="link" href="smb.conf.5.html#MAXPROTOCOL" target="_top">max protocol</a>
    … …  
    37523752</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>min protocol</code></em> = <code class="literal">NT1</code>
    37533753</em></span>
    3754 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551866"></a>
     3754</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552132"></a>
    37553755
    37563756min receivefile size (G)
    3757 </h3></div></div></div><a class="indexterm" name="id2551867"></a><a name="MINRECEIVEFILESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option changes the behavior of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when processing SMBwriteX calls. Any incoming
     3757</h3></div></div></div><a class="indexterm" name="id2552133"></a><a name="MINRECEIVEFILESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option changes the behavior of <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> when processing SMBwriteX calls. Any incoming
    37583758SMBwriteX call on a non-signed SMB/CIFS connection greater than this value will not be processed in the normal way but will
    37593759be passed to any underlying kernel recvfile or splice system call (if there is no such
    … …  
    37643764nonzero. The maximum value is 128k. Values greater than 128k will be silently set to 128k.</p><p>Note this option will have NO EFFECT if set on a SMB signed connection.</p><p>The default is zero, which diables this option.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>min receivefile size</code></em> = <code class="literal">0</code>
    37653765</em></span>
    3766 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2551947"></a>
     3766</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552213"></a>
    37673767
    37683768min wins ttl (G)
    3769 </h3></div></div></div><a class="indexterm" name="id2551948"></a><a name="MINWINSTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>
     3769</h3></div></div></div><a class="indexterm" name="id2552214"></a><a name="MINWINSTTL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option tells <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>
    37703770    when acting as a WINS server (<a class="link" href="smb.conf.5.html#WINSSUPPORT" target="_top">wins support = yes</a>) what the minimum 'time to live'
    37713771    of NetBIOS names that <code class="literal">nmbd</code> will grant will be (in
    … …  
    37733773    is 6 hours (21600 seconds).</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>min wins ttl</code></em> = <code class="literal">21600</code>
    37743774</em></span>
    3775 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552018"></a>
     3775</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552283"></a>
    37763776
    37773777msdfs proxy (S)
    3778 </h3></div></div></div><a class="indexterm" name="id2552019"></a><a name="MSDFSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter indicates that the share is a
     3778</h3></div></div></div><a class="indexterm" name="id2552284"></a><a name="MSDFSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter indicates that the share is a
    37793779        stand-in for another CIFS share whose location is specified by
    37803780        the value of the parameter. When clients attempt to connect to
    … …  
    37843784        options to find out how to set up a Dfs root share.</p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>msdfs proxy</code></em> = <code class="literal">\otherserver\someshare</code>
    37853785</em></span>
    3786 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552096"></a>
     3786</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552361"></a>
    37873787
    37883788msdfs root (S)
    3789 </h3></div></div></div><a class="indexterm" name="id2552097"></a><a name="MSDFSROOT"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to <code class="constant">yes</code>, Samba treats the
     3789</h3></div></div></div><a class="indexterm" name="id2552362"></a><a name="MSDFSROOT"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to <code class="constant">yes</code>, Samba treats the
    37903790        share as a Dfs root and allows clients to browse the
    37913791        distributed file system tree rooted at the share directory.
    … …  
    37953795        Samba, refer to the MSDFS chapter in the Samba3-HOWTO book.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>msdfs root</code></em> = <code class="literal">no</code>
    37963796</em></span>
    3797 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552151"></a>
     3797</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552417"></a>
    37983798
    37993799name cache timeout (G)
    3800 </h3></div></div></div><a class="indexterm" name="id2552152"></a><a name="NAMECACHETIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the number of seconds it takes before
     3800</h3></div></div></div><a class="indexterm" name="id2552418"></a><a name="NAMECACHETIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the number of seconds it takes before
    38013801    entries in samba's hostname resolve cache time out. If
    38023802    the timeout is set to 0. the caching is disabled.
    … …  
    38053805</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>name cache timeout</code></em> = <code class="literal">0</code>
    38063806</em></span>
    3807 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552212"></a>
     3807</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552478"></a>
    38083808
    38093809name resolve order (G)
    3810 </h3></div></div></div><a class="indexterm" name="id2552213"></a><a name="NAMERESOLVEORDER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used by the programs in the Samba
     3810</h3></div></div></div><a class="indexterm" name="id2552479"></a><a name="NAMERESOLVEORDER"></a><div class="variablelist"><dl><dt></dt><dd><p>This option is used by the programs in the Samba
    38113811    suite to determine what naming services to use and in what order
    38123812    to resolve host names to IP addresses. Its main purpose to is to
    … …  
    38393839</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>name resolve order</code></em> = <code class="literal">lmhosts bcast host</code>
    38403840</em></span>
    3841 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552414"></a>
     3841</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552680"></a>
    38423842
    38433843netbios aliases (G)
    3844 </h3></div></div></div><a class="indexterm" name="id2552415"></a><a name="NETBIOSALIASES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of NetBIOS names that nmbd will
     3844</h3></div></div></div><a class="indexterm" name="id2552681"></a><a name="NETBIOSALIASES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of NetBIOS names that nmbd will
    38453845        advertise as additional names by which the Samba server is known. This allows one machine
    38463846        to appear in browse lists under multiple names. If a machine is acting as a browse server
    … …  
    38523852</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>netbios aliases</code></em> = <code class="literal">TEST TEST1 TEST2</code>
    38533853</em></span>
    3854 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552488"></a>
     3854</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552746"></a>
    38553855
    38563856netbios name (G)
    3857 </h3></div></div></div><a class="indexterm" name="id2552489"></a><a name="NETBIOSNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3857</h3></div></div></div><a class="indexterm" name="id2552747"></a><a name="NETBIOSNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    38583858                This sets the NetBIOS name by which a Samba server is known. By default it is the same as the first component
    38593859                of the host's DNS name. If a machine is a browse server or logon server this name (or the first component of
    … …  
    38683868</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>netbios name</code></em> = <code class="literal">MYNAME</code>
    38693869</em></span>
    3870 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552569"></a>
     3870</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552828"></a>
    38713871
    38723872netbios scope (G)
    3873 </h3></div></div></div><a class="indexterm" name="id2552570"></a><a name="NETBIOSSCOPE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the NetBIOS scope that Samba will
     3873</h3></div></div></div><a class="indexterm" name="id2552829"></a><a name="NETBIOSSCOPE"></a><div class="variablelist"><dl><dt></dt><dd><p>This sets the NetBIOS scope that Samba will
    38743874        operate under. This should not be set unless every machine
    38753875        on your LAN also sets this value.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>netbios scope</code></em> = <code class="literal"></code>
    38763876</em></span>
    3877 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552612"></a>
     3877</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552870"></a>
    38783878
    38793879nis homedir (G)
    3880 </h3></div></div></div><a class="indexterm" name="id2552613"></a><a name="NISHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>Get the home share server from a NIS map. For
     3880</h3></div></div></div><a class="indexterm" name="id2552871"></a><a name="NISHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>Get the home share server from a NIS map. For
    38813881        UNIX systems that use an automounter, the user's home directory
    38823882        will often be mounted on a workstation on demand from a remote
    … …  
    38973897        be a logon server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nis homedir</code></em> = <code class="literal">no</code>
    38983898</em></span>
    3899 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552692"></a>
     3899</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552950"></a>
    39003900
    39013901nt acl support (S)
    3902 </h3></div></div></div><a class="indexterm" name="id2552693"></a><a name="NTACLSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to map
     3902</h3></div></div></div><a class="indexterm" name="id2552951"></a><a name="NTACLSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to map
    39033903    UNIX permissions into Windows NT access control lists.  The UNIX
    39043904    permissions considered are the the traditional UNIX owner and
    … …  
    39073907    releases prior to 2.2.2.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nt acl support</code></em> = <code class="literal">yes</code>
    39083908</em></span>
    3909 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552746"></a>
     3909</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553005"></a>
    39103910
    39113911ntlm auth (G)
    3912 </h3></div></div></div><a class="indexterm" name="id2552748"></a><a name="NTLMAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to
     3912</h3></div></div></div><a class="indexterm" name="id2553006"></a><a name="NTLMAUTH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines whether or not <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will attempt to
    39133913    authenticate users using the NTLM encrypted password response.
    39143914    If disabled, either the lanman password hash or an NTLMv2 response
    … …  
    39183918        special configuration to use it.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>ntlm auth</code></em> = <code class="literal">yes</code>
    39193919</em></span>
    3920 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552810"></a>
     3920</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553069"></a>
    39213921
    39223922nt pipe support (G)
    3923 </h3></div></div></div><a class="indexterm" name="id2552812"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
     3923</h3></div></div></div><a class="indexterm" name="id2553070"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
    39243924    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will allow Windows NT
    39253925    clients to connect to the NT SMB specific <code class="constant">IPC$</code>
    … …  
    39273927        alone.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nt pipe support</code></em> = <code class="literal">yes</code>
    39283928</em></span>
    3929 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552866"></a>
     3929</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553125"></a>
    39303930
    39313931nt status support (G)
    3932 </h3></div></div></div><a class="indexterm" name="id2552867"></a><a name="NTSTATUSSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will negotiate NT specific status
     3932</h3></div></div></div><a class="indexterm" name="id2553126"></a><a name="NTSTATUSSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will negotiate NT specific status
    39333933    support with Windows NT/2k/XP clients. This is a developer debugging option and should be left alone.
    39343934    If this option is set to <code class="constant">no</code> then Samba offers
    … …  
    39363936    reported.</p><p>You should not need to ever disable this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nt status support</code></em> = <code class="literal">yes</code>
    39373937</em></span>
    3938 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552928"></a>
     3938</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553186"></a>
    39393939
    39403940null passwords (G)
    3941 </h3></div></div></div><a class="indexterm" name="id2552929"></a><a name="NULLPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>Allow or disallow client access to accounts that have null passwords. </p><p>See also <a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>null passwords</code></em> = <code class="literal">no</code>
    3942 </em></span>
    3943 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2552981"></a>
     3941</h3></div></div></div><a class="indexterm" name="id2553188"></a><a name="NULLPASSWORDS"></a><div class="variablelist"><dl><dt></dt><dd><p>Allow or disallow client access to accounts that have null passwords. </p><p>See also <a class="citerefentry" href="smbpasswd.5.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(5)</span></a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>null passwords</code></em> = <code class="literal">no</code>
     3942</em></span>
     3943</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553240"></a>
    39443944
    39453945obey pam restrictions (G)
    3946 </h3></div></div></div><a class="indexterm" name="id2552982"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
     3946</h3></div></div></div><a class="indexterm" name="id2553241"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
    39473947    (i.e. --with-pam), this parameter will control whether or not Samba
    39483948    should obey PAM's account and session management directives.  The
    … …  
    39543954</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>obey pam restrictions</code></em> = <code class="literal">no</code>
    39553955</em></span>
    3956 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553052"></a>
     3956</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553311"></a>
    39573957
    39583958only user (S)
    3959 </h3></div></div></div><a class="indexterm" name="id2553053"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
     3959</h3></div></div></div><a class="indexterm" name="id2553312"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
    39603960    connections with usernames not in the <em class="parameter"><code>user</code></em>
    39613961    list will be allowed. By default this option is disabled so that a
    … …  
    39703970    name of the user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>only user</code></em> = <code class="literal">no</code>
    39713971</em></span>
    3972 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553141"></a>
     3972</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553399"></a>
    39733973
    39743974oplock break wait time (G)
    3975 </h3></div></div></div><a class="indexterm" name="id2553142"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3975</h3></div></div></div><a class="indexterm" name="id2553400"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    39763976        This is a tuning parameter added due to bugs in both Windows 9x and WinNT. If Samba responds to a client too
    39773977        quickly when that client issues an SMB that can cause an oplock break request, then the network client can
    … …  
    39823982        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock break wait time</code></em> = <code class="literal">0</code>
    39833983</em></span>
    3984 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553195"></a>
     3984</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553454"></a>
    39853985
    39863986oplock contention limit (S)
    3987 </h3></div></div></div><a class="indexterm" name="id2553196"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     3987</h3></div></div></div><a class="indexterm" name="id2553455"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    39883988        This is a <span class="emphasis"><em>very</em></span> advanced <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> tuning option to improve the efficiency of the
    39893989        granting of oplocks under multiple client contention for the same file.
    … …  
    39973997        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock contention limit</code></em> = <code class="literal">2</code>
    39983998</em></span>
    3999 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553278"></a>
     3999</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553536"></a>
    40004000
    40014001oplocks (S)
    4002 </h3></div></div></div><a class="indexterm" name="id2553279"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4002</h3></div></div></div><a class="indexterm" name="id2553537"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    40034003        This boolean option tells <code class="literal">smbd</code> whether to
    40044004        issue oplocks (opportunistic locks) to file open requests on this
    … …  
    40194019        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplocks</code></em> = <code class="literal">yes</code>
    40204020</em></span>
    4021 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553377"></a>
     4021</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553636"></a>
    40224022
    40234023os2 driver map (G)
    4024 </h3></div></div></div><a class="indexterm" name="id2553378"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
     4024</h3></div></div></div><a class="indexterm" name="id2553637"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
    40254025    path to a file containing a mapping of Windows NT printer driver
    40264026    names to OS/2 printer driver names.  The format is:</p><p>&lt;nt driver name&gt; = &lt;os2 driver name&gt;.&lt;device name&gt;</p><p>For example, a valid entry using the HP LaserJet 5
    … …  
    40324032    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>os2 driver map</code></em> = <code class="literal"></code>
    40334033</em></span>
    4034 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553444"></a>
     4034</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553703"></a>
    40354035
    40364036os level (G)
    4037 </h3></div></div></div><a class="indexterm" name="id2553446"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4037</h3></div></div></div><a class="indexterm" name="id2553704"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    40384038        This integer value controls what level Samba advertises itself as for browse elections. The value of this
    40394039        parameter determines whether <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> has a chance of becoming a local master browser for the <a class="link" href="smb.conf.5.html#WORKGROUP" target="_top">workgroup</a> in the local broadcast area.
    … …  
    40514051</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>os level</code></em> = <code class="literal">65</code>
    40524052</em></span>
    4053 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553544"></a>
     4053</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553802"></a>
    40544054
    40554055pam password change (G)
    4056 </h3></div></div></div><a class="indexterm" name="id2553545"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
     4056</h3></div></div></div><a class="indexterm" name="id2553803"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
    40574057    this parameter, it is possible to use PAM's password change control
    40584058    flag for Samba.  If enabled, then PAM will be used for password
    … …  
    40624062    <a class="link" href="smb.conf.5.html#PASSWDCHAT" target="_top">passwd chat</a> parameter for most setups.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>pam password change</code></em> = <code class="literal">no</code>
    40634063</em></span>
    4064 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553617"></a>
     4064</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553875"></a>
    40654065
    40664066panic action (G)
    4067 </h3></div></div></div><a class="indexterm" name="id2553618"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
     4067</h3></div></div></div><a class="indexterm" name="id2553876"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
    40684068        system command to be called when either <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> or <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>      crashes. This is usually used to
    40694069        draw attention to the fact that a problem occurred.
    … …  
    40724072</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>panic action</code></em> = <code class="literal">"/bin/sleep 90000"</code>
    40734073</em></span>
    4074 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553693"></a>
     4074</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553951"></a>
    40754075
    40764076paranoid server security (G)
    4077 </h3></div></div></div><a class="indexterm" name="id2553694"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
     4077</h3></div></div></div><a class="indexterm" name="id2553952"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
    40784078    users with a bad passowrd. When this option is enabled, samba will not
    40794079    use a broken NT 4.x server as password server, but instead complain
    … …  
    40834083    bad logon to the remote server.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>paranoid server security</code></em> = <code class="literal">yes</code>
    40844084</em></span>
    4085 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553744"></a>
     4085</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554002"></a>
    40864086
    40874087passdb backend (G)
    4088 </h3></div></div></div><a class="indexterm" name="id2553745"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
     4088</h3></div></div></div><a class="indexterm" name="id2554003"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
    40894089    will be used for storing user and possibly group information.  This allows
    40904090    you to swap between different storage mechanisms without recompile. </p><p>The parameter value is divided into two parts, the backend's name, and a 'location'
    … …  
    41194119</pre><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb backend</code></em> = <code class="literal">smbpasswd</code>
    41204120</em></span>
    4121 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553901"></a>
     4121</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554159"></a>
    41224122
    41234123passdb expand explicit (G)
    4124 </h3></div></div></div><a class="indexterm" name="id2553902"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4124</h3></div></div></div><a class="indexterm" name="id2554160"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    41254125        This parameter controls whether Samba substitutes %-macros in the passdb fields if they are explicitly set. We
    41264126        used to expand macros here, but this turned out to be a bug because the Windows client can expand a variable
    … …  
    41284128    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb expand explicit</code></em> = <code class="literal">no</code>
    41294129</em></span>
    4130 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2553948"></a>
     4130</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554206"></a>
    41314131
    41324132passwd chat debug (G)
    4133 </h3></div></div></div><a class="indexterm" name="id2553949"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
     4133</h3></div></div></div><a class="indexterm" name="id2554207"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
    41344134    parameter is run in <span class="emphasis"><em>debug</em></span> mode. In this mode the
    41354135    strings passed to and received from the passwd chat are printed
    … …  
    41444144        parameter is set. This parameter is off by default.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passwd chat debug</code></em> = <code class="literal">no</code>
    41454145</em></span>
    4146 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554051"></a>
     4146</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554309"></a>
    41474147
    41484148passwd chat timeout (G)
    4149 </h3></div></div></div><a class="indexterm" name="id2554052"></a><a name="PASSWDCHATTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>This integer specifies the number of seconds smbd will wait for an initial
     4149</h3></div></div></div><a class="indexterm" name="id2554310"></a><a name="PASSWDCHATTIMEOUT"></a><div class="variablelist"><dl><dt></dt><dd><p>This integer specifies the number of seconds smbd will wait for an initial
    41504150    answer from a passwd chat script being run. Once the initial answer is received
    41514151    the subsequent answers must be received in one tenth of this time. The default it
    41524152    two seconds.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passwd chat timeout</code></em> = <code class="literal">2</code>
    41534153</em></span>
    4154 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554096"></a>
     4154</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554354"></a>
    41554155
    41564156passwd chat (G)
    4157 </h3></div></div></div><a class="indexterm" name="id2554097"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
     4157</h3></div></div></div><a class="indexterm" name="id2554356"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
    41584158    conversation that takes places between <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> and the local password changing
    41594159    program to change the user's password. The string describes a
    … …  
    41864186</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>passwd chat</code></em> = <code class="literal">"*Enter NEW password*" %n\n "*Reenter NEW password*" %n\n "*Password changed*"</code>
    41874187</em></span>
    4188 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554302"></a>
     4188</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554560"></a>
    41894189
    41904190passwd program (G)
    4191 </h3></div></div></div><a class="indexterm" name="id2554303"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
     4191</h3></div></div></div><a class="indexterm" name="id2554561"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
    41924192    UNIX user passwords.  Any occurrences of <em class="parameter"><code>%u</code></em>
    41934193    will be replaced with the user name. The user name is checked for
    … …  
    42104210</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>passwd program</code></em> = <code class="literal">/bin/passwd %u</code>
    42114211</em></span>
    4212 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554437"></a>
     4212</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554695"></a>
    42134213
    42144214password level (G)
    4215 </h3></div></div></div><a class="indexterm" name="id2554438"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
     4215</h3></div></div></div><a class="indexterm" name="id2554696"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
    42164216    with mixed-case passwords.  One offending client is Windows for
    42174217    Workgroups, which for some reason forces passwords to upper
    … …  
    42354235</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>password level</code></em> = <code class="literal">4</code>
    42364236</em></span>
    4237 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554574"></a>
     4237</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554832"></a>
    42384238
    42394239password server (G)
    4240 </h3></div></div></div><a class="indexterm" name="id2554575"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
     4240</h3></div></div></div><a class="indexterm" name="id2554833"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
    42414241    or Active Directory domain controller with this option,
    42424242    and using <code class="literal">security = [ads|domain|server]</code>
    … …  
    42984298</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>password server</code></em> = <code class="literal">windc.mydomain.com:389 192.168.1.101 *</code>
    42994299</em></span>
    4300 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554872"></a>
     4300</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555130"></a>
    43014301
    43024302<a name="DIRECTORY"></a>directory
    4303 </h3></div></div></div><a class="indexterm" name="id2554873"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PATH">path</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554903"></a>
     4303</h3></div></div></div><a class="indexterm" name="id2555132"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PATH">path</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555162"></a>
    43044304
    43054305path (S)
    4306 </h3></div></div></div><a class="indexterm" name="id2554904"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
     4306</h3></div></div></div><a class="indexterm" name="id2555163"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
    43074307        the user of the service is to be given access. In the case of
    43084308        printable services, this is where print data will spool prior to
    … …  
    43214321</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>path</code></em> = <code class="literal">/home/fred</code>
    43224322</em></span>
    4323 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555007"></a>
     4323</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555266"></a>
    43244324
    43254325pid directory (G)
    4326 </h3></div></div></div><a class="indexterm" name="id2555008"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4326</h3></div></div></div><a class="indexterm" name="id2555267"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43274327        This option specifies the directory where pid files will be placed. 
    43284328        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">${prefix}/var/locks</code>
    … …  
    43304330</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">pid directory = /var/run/</code>
    43314331</em></span>
    4332 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555068"></a>
     4332</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555326"></a>
    43334333
    43344334posix locking (S)
    4335 </h3></div></div></div><a class="indexterm" name="id2555069"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4335</h3></div></div></div><a class="indexterm" name="id2555327"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43364336        The <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    43374337        daemon maintains an database of file locks obtained by SMB clients. The default behavior is
    … …  
    43414341        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>posix locking</code></em> = <code class="literal">yes</code>
    43424342</em></span>
    4343 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555123"></a>
     4343</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555381"></a>
    43444344
    43454345postexec (S)
    4346 </h3></div></div></div><a class="indexterm" name="id2555124"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
     4346</h3></div></div></div><a class="indexterm" name="id2555382"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
    43474347        whenever the service is disconnected. It takes the usual
    43484348        substitutions. The command may be run as the root on some
    … …  
    43524352</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>postexec</code></em> = <code class="literal">echo \"%u disconnected from %S from %m (%I)\" &gt;&gt; /tmp/log</code>
    43534353</em></span>
    4354 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555196"></a>
     4354</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555454"></a>
    43554355
    43564356preexec close (S)
    4357 </h3></div></div></div><a class="indexterm" name="id2555197"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4357</h3></div></div></div><a class="indexterm" name="id2555455"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43584358        This boolean option controls whether a non-zero return code from <a class="link" href="smb.conf.5.html#PREEXEC" target="_top">preexec</a>
    43594359        should close the service being connected to.
    43604360        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preexec close</code></em> = <code class="literal">no</code>
    43614361</em></span>
    4362 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555251"></a>
     4362</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555509"></a>
    43634363
    43644364<a name="EXEC"></a>exec
    4365 </h3></div></div></div><a class="indexterm" name="id2555252"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PREEXEC">preexec</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555282"></a>
     4365</h3></div></div></div><a class="indexterm" name="id2555510"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PREEXEC">preexec</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555540"></a>
    43664366
    43674367preexec (S)
    4368 </h3></div></div></div><a class="indexterm" name="id2555283"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
     4368</h3></div></div></div><a class="indexterm" name="id2555542"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
    43694369        the service is connected to. It takes the usual substitutions.</p><p>An interesting example is to send the users a welcome
    43704370        message every time they log in. Maybe a message of the day? Here
    … …  
    43784378</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>preexec</code></em> = <code class="literal">echo \"%u connected to %S from %m (%I)\" &gt;&gt; /tmp/log</code>
    43794379</em></span>
    4380 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555390"></a>
     4380</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555648"></a>
    43814381
    43824382<a name="PREFEREDMASTER"></a>prefered master
    4383 </h3></div></div></div><a class="indexterm" name="id2555391"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PREFERREDMASTER">preferred master</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555424"></a>
     4383</h3></div></div></div><a class="indexterm" name="id2555649"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PREFERREDMASTER">preferred master</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555681"></a>
    43844384
    43854385preferred master (G)
    4386 </h3></div></div></div><a class="indexterm" name="id2555425"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4386</h3></div></div></div><a class="indexterm" name="id2555682"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43874387        This boolean parameter controls if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> is a preferred master browser  for its workgroup.
    43884388        </p><p>
    … …  
    43984398        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preferred master</code></em> = <code class="literal">auto</code>
    43994399</em></span>
    4400 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555517"></a>
     4400</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555775"></a>
    44014401
    44024402preload modules (G)
    4403 </h3></div></div></div><a class="indexterm" name="id2555518"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
     4403</h3></div></div></div><a class="indexterm" name="id2555776"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
    44044404        be loaded into smbd before a client connects. This improves
    44054405        the speed of smbd when reacting to new connections somewhat. </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preload modules</code></em> = <code class="literal"></code>
    … …  
    44074407</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>preload modules</code></em> = <code class="literal">/usr/lib/samba/passdb/mysql.so</code>
    44084408</em></span>
    4409 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555578"></a>
     4409</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555836"></a>
    44104410
    44114411<a name="AUTOSERVICES"></a>auto services
    4412 </h3></div></div></div><a class="indexterm" name="id2555579"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRELOAD">preload</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555610"></a>
     4412</h3></div></div></div><a class="indexterm" name="id2555837"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRELOAD">preload</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555868"></a>
    44134413
    44144414preload (G)
    4415 </h3></div></div></div><a class="indexterm" name="id2555611"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
     4415</h3></div></div></div><a class="indexterm" name="id2555870"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
    44164416        automatically added to the browse lists. This is most useful
    44174417        for homes and printers services that would otherwise not be
    … …  
    44244424</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>preload</code></em> = <code class="literal">fred lp colorlp</code>
    44254425</em></span>
    4426 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555688"></a>
     4426</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555946"></a>
    44274427
    44284428preserve case (S)
    4429 </h3></div></div></div><a class="indexterm" name="id2555689"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4429</h3></div></div></div><a class="indexterm" name="id2555948"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44304430        This controls if new filenames are created with the case that the client passes, or if
    44314431        they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE" target="_top">default case</a>.
    … …  
    44344434        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preserve case</code></em> = <code class="literal">yes</code>
    44354435</em></span>
    4436 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555755"></a>
     4436</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556013"></a>
    44374437
    44384438<a name="PRINTOK"></a>print ok
    4439 </h3></div></div></div><a class="indexterm" name="id2555756"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTABLE">printable</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555786"></a>
     4439</h3></div></div></div><a class="indexterm" name="id2556014"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTABLE">printable</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556044"></a>
    44404440
    44414441printable (S)
    4442 </h3></div></div></div><a class="indexterm" name="id2555787"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
     4442</h3></div></div></div><a class="indexterm" name="id2556045"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
    44434443    clients may open, write to and submit spool files on the directory
    44444444    specified for the service. </p><p>Note that a printable service will ALWAYS allow writing
    … …  
    44474447    the resource.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>printable</code></em> = <code class="literal">no</code>
    44484448</em></span>
    4449 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555849"></a>
     4449</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556107"></a>
    44504450
    44514451printcap cache time (G)
    4452 </h3></div></div></div><a class="indexterm" name="id2555850"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
     4452</h3></div></div></div><a class="indexterm" name="id2556108"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
    44534453    subsystem is again asked for the known printers.  If the value
    44544454    is greater than 60 the initial waiting time is set to 60 seconds
    … …  
    44604460</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap cache time</code></em> = <code class="literal">600</code>
    44614461</em></span>
    4462 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555918"></a>
     4462</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556176"></a>
    44634463
    44644464<a name="PRINTCAP"></a>printcap
    4465 </h3></div></div></div><a class="indexterm" name="id2555919"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTCAPNAME">printcap name</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555951"></a>
     4465</h3></div></div></div><a class="indexterm" name="id2556177"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTCAPNAME">printcap name</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556209"></a>
    44664466
    44674467printcap name (G)
    4468 </h3></div></div></div><a class="indexterm" name="id2555952"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4468</h3></div></div></div><a class="indexterm" name="id2556210"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44694469        This parameter may be used to override the compiled-in default printcap name used by the server (usually
    44704470        <code class="filename"> /etc/printcap</code>). See the discussion of the <a class="link" href="#PRINTERSSECT" title="The [printers] section">[printers]</a> section above for reasons why you might want to do this.
    … …  
    45014501</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap name</code></em> = <code class="literal">/etc/myprintcap</code>
    45024502</em></span>
    4503 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556135"></a>
     4503</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556393"></a>
    45044504
    45054505print command (S)
    4506 </h3></div></div></div><a class="indexterm" name="id2556136"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
     4506</h3></div></div></div><a class="indexterm" name="id2556394"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
    45074507    a service, this command will be used via a <code class="literal">system()</code>
    45084508    call to process the spool file. Typically the command specified will
    … …  
    45464546        set print command will be ignored.</p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>print command</code></em> = <code class="literal">/usr/local/samba/bin/myprintscript %p %s</code>
    45474547</em></span>
    4548 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556405"></a>
     4548</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556663"></a>
    45494549
    45504550printer admin (S)
    4551 </h3></div></div></div><a class="indexterm" name="id2556406"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4551</h3></div></div></div><a class="indexterm" name="id2556664"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    45524552        This lists users who can do anything to printers
    45534553        via the remote administration interfaces offered
    … …  
    45654565</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer admin</code></em> = <code class="literal">admin, @staff</code>
    45664566</em></span>
    4567 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556474"></a>
     4567</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556732"></a>
    45684568
    45694569<a name="PRINTER"></a>printer
    4570 </h3></div></div></div><a class="indexterm" name="id2556475"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTERNAME">printer name</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556505"></a>
     4570</h3></div></div></div><a class="indexterm" name="id2556733"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#PRINTERNAME">printer name</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556764"></a>
    45714571
    45724572printer name (S)
    4573 </h3></div></div></div><a class="indexterm" name="id2556506"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4573</h3></div></div></div><a class="indexterm" name="id2556765"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    45744574        This parameter specifies the name of the printer to which print jobs spooled through a printable service
    45754575        will be sent.
    … …  
    45844584</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer name</code></em> = <code class="literal">laserwriter</code>
    45854585</em></span>
    4586 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556593"></a>
     4586</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556852"></a>
    45874587
    45884588printing (S)
    4589 </h3></div></div></div><a class="indexterm" name="id2556594"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
     4589</h3></div></div></div><a class="indexterm" name="id2556853"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
    45904590    interpreted on your system. It also affects the  default values for
    45914591    the <em class="parameter"><code>print command</code></em>,  <em class="parameter"><code>lpq command</code></em>, <em class="parameter"><code>lppause command </code></em>, <em class="parameter"><code>lpresume command</code></em>, and  <em class="parameter"><code>lprm command</code></em> if specified in the
    … …  
    46044604<code class="literal">testparm -v.</code></code>
    46054605</em></span>
    4606 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556747"></a>
     4606</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557005"></a>
    46074607
    46084608printjob username (S)
    4609 </h3></div></div></div><a class="indexterm" name="id2556748"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
     4609</h3></div></div></div><a class="indexterm" name="id2557006"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
    46104610    passed to the printing system. Usually, the username is sent,
    46114611    but in some cases, e.g. the domain prefix is useful, too.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>printjob username</code></em> = <code class="literal">%U</code>
    … …  
    46134613</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printjob username</code></em> = <code class="literal">%D\%U</code>
    46144614</em></span>
    4615 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556808"></a>
     4615</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557066"></a>
    46164616
    46174617private dir (G)
    4618 </h3></div></div></div><a class="indexterm" name="id2556809"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
     4618</h3></div></div></div><a class="indexterm" name="id2557067"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
    46194619    smbd will use for storing such files as <code class="filename">smbpasswd</code>
    46204620    and <code class="filename">secrets.tdb</code>.
    46214621</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>private dir</code></em> = <code class="literal">${prefix}/private</code>
    46224622</em></span>
    4623 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556862"></a>
     4623</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557120"></a>
    46244624
    46254625profile acls (S)
    4626 </h3></div></div></div><a class="indexterm" name="id2556863"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4626</h3></div></div></div><a class="indexterm" name="id2557121"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46274627        This boolean parameter was added to fix the problems that people have been
    46284628        having with storing user profiles on Samba shares from Windows 2000 or
    … …  
    46524652        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>profile acls</code></em> = <code class="literal">no</code>
    46534653</em></span>
    4654 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556946"></a>
     4654</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557204"></a>
    46554655
    46564656queuepause command (S)
    4657 </h3></div></div></div><a class="indexterm" name="id2556947"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     4657</h3></div></div></div><a class="indexterm" name="id2557205"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    46584658    executed on the server host in order to pause the printer queue.</p><p>This command should be a program or script which takes
    46594659    a printer name as its only parameter and stops the printer queue,
    … …  
    46664666        server.</p><p><span class="emphasis"><em>No default</em></span></p><p>Example: <span class="emphasis"><em><em class="parameter"><code>queuepause command</code></em> = <code class="literal">disable %p</code>
    46674667</em></span>
    4668 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557023"></a>
     4668</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557281"></a>
    46694669
    46704670queueresume command (S)
    4671 </h3></div></div></div><a class="indexterm" name="id2557024"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     4671</h3></div></div></div><a class="indexterm" name="id2557282"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    46724672    executed on the server host in order to resume the printer queue. It
    46734673    is the command to undo the behavior that is caused by the
    … …  
    46844684</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>queueresume command</code></em> = <code class="literal">enable %p</code>
    46854685</em></span>
    4686 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557126"></a>
     4686</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557384"></a>
    46874687
    46884688read list (S)
    4689 </h3></div></div></div><a class="indexterm" name="id2557127"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4689</h3></div></div></div><a class="indexterm" name="id2557385"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46904690        This is a list of users that are given read-only access to a service. If the connecting user is in this list
    46914691        then they will not be given write access, no matter what the <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a> option is set
    … …  
    46974697</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>read list</code></em> = <code class="literal">mary, @students</code>
    46984698</em></span>
    4699 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557225"></a>
     4699</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557484"></a>
    47004700
    47014701read only (S)
    4702 </h3></div></div></div><a class="indexterm" name="id2557226"></a><a name="READONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>An inverted synonym is <a class="link" href="smb.conf.5.html#WRITEABLE" target="_top">writeable</a>.</p><p>If this parameter is <code class="constant">yes</code>, then users
     4702</h3></div></div></div><a class="indexterm" name="id2557485"></a><a name="READONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>An inverted synonym is <a class="link" href="smb.conf.5.html#WRITEABLE" target="_top">writeable</a>.</p><p>If this parameter is <code class="constant">yes</code>, then users
    47034703    of a service may not create or modify files in the service's
    47044704    directory.</p><p>Note that a printable service (<code class="literal">printable = yes</code>)
    … …  
    47064706    (user privileges permitting), but only via spooling operations.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>read only</code></em> = <code class="literal">yes</code>
    47074707</em></span>
    4708 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557302"></a>
     4708</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557560"></a>
    47094709
    47104710read raw (G)
    4711 </h3></div></div></div><a class="indexterm" name="id2557303"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     4711</h3></div></div></div><a class="indexterm" name="id2557562"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    47124712    will support the raw read SMB requests when transferring data
    47134713    to clients.</p><p>If enabled, raw reads allow reads of 65535 bytes in
    … …  
    47184718        tool and left severely alone.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>read raw</code></em> = <code class="literal">yes</code>
    47194719</em></span>
    4720 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557362"></a>
     4720</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557621"></a>
    47214721
    47224722realm (G)
    4723 </h3></div></div></div><a class="indexterm" name="id2557363"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
     4723</h3></div></div></div><a class="indexterm" name="id2557622"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
    47244724        used as the ADS equivalent of the NT4 <code class="literal">domain</code>. It
    47254725        is usually set to the DNS name of the kerberos server.
    … …  
    47284728</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>realm</code></em> = <code class="literal">mysambabox.mycompany.com</code>
    47294729</em></span>
    4730 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557427"></a>
     4730</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557686"></a>
    47314731
    47324732registry shares (G)
    4733 </h3></div></div></div><a class="indexterm" name="id2557428"></a><a name="REGISTRYSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4733</h3></div></div></div><a class="indexterm" name="id2557687"></a><a name="REGISTRYSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47344734        This turns on or off support for share definitions read from
    47354735        registry. Shares defined in <span class="emphasis"><em>smb.conf</em></span> take
    … …  
    47464746</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>registry shares</code></em> = <code class="literal">yes</code>
    47474747</em></span>
    4748 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557513"></a>
     4748</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557772"></a>
    47494749
    47504750remote announce (G)
    4751 </h3></div></div></div><a class="indexterm" name="id2557514"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4751</h3></div></div></div><a class="indexterm" name="id2557773"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47524752        This option allows you to setup <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> to periodically announce itself
    47534753        to arbitrary IP addresses with an arbitrary workgroup name.
    … …  
    47734773        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote announce</code></em> = <code class="literal"></code>
    47744774</em></span>
    4775 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557619"></a>
     4775</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557877"></a>
    47764776
    47774777remote browse sync (G)
    4778 </h3></div></div></div><a class="indexterm" name="id2557620"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4778</h3></div></div></div><a class="indexterm" name="id2557878"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47794779        This option allows you to setup <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> to periodically request
    47804780        synchronization of browse lists with the master browser of a Samba
    … …  
    48084808        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote browse sync</code></em> = <code class="literal"></code>
    48094809</em></span>
    4810 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557732"></a>
     4810</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557990"></a>
    48114811
    48124812rename user script (G)
    4813 </h3></div></div></div><a class="indexterm" name="id2557733"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4813</h3></div></div></div><a class="indexterm" name="id2557991"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48144814        This is the full pathname to a script that will be run as root by <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> under special circumstances described below.
    48154815        </p><p>
    … …  
    48294829        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>rename user script</code></em> = <code class="literal">no</code>
    48304830</em></span>
    4831 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557822"></a>
     4831</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558080"></a>
    48324832
    48334833reset on zero vc (G)
    4834 </h3></div></div></div><a class="indexterm" name="id2557823"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4834</h3></div></div></div><a class="indexterm" name="id2558081"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48354835        This boolean option controls whether an incoming session setup
    48364836        should kill other connections coming from the same IP. This matches
    … …  
    48514851        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>reset on zero vc</code></em> = <code class="literal">no</code>
    48524852</em></span>
    4853 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557875"></a>
     4853</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558133"></a>
    48544854
    48554855restrict anonymous (G)
    4856 </h3></div></div></div><a class="indexterm" name="id2557876"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
     4856</h3></div></div></div><a class="indexterm" name="id2558134"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
    48574857    group list information is returned for an anonymous connection.
    48584858    and mirrors the effects of the
    … …  
    48774877        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>restrict anonymous</code></em> = <code class="literal">0</code>
    48784878</em></span>
    4879 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557959"></a>
     4879</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558217"></a>
    48804880
    48814881<a name="ROOT"></a>root
    4882 </h3></div></div></div><a class="indexterm" name="id2557960"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#ROOTDIRECTORY">root directory</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557992"></a>
     4882</h3></div></div></div><a class="indexterm" name="id2558218"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#ROOTDIRECTORY">root directory</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558250"></a>
    48834883
    48844884<a name="ROOTDIR"></a>root dir
    4885 </h3></div></div></div><a class="indexterm" name="id2557993"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#ROOTDIRECTORY">root directory</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558023"></a>
     4885</h3></div></div></div><a class="indexterm" name="id2558251"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#ROOTDIRECTORY">root directory</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558282"></a>
    48864886
    48874887root directory (G)
    4888 </h3></div></div></div><a class="indexterm" name="id2558024"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
     4888</h3></div></div></div><a class="indexterm" name="id2558283"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
    48894889    Change its root directory) to this directory on startup. This is
    48904890    not strictly necessary for secure operation. Even without it the
    … …  
    49094909</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>root directory</code></em> = <code class="literal">/homes/smb</code>
    49104910</em></span>
    4911 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558147"></a>
     4911</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558406"></a>
    49124912
    49134913root postexec (S)
    4914 </h3></div></div></div><a class="indexterm" name="id2558148"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4914</h3></div></div></div><a class="indexterm" name="id2558407"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49154915        This is the same as the <em class="parameter"><code>postexec</code></em>
    49164916        parameter except that the command is run as root. This is useful for
    … …  
    49184918        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root postexec</code></em> = <code class="literal"></code>
    49194919</em></span>
    4920 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558196"></a>
     4920</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558454"></a>
    49214921
    49224922root preexec close (S)
    4923 </h3></div></div></div><a class="indexterm" name="id2558197"></a><a name="ROOTPREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the same as the <em class="parameter"><code>preexec close
     4923</h3></div></div></div><a class="indexterm" name="id2558455"></a><a name="ROOTPREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is the same as the <em class="parameter"><code>preexec close
    49244924        </code></em> parameter except that the command is run as root.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root preexec close</code></em> = <code class="literal">no</code>
    49254925</em></span>
    4926 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558244"></a>
     4926</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558503"></a>
    49274927
    49284928root preexec (S)
    4929 </h3></div></div></div><a class="indexterm" name="id2558246"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4929</h3></div></div></div><a class="indexterm" name="id2558504"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49304930        This is the same as the <em class="parameter"><code>preexec</code></em>
    49314931        parameter except that the command is run as root. This is useful for
    … …  
    49334933        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root preexec</code></em> = <code class="literal"></code>
    49344934</em></span>
    4935 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558293"></a>
     4935</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558551"></a>
    49364936
    49374937security mask (S)
    4938 </h3></div></div></div><a class="indexterm" name="id2558294"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4938</h3></div></div></div><a class="indexterm" name="id2558552"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49394939        This parameter controls what UNIX permission bits will be set when a Windows NT client is manipulating the
    49404940        UNIX permission on a file using the native NT security dialog box.
    … …  
    49554955</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security mask</code></em> = <code class="literal">0770</code>
    49564956</em></span>
    4957 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558399"></a>
     4957</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558658"></a>
    49584958
    49594959security (G)
    4960 </h3></div></div></div><a class="indexterm" name="id2558400"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
     4960</h3></div></div></div><a class="indexterm" name="id2558659"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
    49614961    Samba and is one of the most important settings in the <code class="filename">
    49624962    smb.conf</code> file.</p><p>The option sets the "security mode bit" in replies to
    … …  
    50825082</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security</code></em> = <code class="literal">DOMAIN</code>
    50835083</em></span>
    5084 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559284"></a>
     5084</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559542"></a>
    50855085
    50865086server schannel (G)
    5087 </h3></div></div></div><a class="indexterm" name="id2559285"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5087</h3></div></div></div><a class="indexterm" name="id2559543"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50885088        This controls whether the server offers or even demands the use of the netlogon schannel.
    50895089        <a class="link" href="smb.conf.5.html#SERVERSCHANNEL" target="_top">server schannel = no</a> does not offer the schannel, <a class="link" href="smb.conf.5.html#SERVERSCHANNEL" target="_top">server schannel = auto</a> offers the schannel but does not enforce it, and <a class="link" href="smb.conf.5.html#SERVERSCHANNEL" target="_top">server schannel = yes</a> denies access if the client is not able to speak netlogon schannel.
    … …  
    50965096</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server schannel</code></em> = <code class="literal">yes</code>
    50975097</em></span>
    5098 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559400"></a>
     5098</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559658"></a>
    50995099
    51005100server signing (G)
    5101 </h3></div></div></div><a class="indexterm" name="id2559401"></a><a name="SERVERSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
     5101</h3></div></div></div><a class="indexterm" name="id2559659"></a><a name="SERVERSIGNING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls whether the client is allowed or required to use SMB signing. Possible values
    51025102    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    51035103    and <span class="emphasis"><em>disabled</em></span>.
    … …  
    51065106        to disabled, SMB signing is not offered either.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>server signing</code></em> = <code class="literal">Disabled</code>
    51075107</em></span>
    5108 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559460"></a>
     5108</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559719"></a>
    51095109
    51105110server string (G)
    5111 </h3></div></div></div><a class="indexterm" name="id2559462"></a><a name="SERVERSTRING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what string will show up in the printer comment box in print
     5111</h3></div></div></div><a class="indexterm" name="id2559720"></a><a name="SERVERSTRING"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what string will show up in the printer comment box in print
    51125112        manager and next to the IPC connection in <code class="literal">net view</code>. It
    51135113        can be any string that you wish to show to your users.</p><p>It also sets what will appear in browse lists next
    … …  
    51185118</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server string</code></em> = <code class="literal">University of GNUs Samba Server</code>
    51195119</em></span>
    5120 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559552"></a>
     5120</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559810"></a>
    51215121
    51225122set directory (S)
    5123 </h3></div></div></div><a class="indexterm" name="id2559553"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5123</h3></div></div></div><a class="indexterm" name="id2559811"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51245124        If <code class="literal">set directory = no</code>, then        users of the
    51255125        service may not use the setdir command to change directory.
    … …  
    51305130        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>set directory</code></em> = <code class="literal">no</code>
    51315131</em></span>
    5132 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559612"></a>
     5132</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559870"></a>
    51335133
    51345134set primary group script (G)
    5135 </h3></div></div></div><a class="indexterm" name="id2559613"></a><a name="SETPRIMARYGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Thanks to the Posix subsystem in NT a Windows User has a
     5135</h3></div></div></div><a class="indexterm" name="id2559871"></a><a name="SETPRIMARYGROUPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>Thanks to the Posix subsystem in NT a Windows User has a
    51365136        primary group in addition to the auxiliary groups.  This script
    51375137        sets the primary group in the unix userdatase when an
    … …  
    51455145</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>set primary group script</code></em> = <code class="literal">/usr/sbin/usermod -g '%g' '%u'</code>
    51465146</em></span>
    5147 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559694"></a>
     5147</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559952"></a>
    51485148
    51495149set quota command (G)
    5150 </h3></div></div></div><a class="indexterm" name="id2559695"></a><a name="SETQUOTACOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The <code class="literal">set quota command</code> should only be used
     5150</h3></div></div></div><a class="indexterm" name="id2559953"></a><a name="SETQUOTACOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>The <code class="literal">set quota command</code> should only be used
    51515151        whenever there is no operating system API available from the OS that
    51525152        samba can use.</p><p>This option is only available if Samba was configured with the argument <code class="literal">--with-sys-quotas</code> or
    … …  
    51585158</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>set quota command</code></em> = <code class="literal">/usr/local/sbin/set_quota</code>
    51595159</em></span>
    5160 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559857"></a>
     5160</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560115"></a>
    51615161
    51625162share modes (S)
    5163 </h3></div></div></div><a class="indexterm" name="id2559858"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
     5163</h3></div></div></div><a class="indexterm" name="id2560116"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
    51645164        the <em class="parameter"><code>share modes</code></em> during a file open. These
    51655165        modes are used by clients to gain exclusive read or write access
    … …  
    51745174        off as many Windows applications will break if you do so.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>share modes</code></em> = <code class="literal">yes</code>
    51755175</em></span>
    5176 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559950"></a>
     5176</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560209"></a>
    51775177
    51785178short preserve case (S)
    5179 </h3></div></div></div><a class="indexterm" name="id2559952"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5179</h3></div></div></div><a class="indexterm" name="id2560210"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51805180        This boolean parameter controls if new files which conform to 8.3 syntax, that is all in upper case and of
    51815181        suitable length, are created upper case, or if they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE" target="_top">default case</a>.
    … …  
    51845184        </p><p>See the section on <a class="link" href="#NAMEMANGLINGSECT" title="NAME MANGLING">NAME MANGLING</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>short preserve case</code></em> = <code class="literal">yes</code>
    51855185</em></span>
    5186 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560030"></a>
     5186</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560289"></a>
    51875187
    51885188show add printer wizard (G)
    5189 </h3></div></div></div><a class="indexterm" name="id2560031"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
     5189</h3></div></div></div><a class="indexterm" name="id2560290"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
    51905190    for Windows NT/2000 client in Samba 2.2, a "Printers..." folder will
    51915191    appear on Samba hosts in the share listing.  Normally this folder will
    … …  
    52055205                administrative privilege on an individual printer.</p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>show add printer wizard</code></em> = <code class="literal">yes</code>
    52065206</em></span>
    5207 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560114"></a>
     5207</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560372"></a>
    52085208
    52095209shutdown script (G)
    5210 </h3></div></div></div><a class="indexterm" name="id2560115"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
     5210</h3></div></div></div><a class="indexterm" name="id2560373"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
    52115211         <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> that should
    52125212        start a shutdown procedure.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
    … …  
    52345234</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>shutdown script</code></em> = <code class="literal">/usr/local/samba/sbin/shutdown %m %t %r %f</code>
    52355235</em></span>
    5236 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560268"></a>
     5236</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560526"></a>
    52375237
    52385238smb encrypt (S)
    5239 </h3></div></div></div><a class="indexterm" name="id2560269"></a><a name="SMBENCRYPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a new feature introduced with Samba 3.2 and above. It is an
     5239</h3></div></div></div><a class="indexterm" name="id2560527"></a><a name="SMBENCRYPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a new feature introduced with Samba 3.2 and above. It is an
    52405240    extension to the SMB/CIFS protocol negotiated as part of the UNIX extensions.
    52415241    SMB encryption uses the GSSAPI (SSPI on Windows) ability to encrypt
    … …  
    52655265    to disabled, SMB encryption can not be negotiated.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb encrypt</code></em> = <code class="literal">auto</code>
    52665266</em></span>
    5267 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560374"></a>
     5267</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560632"></a>
    52685268
    52695269smb passwd file (G)
    5270 </h3></div></div></div><a class="indexterm" name="id2560375"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
     5270</h3></div></div></div><a class="indexterm" name="id2560633"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
    52715271    default the path to the smbpasswd file  is compiled into Samba.</p><p>
    52725272    An example of use is:
    … …  
    52765276    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb passwd file</code></em> = <code class="literal">${prefix}/private/smbpasswd</code>
    52775277</em></span>
    5278 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560428"></a>
     5278</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560686"></a>
    52795279
    52805280smb ports (G)
    5281 </h3></div></div></div><a class="indexterm" name="id2560429"></a><a name="SMBPORTS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies which ports the server should listen on for SMB traffic.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb ports</code></em> = <code class="literal">445 139</code>
    5282 </em></span>
    5283 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560469"></a>
     5281</h3></div></div></div><a class="indexterm" name="id2560687"></a><a name="SMBPORTS"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies which ports the server should listen on for SMB traffic.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb ports</code></em> = <code class="literal">445 139</code>
     5282</em></span>
     5283</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560728"></a>
    52845284
    52855285socket address (G)
    5286 </h3></div></div></div><a class="indexterm" name="id2560470"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
     5286</h3></div></div></div><a class="indexterm" name="id2560729"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
    52875287        address Samba will listen for connections on. This is used to
    52885288        support multiple virtual interfaces on the one server, each
    … …  
    52935293</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket address</code></em> = <code class="literal">192.168.2.20</code>
    52945294</em></span>
    5295 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560540"></a>
     5295</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560798"></a>
    52965296
    52975297socket options (G)
    5298 </h3></div></div></div><a class="indexterm" name="id2560541"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
     5298</h3></div></div></div><a class="indexterm" name="id2560799"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
    52995299    to be used when talking with the client.</p><p>Socket options are controls on the networking layer
    53005300    of the operating systems which allow the connection to be
    … …  
    53245324</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket options</code></em> = <code class="literal">IPTOS_LOWDELAY</code>
    53255325</em></span>
    5326 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560750"></a>
     5326</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561008"></a>
    53275327
    53285328stat cache (G)
    5329 </h3></div></div></div><a class="indexterm" name="id2560751"></a><a name="STATCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines if <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will use a cache in order to
     5329</h3></div></div></div><a class="indexterm" name="id2561009"></a><a name="STATCACHE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines if <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will use a cache in order to
    53305330        speed up case insensitive name mappings. You should never need
    53315331        to change this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>stat cache</code></em> = <code class="literal">yes</code>
    53325332</em></span>
    5333 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560801"></a>
     5333</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561060"></a>
    53345334
    53355335store dos attributes (S)
    5336 </h3></div></div></div><a class="indexterm" name="id2560802"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5336</h3></div></div></div><a class="indexterm" name="id2561061"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    53375337        If this parameter is set Samba attempts to first read DOS attributes (SYSTEM, HIDDEN, ARCHIVE or
    53385338        READ-ONLY) from a filesystem extended attribute, before mapping DOS attributes to UNIX permission bits (such
    … …  
    53465346        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>store dos attributes</code></em> = <code class="literal">no</code>
    53475347</em></span>
    5348 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560923"></a>
     5348</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561181"></a>
    53495349
    53505350strict allocate (S)
    5351 </h3></div></div></div><a class="indexterm" name="id2560924"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
     5351</h3></div></div></div><a class="indexterm" name="id2561182"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
    53525352    disk space allocation in the server. When this is set to <code class="constant">yes</code>
    53535353    the server will change from UNIX behaviour of not committing real
    … …  
    53615361    of users.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict allocate</code></em> = <code class="literal">no</code>
    53625362</em></span>
    5363 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560993"></a>
     5363</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561252"></a>
    53645364
    53655365strict locking (S)
    5366 </h3></div></div></div><a class="indexterm" name="id2560994"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5366</h3></div></div></div><a class="indexterm" name="id2561253"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    53675367        This is an enumerated type that controls the handling of file locking in the server. When this is set to <code class="constant">yes</code>,
    53685368        the server will check every read and write access for file locks, and deny access if locks exist. This can be slow on
    … …  
    53805380        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict locking</code></em> = <code class="literal">Auto</code>
    53815381</em></span>
    5382 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561073"></a>
     5382</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561331"></a>
    53835383
    53845384strict sync (S)
    5385 </h3></div></div></div><a class="indexterm" name="id2561074"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
     5385</h3></div></div></div><a class="indexterm" name="id2561332"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
    53865386    shell) seem to confuse flushing buffer contents to disk with doing
    53875387    a sync to disk. Under UNIX, a sync call forces the process to be
    … …  
    53975397    reported with the new Windows98 explorer shell file copies.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict sync</code></em> = <code class="literal">no</code>
    53985398</em></span>
    5399 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561138"></a>
     5399</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561396"></a>
    54005400
    54015401svcctl list (G)
    5402 </h3></div></div></div><a class="indexterm" name="id2561139"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
     5402</h3></div></div></div><a class="indexterm" name="id2561397"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
    54035403    will use for starting and stopping Unix services via the Win32
    54045404    ServiceControl API.  This allows Windows administrators to
    … …  
    54135413</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>svcctl list</code></em> = <code class="literal">cups postfix portmap httpd</code>
    54145414</em></span>
    5415 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561223"></a>
     5415</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561481"></a>
    54165416
    54175417sync always (S)
    5418 </h3></div></div></div><a class="indexterm" name="id2561224"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
     5418</h3></div></div></div><a class="indexterm" name="id2561482"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
    54195419    whether writes will always be written to stable storage before
    54205420    the write call returns. If this is <code class="constant">no</code> then the server will be
    … …  
    54275427    any affect.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>sync always</code></em> = <code class="literal">no</code>
    54285428</em></span>
    5429 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561294"></a>
     5429</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561552"></a>
    54305430
    54315431syslog only (G)
    5432 </h3></div></div></div><a class="indexterm" name="id2561295"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5432</h3></div></div></div><a class="indexterm" name="id2561553"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54335433    If this parameter is set then Samba debug messages are logged into the system
    54345434    syslog only, and not to the debug log files. There still will be some
    … …  
    54365436    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog only</code></em> = <code class="literal">no</code>
    54375437</em></span>
    5438 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561341"></a>
     5438</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561600"></a>
    54395439
    54405440syslog (G)
    5441 </h3></div></div></div><a class="indexterm" name="id2561342"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5441</h3></div></div></div><a class="indexterm" name="id2561601"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54425442    This parameter maps how Samba debug messages are logged onto the system syslog logging levels.
    54435443    Samba debug level zero maps onto syslog <code class="constant">LOG_ERR</code>, debug level one maps onto
    … …  
    54505450    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog</code></em> = <code class="literal">1</code>
    54515451</em></span>
    5452 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561412"></a>
     5452</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561670"></a>
    54535453
    54545454template homedir (G)
    5455 </h3></div></div></div><a class="indexterm" name="id2561413"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5455</h3></div></div></div><a class="indexterm" name="id2561671"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    54565456        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon  uses this
    54575457        parameter to fill in the home directory for that user. If the
    … …  
    54615461        is substituted with the user's Windows  NT user name.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>template homedir</code></em> = <code class="literal">/home/%D/%U</code>
    54625462</em></span>
    5463 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561477"></a>
     5463</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561736"></a>
    54645464
    54655465template shell (G)
    5466 </h3></div></div></div><a class="indexterm" name="id2561478"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5466</h3></div></div></div><a class="indexterm" name="id2561737"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    54675467        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon uses this
    5468         parameter to fill in the login shell for that user.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561517"></a>
     5468        parameter to fill in the login shell for that user.</p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561775"></a>
    54695469
    54705470time offset (G)
    5471 </h3></div></div></div><a class="indexterm" name="id2561518"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
     5471</h3></div></div></div><a class="indexterm" name="id2561776"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
    54725472        to the normal GMT to local time conversion. This is useful if
    54735473        you are serving a lot of PCs that have incorrect daylight
    … …  
    54765476</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>time offset</code></em> = <code class="literal">60</code>
    54775477</em></span>
    5478 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561577"></a>
     5478</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561835"></a>
    54795479
    54805480time server (G)
    5481 </h3></div></div></div><a class="indexterm" name="id2561578"></a><a name="TIMESERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> advertises itself as a time server to Windows
     5481</h3></div></div></div><a class="indexterm" name="id2561836"></a><a name="TIMESERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter determines if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> advertises itself as a time server to Windows
    54825482clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>time server</code></em> = <code class="literal">no</code>
    54835483</em></span>
    5484 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561627"></a>
     5484</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561885"></a>
    54855485
    54865486unix charset (G)
    5487 </h3></div></div></div><a class="indexterm" name="id2561628"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
     5487</h3></div></div></div><a class="indexterm" name="id2561886"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
    54885488                Samba runs on uses. Samba needs to know this in order to be able to
    54895489                convert text to the charsets other SMB clients use.
    … …  
    54945494</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>unix charset</code></em> = <code class="literal">ASCII</code>
    54955495</em></span>
    5496 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561693"></a>
     5496</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561951"></a>
    54975497
    54985498unix extensions (G)
    5499 </h3></div></div></div><a class="indexterm" name="id2561694"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5499</h3></div></div></div><a class="indexterm" name="id2561952"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    55005500    implements the CIFS UNIX extensions, as defined by HP.
    55015501    These extensions enable Samba to better serve UNIX CIFS clients
    … …  
    55045504    no current use to Windows clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>unix extensions</code></em> = <code class="literal">yes</code>
    55055505</em></span>
    5506 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561740"></a>
     5506</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561999"></a>
    55075507
    55085508unix password sync (G)
    5509 </h3></div></div></div><a class="indexterm" name="id2561741"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5509</h3></div></div></div><a class="indexterm" name="id2562000"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    55105510    attempts to synchronize the UNIX password with the SMB password
    55115511    when the encrypted SMB password in the smbpasswd file is changed.
    … …  
    55165516        access to the old password cleartext, only the new).</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>unix password sync</code></em> = <code class="literal">no</code>
    55175517</em></span>
    5518 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561801"></a>
     5518</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562060"></a>
    55195519
    55205520update encrypted (G)
    5521 </h3></div></div></div><a class="indexterm" name="id2561802"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5521</h3></div></div></div><a class="indexterm" name="id2562061"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    55225522        This boolean parameter allows a user logging on with a plaintext password to have their encrypted (hashed)
    55235523        password in the smbpasswd file to be updated automatically as they log on. This option allows a site to
    … …  
    55375537        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>update encrypted</code></em> = <code class="literal">no</code>
    55385538</em></span>
    5539 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561920"></a>
     5539</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562178"></a>
    55405540
    55415541use client driver (S)
    5542 </h3></div></div></div><a class="indexterm" name="id2561921"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
     5542</h3></div></div></div><a class="indexterm" name="id2562179"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
    55435543    clients.  It has no effect on Windows 95/98/ME clients.  When
    55445544    serving a printer to Windows NT/2000 clients without first installing
    … …  
    55655565        server.</em></span></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use client driver</code></em> = <code class="literal">no</code>
    55665566</em></span>
    5567 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562001"></a>
     5567</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562259"></a>
    55685568
    55695569use kerberos keytab (G)
    5570 </h3></div></div></div><a class="indexterm" name="id2562002"></a><a name="USEKERBEROSKEYTAB"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5570</h3></div></div></div><a class="indexterm" name="id2562260"></a><a name="USEKERBEROSKEYTAB"></a><div class="variablelist"><dl><dt></dt><dd><p>
    55715571        Specifies whether Samba should attempt to maintain service principals in the systems
    55725572        keytab file for <code class="constant">host/FQDN</code> and <code class="constant">cifs/FQDN</code>.
    … …  
    55805580        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use kerberos keytab</code></em> = <code class="literal">False</code>
    55815581</em></span>
    5582 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562069"></a>
     5582</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562327"></a>
    55835583
    55845584use mmap (G)
    5585 </h3></div></div></div><a class="indexterm" name="id2562070"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
     5585</h3></div></div></div><a class="indexterm" name="id2562328"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
    55865586    depend on mmap working correctly on the running system. Samba requires a coherent
    55875587    mmap/read-write system memory cache. Currently only HPUX does not have such a
    … …  
    55925592    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use mmap</code></em> = <code class="literal">yes</code>
    55935593</em></span>
    5594 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562121"></a>
     5594</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562379"></a>
    55955595
    55965596username level (G)
    5597 </h3></div></div></div><a class="indexterm" name="id2562122"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
     5597</h3></div></div></div><a class="indexterm" name="id2562380"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
    55985598    the real UNIX username, as many DOS clients send an all-uppercase
    55995599    username. By default Samba tries all lowercase, followed by the
    … …  
    56105610</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username level</code></em> = <code class="literal">5</code>
    56115611</em></span>
    5612 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562203"></a>
     5612</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562461"></a>
    56135613
    56145614username map script (G)
    5615 </h3></div></div></div><a class="indexterm" name="id2562204"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
     5615</h3></div></div></div><a class="indexterm" name="id2562462"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
    56165616        <a class="link" href="smb.conf.5.html#USERNAMEMAP" target="_top">username map</a> parameter.  This parameter
    56175617        specifies and external program or script that must accept a single
    … …  
    56245624</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username map script</code></em> = <code class="literal">/etc/samba/scripts/mapusers.sh</code>
    56255625</em></span>
    5626 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562280"></a>
     5626</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562538"></a>
    56275627
    56285628username map (G)
    5629 </h3></div></div></div><a class="indexterm" name="id2562281"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5629</h3></div></div></div><a class="indexterm" name="id2562539"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    56305630        This option allows you to specify a file containing a mapping of usernames from the clients to the server.
    56315631        This can be used for several purposes. The most common is to map usernames that users use on DOS or Windows
    … …  
    57115711# no username map</code>
    57125712</em></span>
    5713 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562560"></a>
     5713</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562818"></a>
    57145714
    57155715<a name="USER"></a>user
    5716 </h3></div></div></div><a class="indexterm" name="id2562561"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#USERNAME">username</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562592"></a>
     5716</h3></div></div></div><a class="indexterm" name="id2562819"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#USERNAME">username</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562850"></a>
    57175717
    57185718<a name="USERS"></a>users
    5719 </h3></div></div></div><a class="indexterm" name="id2562593"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#USERNAME">username</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562623"></a>
     5719</h3></div></div></div><a class="indexterm" name="id2562851"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#USERNAME">username</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562882"></a>
    57205720
    57215721username (S)
    5722 </h3></div></div></div><a class="indexterm" name="id2562624"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
     5722</h3></div></div></div><a class="indexterm" name="id2562883"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
    57235723    list, in which case the supplied password will be tested against
    57245724    each username in turn (left to right).</p><p>The <em class="parameter"><code>username</code></em> line is needed only when
    … …  
    57585758</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username</code></em> = <code class="literal">fred, mary, jack, jane, @users, @pcgroup</code>
    57595759</em></span>
    5760 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562794"></a>
     5760</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563052"></a>
    57615761
    57625762usershare allow guests (G)
    5763 </h3></div></div></div><a class="indexterm" name="id2562795"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
     5763</h3></div></div></div><a class="indexterm" name="id2563053"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
    57645764        to be accessed by non-authenticated users or not. It is the equivalent
    57655765        of allowing people who can create a share the option of setting
    … …  
    57685768        is set to off.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare allow guests</code></em> = <code class="literal">no</code>
    57695769</em></span>
    5770 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562846"></a>
     5770</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563104"></a>
    57715771
    57725772usershare max shares (G)
    5773 </h3></div></div></div><a class="indexterm" name="id2562847"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
     5773</h3></div></div></div><a class="indexterm" name="id2563105"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
    57745774        that are allowed to be created by users belonging to the group owning the
    57755775        usershare directory. If set to zero (the default) user defined shares are ignored.
    57765776        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare max shares</code></em> = <code class="literal">0</code>
    57775777</em></span>
    5778 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562892"></a>
     5778</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563150"></a>
    57795779
    57805780usershare owner only (G)
    5781 </h3></div></div></div><a class="indexterm" name="id2562893"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
     5781</h3></div></div></div><a class="indexterm" name="id2563151"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
    57825782        a user defined shares must be owned by the user creating the
    57835783        user defined share or not. If set to True (the default) then
    … …  
    57895789        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare owner only</code></em> = <code class="literal">True</code>
    57905790</em></span>
    5791 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562941"></a>
     5791</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563207"></a>
    57925792
    57935793usershare path (G)
    5794 </h3></div></div></div><a class="indexterm" name="id2562942"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
     5794</h3></div></div></div><a class="indexterm" name="id2563208"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
    57955795        filesystem used to store the user defined share definition files.
    57965796        This directory must be owned by root, and have no access for
    … …  
    58135813        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare path</code></em> = <code class="literal">NULL</code>
    58145814</em></span>
    5815 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563012"></a>
     5815</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563278"></a>
    58165816
    58175817usershare prefix allow list (G)
    5818 </h3></div></div></div><a class="indexterm" name="id2563013"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     5818</h3></div></div></div><a class="indexterm" name="id2563279"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    58195819        the root of which are allowed to be exported by user defined share definitions.
    58205820        If the pathname to be exported doesn't start with one of the strings in this
    … …  
    58315831</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix allow list</code></em> = <code class="literal">/home /data /space</code>
    58325832</em></span>
    5833 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563085"></a>
     5833</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563351"></a>
    58345834
    58355835usershare prefix deny list (G)
    5836 </h3></div></div></div><a class="indexterm" name="id2563086"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     5836</h3></div></div></div><a class="indexterm" name="id2563352"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    58375837        the root of which are NOT allowed to be exported by user defined share definitions.
    58385838        If the pathname exported starts with one of the strings in this
    … …  
    58505850</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix deny list</code></em> = <code class="literal">/etc /dev /private</code>
    58515851</em></span>
    5852 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563159"></a>
     5852</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563425"></a>
    58535853
    58545854usershare template share (G)
    5855 </h3></div></div></div><a class="indexterm" name="id2563160"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
     5855</h3></div></div></div><a class="indexterm" name="id2563426"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
    58565856        such as path, guest ok, etc. This parameter allows usershares to
    58575857        "cloned" from an existing share. If "usershare template share"
    … …  
    58685868</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare template share</code></em> = <code class="literal">template_share</code>
    58695869</em></span>
    5870 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563232"></a>
     5870</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563498"></a>
    58715871
    58725872use sendfile (S)
    5873 </h3></div></div></div><a class="indexterm" name="id2563234"></a><a name="USESENDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, and the <code class="constant">sendfile()</code>
     5873</h3></div></div></div><a class="indexterm" name="id2563500"></a><a name="USESENDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, and the <code class="constant">sendfile()</code>
    58745874    system call is supported by the underlying operating system, then some SMB read calls
    58755875    (mainly ReadAndX and ReadRaw) will use the more efficient sendfile system call for files that
    … …  
    58805880    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use sendfile</code></em> = <code class="literal">false</code>
    58815881</em></span>
    5882 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563290"></a>
     5882</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563556"></a>
    58835883
    58845884use spnego (G)
    5885 </h3></div></div></div><a class="indexterm" name="id2563291"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
     5885</h3></div></div></div><a class="indexterm" name="id2563557"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
    58865886    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    58875887    WindowsXP and Windows2000 clients to agree upon an authentication mechanism.
    … …  
    58915891        disabled.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use spnego</code></em> = <code class="literal">yes</code>
    58925892</em></span>
    5893 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563340"></a>
     5893</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563606"></a>
    58945894
    58955895utmp directory (G)
    5896 </h3></div></div></div><a class="indexterm" name="id2563341"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
     5896</h3></div></div></div><a class="indexterm" name="id2563607"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
    58975897        been configured and compiled with the option <code class="literal">
    58985898        --with-utmp</code>. It specifies a directory pathname that is
    … …  
    59065906</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>utmp directory</code></em> = <code class="literal">/var/run/utmp</code>
    59075907</em></span>
    5908 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563418"></a>
     5908</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563684"></a>
    59095909
    59105910utmp (G)
    5911 </h3></div></div></div><a class="indexterm" name="id2563419"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5911</h3></div></div></div><a class="indexterm" name="id2563685"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59125912        This boolean parameter is only available if Samba has been configured and compiled 
    59135913        with the option <code class="literal">--with-utmp</code>. If set to
    … …  
    59215921        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>utmp</code></em> = <code class="literal">no</code>
    59225922</em></span>
    5923 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563480"></a>
     5923</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563746"></a>
    59245924
    59255925valid users (S)
    5926 </h3></div></div></div><a class="indexterm" name="id2563481"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5926</h3></div></div></div><a class="indexterm" name="id2563747"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59275927    This is a list of users that should be allowed to login to this service. Names starting with
    59285928    '@', '+' and  '&amp;' are interpreted using the same rules as described in the
    … …  
    59405940</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>valid users</code></em> = <code class="literal">greg, @pcusers</code>
    59415941</em></span>
    5942 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563572"></a>
     5942</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563838"></a>
    59435943
    59445944-valid (S)
    5945 </h3></div></div></div><a class="indexterm" name="id2563573"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
     5945</h3></div></div></div><a class="indexterm" name="id2563839"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
    59465946        valid and thus can be used. When this parameter is set to false,
    59475947        the share will be in no way visible nor accessible.
    … …  
    59525952        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>-valid</code></em> = <code class="literal">yes</code>
    59535953</em></span>
    5954 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563621"></a>
     5954</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563887"></a>
    59555955
    59565956veto files (S)
    5957 </h3></div></div></div><a class="indexterm" name="id2563622"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5957</h3></div></div></div><a class="indexterm" name="id2563888"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59585958        This is a list of files and directories that are neither visible nor accessible.  Each entry in
    59595959        the list must be separated by a '/', which allows spaces to be included in the entry. '*' and '?'
    … …  
    59865986        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>veto files</code></em> = <code class="literal">No files or directories are vetoed.</code>
    59875987</em></span>
    5988 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563740"></a>
     5988</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564006"></a>
    59895989
    59905990veto oplock files (S)
    5991 </h3></div></div></div><a class="indexterm" name="id2563741"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5991</h3></div></div></div><a class="indexterm" name="id2564007"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59925992        This parameter is only valid when the <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
    59935993        parameter is turned on for a share. It allows the Samba administrator
    … …  
    60106010# No files are vetoed for oplock grants</code>
    60116011</em></span>
    6012 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563833"></a>
     6012</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564099"></a>
    60136013
    60146014<a name="VFSOBJECT"></a>vfs object
    6015 </h3></div></div></div><a class="indexterm" name="id2563834"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#VFSOBJECTS">vfs objects</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563865"></a>
     6015</h3></div></div></div><a class="indexterm" name="id2564100"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#VFSOBJECTS">vfs objects</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564131"></a>
    60166016
    60176017vfs objects (S)
    6018 </h3></div></div></div><a class="indexterm" name="id2563866"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
     6018</h3></div></div></div><a class="indexterm" name="id2564132"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
    60196019        are used for Samba VFS I/O operations.  By default, normal
    60206020        disk I/O operations are used but these can be overloaded
    … …  
    60236023</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>vfs objects</code></em> = <code class="literal">extd_audit recycle</code>
    60246024</em></span>
    6025 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563925"></a>
     6025</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564191"></a>
    60266026
    60276027volume (S)
    6028 </h3></div></div></div><a class="indexterm" name="id2563926"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
     6028</h3></div></div></div><a class="indexterm" name="id2564192"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
    60296029        returned for a share. Useful for CDROMs with installation programs
    60306030        that insist on a particular volume label.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>volume</code></em> = <code class="literal">
    60316031# the name of the share</code>
    60326032</em></span>
    6033 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563969"></a>
     6033</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564235"></a>
    60346034
    60356035wide links (S)
    6036 </h3></div></div></div><a class="indexterm" name="id2563970"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
     6036</h3></div></div></div><a class="indexterm" name="id2564236"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
    60376037        in the UNIX file system may be followed by the server. Links
    60386038        that point to areas within the directory tree exported by the
    … …  
    60426042        that Samba has to  do in order to perform the link checks.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>wide links</code></em> = <code class="literal">yes</code>
    60436043</em></span>
    6044 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564021"></a>
     6044</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564287"></a>
    60456045
    60466046winbind cache time (G)
    6047 </h3></div></div></div><a class="indexterm" name="id2564022"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
     6047</h3></div></div></div><a class="indexterm" name="id2564288"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
    60486048        seconds the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon will cache
    60496049        user and group information before querying a Windows NT server
    … …  
    60536053        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind cache time</code></em> = <code class="literal">300</code>
    60546054</em></span>
    6055 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564093"></a>
     6055</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564359"></a>
    60566056
    60576057winbind enum groups (G)
    6058 </h3></div></div></div><a class="indexterm" name="id2564094"></a><a name="WINBINDENUMGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>On large installations using <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> it may be necessary to suppress
     6058</h3></div></div></div><a class="indexterm" name="id2564360"></a><a name="WINBINDENUMGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>On large installations using <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> it may be necessary to suppress
    60596059        the enumeration of groups through the <code class="literal">setgrent()</code>,
    60606060        <code class="literal">getgrent()</code> and
    … …  
    60646064        call will not return any data. </p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>Turning off group enumeration may cause some programs to behave oddly.  </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind enum groups</code></em> = <code class="literal">no</code>
    60656065</em></span>
    6066 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564183"></a>
     6066</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564449"></a>
    60676067
    60686068winbind enum users (G)
    6069 </h3></div></div></div><a class="indexterm" name="id2564184"></a><a name="WINBINDENUMUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>On large installations using <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> it may be
     6069</h3></div></div></div><a class="indexterm" name="id2564450"></a><a name="WINBINDENUMUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>On large installations using <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> it may be
    60706070        necessary to suppress the enumeration of users through the <code class="literal">setpwent()</code>,
    60716071         <code class="literal">getpwent()</code> and
    … …  
    60796079        usernames. </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind enum users</code></em> = <code class="literal">no</code>
    60806080</em></span>
    6081 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564277"></a>
     6081</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564543"></a>
    60826082
    60836083winbind expand groups (G)
    6084 </h3></div></div></div><a class="indexterm" name="id2564278"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
     6084</h3></div></div></div><a class="indexterm" name="id2564544"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
    60856085              will traverse when flattening nested group memberships
    60866086              of Windows domain groups.  This is different from the
    … …  
    60946094         incoming NSS or authentication requests during this time.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind expand groups</code></em> = <code class="literal">1</code>
    60956095</em></span>
    6096 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564345"></a>
     6096</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564611"></a>
    60976097
    60986098winbind nested groups (G)
    6099 </h3></div></div></div><a class="indexterm" name="id2564346"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
     6099</h3></div></div></div><a class="indexterm" name="id2564612"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
    61006100                 groups. Nested groups are also called local groups or
    61016101                 aliases. They work like their counterparts in Windows: Nested
    … …  
    61056105                 groups, you need to run nss_winbind.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind nested groups</code></em> = <code class="literal">yes</code>
    61066106</em></span>
    6107 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564396"></a>
     6107</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564661"></a>
    61086108
    61096109winbind normalize names (G)
    6110 </h3></div></div></div><a class="indexterm" name="id2564397"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
     6110</h3></div></div></div><a class="indexterm" name="id2564662"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
    61116111        whitespace in user and group names with an underscore (_) character.
    61126112        For example, whether the name "Space Kadet" should be
    … …  
    61206120</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind normalize names</code></em> = <code class="literal">yes</code>
    61216121</em></span>
    6122 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564461"></a>
     6122</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564728"></a>
    61236123
    61246124winbind nss info (G)
    6125 </h3></div></div></div><a class="indexterm" name="id2564462"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
     6125</h3></div></div></div><a class="indexterm" name="id2564729"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
    61266126        Service Information to construct a user's home directory and login shell.
    61276127        Currently the following settings are available:
    … …  
    61456145</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind nss info</code></em> = <code class="literal">template sfu</code>
    61466146</em></span>
    6147 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564581"></a>
     6147</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564847"></a>
    61486148
    61496149winbind offline logon (G)
    6150 </h3></div></div></div><a class="indexterm" name="id2564582"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
     6150</h3></div></div></div><a class="indexterm" name="id2564848"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
    61516151        allow to login with the <em class="parameter"><code>pam_winbind</code></em>
    61526152        module using Cached Credentials. If enabled, winbindd will store user credentials
    … …  
    61566156</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind offline logon</code></em> = <code class="literal">true</code>
    61576157</em></span>
    6158 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564650"></a>
     6158</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564916"></a>
    61596159
    61606160winbind refresh tickets (G)
    6161 </h3></div></div></div><a class="indexterm" name="id2564651"></a><a name="WINBINDREFRESHTICKETS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should refresh Kerberos Tickets
     6161</h3></div></div></div><a class="indexterm" name="id2564917"></a><a name="WINBINDREFRESHTICKETS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should refresh Kerberos Tickets
    61626162        retrieved using the <em class="parameter"><code>pam_winbind</code></em> module.
    61636163
    … …  
    61666166</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind refresh tickets</code></em> = <code class="literal">true</code>
    61676167</em></span>
    6168 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564717"></a>
     6168</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564983"></a>
    61696169
    61706170winbind rpc only (G)
    6171 </h3></div></div></div><a class="indexterm" name="id2564718"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6171</h3></div></div></div><a class="indexterm" name="id2564984"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    61726172        Setting this parameter to <code class="literal">yes</code> forces
    61736173        winbindd to use RPC instead of LDAP to retrieve information from Domain
    … …  
    61756175        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind rpc only</code></em> = <code class="literal">no</code>
    61766176</em></span>
    6177 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564765"></a>
     6177</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565032"></a>
    61786178
    61796179winbind separator (G)
    6180 </h3></div></div></div><a class="indexterm" name="id2564766"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
     6180</h3></div></div></div><a class="indexterm" name="id2565033"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
    61816181        used when listing a username of the form of <em class="replaceable"><code>DOMAIN
    61826182        </code></em>\<em class="replaceable"><code>user</code></em>.  This parameter
    … …  
    61896189</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind separator</code></em> = <code class="literal">+</code>
    61906190</em></span>
    6191 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564853"></a>
     6191</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565119"></a>
    61926192
    61936193winbind trusted domains only (G)
    6194 </h3></div></div></div><a class="indexterm" name="id2564854"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6194</h3></div></div></div><a class="indexterm" name="id2565120"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    61956195        This parameter is designed to allow Samba servers that are members
    61966196        of a Samba controlled domain to use UNIX accounts distributed via NIS,
    … …  
    62046204        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind trusted domains only</code></em> = <code class="literal">no</code>
    62056205</em></span>
    6206 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564932"></a>
     6206</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565198"></a>
    62076207
    62086208winbind use default domain (G)
    6209 </h3></div></div></div><a class="indexterm" name="id2564933"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
     6209</h3></div></div></div><a class="indexterm" name="id2565199"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
    62106210         <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon should operate on users 
    62116211        without domain component in their username. Users without a domain
    … …  
    62176217</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind use default domain</code></em> = <code class="literal">yes</code>
    62186218</em></span>
    6219 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565004"></a>
     6219</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565270"></a>
    62206220
    62216221wins hook (G)
    6222 </h3></div></div></div><a class="indexterm" name="id2565005"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
     6222</h3></div></div></div><a class="indexterm" name="id2565272"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
    62236223        allows you to call an external program for all changes to the
    62246224        WINS database. The primary use for this option is to allow the
    … …  
    62416241                        empty then the name should be deleted.</p></li></ul></div><p>An example script that calls the BIND dynamic DNS update
    62426242        program <code class="literal">nsupdate</code> is provided in the examples
    6243         directory of the Samba source code. </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565111"></a>
     6243        directory of the Samba source code. </p><p><span class="emphasis"><em>No default</em></span></p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565377"></a>
    62446244
    62456245wins proxy (G)
    6246 </h3></div></div></div><a class="indexterm" name="id2565112"></a><a name="WINSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> will respond to broadcast name
     6246</h3></div></div></div><a class="indexterm" name="id2565378"></a><a name="WINSPROXY"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls if <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> will respond to broadcast name
    62476247        queries on behalf of  other hosts. You may need to set this
    62486248        to <code class="constant">yes</code> for some older clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>wins proxy</code></em> = <code class="literal">no</code>
    62496249</em></span>
    6250 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565166"></a>
     6250</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565432"></a>
    62516251
    62526252wins server (G)
    6253 </h3></div></div></div><a class="indexterm" name="id2565167"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
     6253</h3></div></div></div><a class="indexterm" name="id2565433"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
    62546254        address for preference) of the WINS server that <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> should register with. If you have a WINS server on
    62556255        your network then you should set this to the WINS server's IP.</p><p>You should point this at your WINS server if you have a
    … …  
    62706270</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>wins server</code></em> = <code class="literal">192.9.200.1 192.168.2.61</code>
    62716271</em></span>
    6272 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565276"></a>
     6272</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565542"></a>
    62736273
    62746274wins support (G)
    6275 </h3></div></div></div><a class="indexterm" name="id2565277"></a><a name="WINSSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls if the <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> process in Samba will act as a WINS server. You should
     6275</h3></div></div></div><a class="indexterm" name="id2565543"></a><a name="WINSSUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean controls if the <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> process in Samba will act as a WINS server. You should
    62766276        not set this to <code class="constant">yes</code> unless you have a multi-subnetted network and
    62776277        you wish a particular <code class="literal">nmbd</code> to be your WINS server.
    … …  
    62796279        on more than one machine in your network.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>wins support</code></em> = <code class="literal">no</code>
    62806280</em></span>
    6281 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565345"></a>
     6281</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565612"></a>
    62826282
    62836283workgroup (G)
    6284 </h3></div></div></div><a class="indexterm" name="id2565346"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
     6284</h3></div></div></div><a class="indexterm" name="id2565613"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
    62856285        appear to be in when queried by clients. Note that this parameter
    62866286        also controls the Domain name used with
    … …  
    62906290</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>workgroup</code></em> = <code class="literal">MYGROUP</code>
    62916291</em></span>
    6292 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565418"></a>
     6292</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565684"></a>
    62936293
    62946294<a name="WRITABLE"></a>writable
    6295 </h3></div></div></div><a class="indexterm" name="id2565419"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#WRITEABLE">writeable</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565449"></a>
     6295</h3></div></div></div><a class="indexterm" name="id2565685"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a synonym for <a class="link" href="#WRITEABLE">writeable</a>.</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565715"></a>
    62966296
    62976297writeable (S)
    6298 </h3></div></div></div><a class="indexterm" name="id2565450"></a><a name="WRITEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>Inverted synonym for <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>writeable</code></em> = <code class="literal">no</code>
    6299 </em></span>
    6300 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565500"></a>
     6298</h3></div></div></div><a class="indexterm" name="id2565716"></a><a name="WRITEABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>Inverted synonym for <a class="link" href="smb.conf.5.html#READONLY" target="_top">read only</a>.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>writeable</code></em> = <code class="literal">no</code>
     6299</em></span>
     6300</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565766"></a>
    63016301
    63026302write cache size (S)
    6303 </h3></div></div></div><a class="indexterm" name="id2565501"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
     6303</h3></div></div></div><a class="indexterm" name="id2565768"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
    63046304    Samba will create an in-memory cache for each oplocked file
    63056305    (it does <span class="emphasis"><em>not</em></span> do this for
    … …  
    63196319#  for a 256k cache size per file</code>
    63206320</em></span>
    6321 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565584"></a>
     6321</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565850"></a>
    63226322
    63236323write list (S)
    6324 </h3></div></div></div><a class="indexterm" name="id2565585"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6324</h3></div></div></div><a class="indexterm" name="id2565851"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    63256325    This is a list of users that are given read-write access to a service. If the
    63266326    connecting user is in this list then they will be given write access, no matter
    … …  
    63376337</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>write list</code></em> = <code class="literal">admin, root, @staff</code>
    63386338</em></span>
    6339 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565677"></a>
     6339</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565943"></a>
    63406340
    63416341write raw (G)
    6342 </h3></div></div></div><a class="indexterm" name="id2565678"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     6342</h3></div></div></div><a class="indexterm" name="id2565944"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    63436343    will support raw write SMB's when transferring data from clients.
    63446344    You should never need to change this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>write raw</code></em> = <code class="literal">yes</code>
    63456345</em></span>
    6346 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565721"></a>
     6346</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565987"></a>
    63476347
    63486348wtmp directory (G)
    6349 </h3></div></div></div><a class="indexterm" name="id2565722"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6349</h3></div></div></div><a class="indexterm" name="id2565988"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    63506350        This parameter is only available if Samba has been configured and compiled with the option <code class="literal">
    63516351        --with-utmp</code>. It specifies a directory pathname that is used to store the wtmp or wtmpx files (depending on
    … …  
    63596359</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>wtmp directory</code></em> = <code class="literal">/var/log/wtmp</code>
    63606360</em></span>
    6361 </p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id2565805"></a><h2>WARNINGS</h2><p>
     6361</p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id2566071"></a><h2>WARNINGS</h2><p>
    63626362        Although the configuration file permits service names to contain spaces, your client software may not.
    63636363        Spaces will be ignored in comparisons anyway, so it shouldn't be a problem - but be aware of the possibility.
    … …  
    63726372        care when designing these sections. In particular, ensure that the permissions on spool directories are
    63736373        correct.
    6374         </p></div><div class="refsect1" lang="en"><a name="id2565855"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2565866"></a><h2>SEE ALSO</h2><p>
    6375         <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>, <a class="citerefentry" href="swat.8.html"><span class="citerefentry"><span class="refentrytitle">swat</span>(8)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>.</p></div><div class="refsect1" lang="en"><a name="id2565945"></a><h2>AUTHOR</h2><p>
     6374        </p></div><div class="refsect1" lang="en"><a name="id2566121"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2566132"></a><h2>SEE ALSO</h2><p>
     6375        <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a>, <a class="citerefentry" href="smbpasswd.8.html"><span class="citerefentry"><span class="refentrytitle">smbpasswd</span>(8)</span></a>, <a class="citerefentry" href="swat.8.html"><span class="citerefentry"><span class="refentrytitle">swat</span>(8)</span></a>, <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>, <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a>, <a class="citerefentry" href="smbclient.1.html"><span class="citerefentry"><span class="refentrytitle">smbclient</span>(1)</span></a>, <a class="citerefentry" href="nmblookup.1.html"><span class="citerefentry"><span class="refentrytitle">nmblookup</span>(1)</span></a>, <a class="citerefentry" href="testparm.1.html"><span class="citerefentry"><span class="refentrytitle">testparm</span>(1)</span></a>, <a class="citerefentry" href="testprns.1.html"><span class="citerefentry"><span class="refentrytitle">testprns</span>(1)</span></a>.</p></div><div class="refsect1" lang="en"><a name="id2566211"></a><h2>AUTHOR</h2><p>
    63766376        The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed
    63776377        by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.
Note: See TracChangeset for help on using the changeset viewer.