Ignore:
Timestamp:
Apr 9, 2010, 3:20:58 PM (15 years ago)
Author:
Silvan Scherrer
Message:

Samba 3.5.x: update to 3.5.2

Location:
vendor/current/docs/htmldocs/manpages
Files:
8 edited

Legend:

Unmodified
Added
Removed
  • vendor/current/docs/htmldocs/manpages/eventlogadm.8.html

    r414 r427  
    3636                </p></dd><dt><span class="term">
    3737                <code class="option">-o</code>
    38                 <code class="literal">write</code>
     38                <code class="literal">dump</code>
    3939                <em class="replaceable"><code>EVENTLOG</code></em>
    4040                <em class="replaceable"><code>RECORD_NUMBER</code></em>
  • vendor/current/docs/htmldocs/manpages/net.8.html

    r414 r427  
    306306</p><p>The usershare commands are:
    307307
    308 </p><table class="simplelist" border="0" summary="Simple list"><tr><td>net usershare add sharename path [comment] [acl] [guest_ok=[y|n]] - to add or change a user defined share.</td></tr><tr><td>net usershare delete sharename - to delete a user defined share.</td></tr><tr><td>net usershare info [-l|--long] [wildcard sharename] - to print info about a user defined share.</td></tr><tr><td>net usershare list [-l|--long] [wildcard sharename] - to list user defined shares.</td></tr></table><p>
     308</p><table class="simplelist" border="0" summary="Simple list"><tr><td>net usershare add sharename path [comment [acl] [guest_ok=[y|n]]] - to add or change a user defined share.</td></tr><tr><td>net usershare delete sharename - to delete a user defined share.</td></tr><tr><td>net usershare info [-l|--long] [wildcard sharename] - to print info about a user defined share.</td></tr><tr><td>net usershare list [-l|--long] [wildcard sharename] - to list user defined shares.</td></tr></table><p>
    309309
    310310</p><div class="refsect3" lang="en"><a name="id2533944"></a><h4>USERSHARE ADD <em class="replaceable"><code>sharename</code></em> <em class="replaceable"><code>path</code></em> <em class="replaceable"><code>[comment]</code></em> <em class="replaceable"><code>[acl]</code></em> <em class="replaceable"><code>[guest_ok=[y|n]]</code></em></h4><p>
  • vendor/current/docs/htmldocs/manpages/rpcclient.1.html

    r414 r427  
    5252Try to authenticate with kerberos. Only useful in
    5353an Active Directory environment.
     54</p></dd><dt><span class="term">-C|--use-ccache</span></dt><dd><p>
     55Try to use the credentials cached by winbind.
    5456</p></dd><dt><span class="term">-A|--authentication-file=filename</span></dt><dd><p>This option allows
    5557you to specify a file from which to read the username and
     
    9395the <code class="filename">smb.conf</code> manual page for the list of valid
    9496options. </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    95 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481733"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2481739"></a><h3>LSARPC</h3><div class="variablelist"><dl><dt><span class="term">lsaquery</span></dt><dd><p>Query info policy</p></dd><dt><span class="term">lookupsids</span></dt><dd><p>Resolve a list
     97</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481745"></a><h2>COMMANDS</h2><div class="refsect2" lang="en"><a name="id2481751"></a><h3>LSARPC</h3><div class="variablelist"><dl><dt><span class="term">lsaquery</span></dt><dd><p>Query info policy</p></dd><dt><span class="term">lookupsids</span></dt><dd><p>Resolve a list
    9698                of SIDs to usernames.
    9799                </p></dd><dt><span class="term">lookupnames</span></dt><dd><p>Resolve a list
    98100                of usernames to SIDs.
    99                 </p></dd><dt><span class="term">enumtrusts</span></dt><dd><p>Enumerate trusted domains</p></dd><dt><span class="term">enumprivs</span></dt><dd><p>Enumerate privileges</p></dd><dt><span class="term">getdispname</span></dt><dd><p>Get the privilege name</p></dd><dt><span class="term">lsaenumsid</span></dt><dd><p>Enumerate the LSA SIDS</p></dd><dt><span class="term">lsaenumprivsaccount</span></dt><dd><p>Enumerate the privileges of an SID</p></dd><dt><span class="term">lsaenumacctrights</span></dt><dd><p>Enumerate the rights of an SID</p></dd><dt><span class="term">lsaenumacctwithright</span></dt><dd><p>Enumerate accounts with a right</p></dd><dt><span class="term">lsaaddacctrights</span></dt><dd><p>Add rights to an account</p></dd><dt><span class="term">lsaremoveacctrights</span></dt><dd><p>Remove rights from an account</p></dd><dt><span class="term">lsalookupprivvalue</span></dt><dd><p>Get a privilege value given its name</p></dd><dt><span class="term">lsaquerysecobj</span></dt><dd><p>Query LSA security object</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2481863"></a><h3>LSARPC-DS</h3><div class="variablelist"><dl><dt><span class="term">dsroledominfo</span></dt><dd><p>Get Primary Domain Information</p></dd></dl></div><p> </p><p><span class="emphasis"><em>DFS</em></span></p><div class="variablelist"><dl><dt><span class="term">dfsexist</span></dt><dd><p>Query DFS support</p></dd><dt><span class="term">dfsadd</span></dt><dd><p>Add a DFS share</p></dd><dt><span class="term">dfsremove</span></dt><dd><p>Remove a DFS share</p></dd><dt><span class="term">dfsgetinfo</span></dt><dd><p>Query DFS share info</p></dd><dt><span class="term">dfsenum</span></dt><dd><p>Enumerate dfs shares</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2481932"></a><h3>REG</h3><div class="variablelist"><dl><dt><span class="term">shutdown</span></dt><dd><p>Remote Shutdown</p></dd><dt><span class="term">abortshutdown</span></dt><dd><p>Abort Shutdown</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2481958"></a><h3>SRVSVC</h3><div class="variablelist"><dl><dt><span class="term">srvinfo</span></dt><dd><p>Server query info</p></dd><dt><span class="term">netshareenum</span></dt><dd><p>Enumerate shares</p></dd><dt><span class="term">netfileenum</span></dt><dd><p>Enumerate open files</p></dd><dt><span class="term">netremotetod</span></dt><dd><p>Fetch remote time of day</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2482000"></a><h3>SAMR</h3><div class="variablelist"><dl><dt><span class="term">queryuser</span></dt><dd><p>Query user info</p></dd><dt><span class="term">querygroup</span></dt><dd><p>Query group info</p></dd><dt><span class="term">queryusergroups</span></dt><dd><p>Query user groups</p></dd><dt><span class="term">querygroupmem</span></dt><dd><p>Query group membership</p></dd><dt><span class="term">queryaliasmem</span></dt><dd><p>Query alias membership</p></dd><dt><span class="term">querydispinfo</span></dt><dd><p>Query display info</p></dd><dt><span class="term">querydominfo</span></dt><dd><p>Query domain info</p></dd><dt><span class="term">enumdomusers</span></dt><dd><p>Enumerate domain users</p></dd><dt><span class="term">enumdomgroups</span></dt><dd><p>Enumerate domain groups</p></dd><dt><span class="term">enumalsgroups</span></dt><dd><p>Enumerate alias groups</p></dd><dt><span class="term">createdomuser</span></dt><dd><p>Create domain user</p></dd><dt><span class="term">samlookupnames</span></dt><dd><p>Look up names</p></dd><dt><span class="term">samlookuprids</span></dt><dd><p>Look up names</p></dd><dt><span class="term">deletedomuser</span></dt><dd><p>Delete domain user</p></dd><dt><span class="term">samquerysecobj</span></dt><dd><p>Query SAMR security object</p></dd><dt><span class="term">getdompwinfo</span></dt><dd><p>Retrieve domain password info</p></dd><dt><span class="term">lookupdomain</span></dt><dd><p>Look up domain</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2532606"></a><h3>SPOOLSS</h3><div class="variablelist"><dl><dt><span class="term">adddriver &lt;arch&gt; &lt;config&gt; [&lt;version&gt;]</span></dt><dd><p>
     101                </p></dd><dt><span class="term">enumtrusts</span></dt><dd><p>Enumerate trusted domains</p></dd><dt><span class="term">enumprivs</span></dt><dd><p>Enumerate privileges</p></dd><dt><span class="term">getdispname</span></dt><dd><p>Get the privilege name</p></dd><dt><span class="term">lsaenumsid</span></dt><dd><p>Enumerate the LSA SIDS</p></dd><dt><span class="term">lsaenumprivsaccount</span></dt><dd><p>Enumerate the privileges of an SID</p></dd><dt><span class="term">lsaenumacctrights</span></dt><dd><p>Enumerate the rights of an SID</p></dd><dt><span class="term">lsaenumacctwithright</span></dt><dd><p>Enumerate accounts with a right</p></dd><dt><span class="term">lsaaddacctrights</span></dt><dd><p>Add rights to an account</p></dd><dt><span class="term">lsaremoveacctrights</span></dt><dd><p>Remove rights from an account</p></dd><dt><span class="term">lsalookupprivvalue</span></dt><dd><p>Get a privilege value given its name</p></dd><dt><span class="term">lsaquerysecobj</span></dt><dd><p>Query LSA security object</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2481875"></a><h3>LSARPC-DS</h3><div class="variablelist"><dl><dt><span class="term">dsroledominfo</span></dt><dd><p>Get Primary Domain Information</p></dd></dl></div><p> </p><p><span class="emphasis"><em>DFS</em></span></p><div class="variablelist"><dl><dt><span class="term">dfsexist</span></dt><dd><p>Query DFS support</p></dd><dt><span class="term">dfsadd</span></dt><dd><p>Add a DFS share</p></dd><dt><span class="term">dfsremove</span></dt><dd><p>Remove a DFS share</p></dd><dt><span class="term">dfsgetinfo</span></dt><dd><p>Query DFS share info</p></dd><dt><span class="term">dfsenum</span></dt><dd><p>Enumerate dfs shares</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2481944"></a><h3>REG</h3><div class="variablelist"><dl><dt><span class="term">shutdown</span></dt><dd><p>Remote Shutdown</p></dd><dt><span class="term">abortshutdown</span></dt><dd><p>Abort Shutdown</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2481970"></a><h3>SRVSVC</h3><div class="variablelist"><dl><dt><span class="term">srvinfo</span></dt><dd><p>Server query info</p></dd><dt><span class="term">netshareenum</span></dt><dd><p>Enumerate shares</p></dd><dt><span class="term">netfileenum</span></dt><dd><p>Enumerate open files</p></dd><dt><span class="term">netremotetod</span></dt><dd><p>Fetch remote time of day</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2482012"></a><h3>SAMR</h3><div class="variablelist"><dl><dt><span class="term">queryuser</span></dt><dd><p>Query user info</p></dd><dt><span class="term">querygroup</span></dt><dd><p>Query group info</p></dd><dt><span class="term">queryusergroups</span></dt><dd><p>Query user groups</p></dd><dt><span class="term">querygroupmem</span></dt><dd><p>Query group membership</p></dd><dt><span class="term">queryaliasmem</span></dt><dd><p>Query alias membership</p></dd><dt><span class="term">querydispinfo</span></dt><dd><p>Query display info</p></dd><dt><span class="term">querydominfo</span></dt><dd><p>Query domain info</p></dd><dt><span class="term">enumdomusers</span></dt><dd><p>Enumerate domain users</p></dd><dt><span class="term">enumdomgroups</span></dt><dd><p>Enumerate domain groups</p></dd><dt><span class="term">enumalsgroups</span></dt><dd><p>Enumerate alias groups</p></dd><dt><span class="term">createdomuser</span></dt><dd><p>Create domain user</p></dd><dt><span class="term">samlookupnames</span></dt><dd><p>Look up names</p></dd><dt><span class="term">samlookuprids</span></dt><dd><p>Look up names</p></dd><dt><span class="term">deletedomuser</span></dt><dd><p>Delete domain user</p></dd><dt><span class="term">samquerysecobj</span></dt><dd><p>Query SAMR security object</p></dd><dt><span class="term">getdompwinfo</span></dt><dd><p>Retrieve domain password info</p></dd><dt><span class="term">lookupdomain</span></dt><dd><p>Look up domain</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2532616"></a><h3>SPOOLSS</h3><div class="variablelist"><dl><dt><span class="term">adddriver &lt;arch&gt; &lt;config&gt; [&lt;version&gt;]</span></dt><dd><p>
    100102                Execute an AddPrinterDriver() RPC to install the printer driver
    101103                information on the server.  Note that the driver files should
     
    182184                <code class="literal">enumdrivers</code> commands for obtaining a list of
    183185                of installed printers and drivers.</p></dd><dt><span class="term">addform</span></dt><dd><p>Add form</p></dd><dt><span class="term">setform</span></dt><dd><p>Set form</p></dd><dt><span class="term">getform</span></dt><dd><p>Get form</p></dd><dt><span class="term">deleteform</span></dt><dd><p>Delete form</p></dd><dt><span class="term">enumforms</span></dt><dd><p>Enumerate form</p></dd><dt><span class="term">setprinter</span></dt><dd><p>Set printer comment</p></dd><dt><span class="term">setprinterdata</span></dt><dd><p>Set REG_SZ printer data</p></dd><dt><span class="term">setprintername &lt;printername&gt;
    184                 &lt;newprintername&gt;</span></dt><dd><p>Set printer name</p></dd><dt><span class="term">rffpcnex</span></dt><dd><p>Rffpcnex test</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2533001"></a><h3>NETLOGON</h3><div class="variablelist"><dl><dt><span class="term">logonctrl2</span></dt><dd><p>Logon Control 2</p></dd><dt><span class="term">logonctrl</span></dt><dd><p>Logon Control</p></dd><dt><span class="term">samsync</span></dt><dd><p>Sam Synchronisation</p></dd><dt><span class="term">samdeltas</span></dt><dd><p>Query Sam Deltas</p></dd><dt><span class="term">samlogon</span></dt><dd><p>Sam Logon</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2533059"></a><h3>GENERAL COMMANDS</h3><div class="variablelist"><dl><dt><span class="term">debuglevel</span></dt><dd><p>Set the current
     186                &lt;newprintername&gt;</span></dt><dd><p>Set printer name</p></dd><dt><span class="term">rffpcnex</span></dt><dd><p>Rffpcnex test</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2533012"></a><h3>NETLOGON</h3><div class="variablelist"><dl><dt><span class="term">logonctrl2</span></dt><dd><p>Logon Control 2</p></dd><dt><span class="term">logonctrl</span></dt><dd><p>Logon Control</p></dd><dt><span class="term">samsync</span></dt><dd><p>Sam Synchronisation</p></dd><dt><span class="term">samdeltas</span></dt><dd><p>Query Sam Deltas</p></dd><dt><span class="term">samlogon</span></dt><dd><p>Sam Logon</p></dd></dl></div></div><div class="refsect2" lang="en"><a name="id2533069"></a><h3>GENERAL COMMANDS</h3><div class="variablelist"><dl><dt><span class="term">debuglevel</span></dt><dd><p>Set the current
    185187                debug level used to log information.</p></dd><dt><span class="term">help (?)</span></dt><dd><p>Print a listing of all
    186188                known commands or extended help  on a particular command.
    187189                </p></dd><dt><span class="term">quit (exit)</span></dt><dd><p>Exit <code class="literal">rpcclient
    188                 </code>.</p></dd></dl></div></div></div><div class="refsect1" lang="en"><a name="id2533100"></a><h2>BUGS</h2><p><code class="literal">rpcclient</code> is designed as a developer testing tool
     190                </code>.</p></dd></dl></div></div></div><div class="refsect1" lang="en"><a name="id2533110"></a><h2>BUGS</h2><p><code class="literal">rpcclient</code> is designed as a developer testing tool
    189191        and may not be robust in certain areas (such as command line parsing). 
    190192        It has been known to  generate a core dump upon failures when invalid
     
    199201        the developers are sending reports to Microsoft,  and problems found
    200202        or reported to Microsoft are fixed in Service Packs,  which may
    201         result in incompatibilities.</p></div><div class="refsect1" lang="en"><a name="id2533157"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    202         suite.</p></div><div class="refsect1" lang="en"><a name="id2533168"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     203        result in incompatibilities.</p></div><div class="refsect1" lang="en"><a name="id2533168"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
     204        suite.</p></div><div class="refsect1" lang="en"><a name="id2533179"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    203205        were created by Andrew Tridgell. Samba is now developed
    204206        by the Samba Team as an Open Source project similar
  • vendor/current/docs/htmldocs/manpages/smb.conf.5.html

    r414 r427  
    33093309
    33103310lock spin time (G)
    3311 </h3></div></div></div><a class="indexterm" name="id2548980"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in microseconds that smbd should
     3311</h3></div></div></div><a class="indexterm" name="id2548980"></a><a name="LOCKSPINTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>The time in milliseconds that smbd should
    33123312        keep waiting to see if a failed lock request can
    33133313        be granted. This parameter has changed in default
     
    41954195</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554101"></a>
    41964196
     4197nmbd bind explicit broadcast (G)
     4198</h3></div></div></div><a class="indexterm" name="id2554102"></a><a name="NMBDBINDEXPLICITBROADCAST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4199        This option causes <a class="citerefentry" href="nmbd.8.html"><span class="citerefentry"><span class="refentrytitle">nmbd</span>(8)</span></a> to explicitly bind to the
     4200        broadcast address of the local subnets. This is needed to make nmbd
     4201        work correctly in combination with the <a class="link" href="smb.conf.5.html#SOCKETADDRESS" target="_top">socket address</a> option.
     4202        You should not need to unset this option.
     4203        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nmbd bind explicit broadcast</code></em> = <code class="literal">yes</code>
     4204</em></span>
     4205</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554168"></a>
     4206
    41974207nt acl support (S)
    4198 </h3></div></div></div><a class="indexterm" name="id2554102"></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
     4208</h3></div></div></div><a class="indexterm" name="id2554169"></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
    41994209    UNIX permissions into Windows NT access control lists.  The UNIX
    42004210    permissions considered are the the traditional UNIX owner and
     
    42034213    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>
    42044214</em></span>
    4205 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554156"></a>
     4215</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554222"></a>
    42064216
    42074217ntlm auth (G)
    4208 </h3></div></div></div><a class="indexterm" name="id2554157"></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
     4218</h3></div></div></div><a class="indexterm" name="id2554224"></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
    42094219    authenticate users using the NTLM encrypted password response.
    42104220    If disabled, either the lanman password hash or an NTLMv2 response
     
    42144224        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>
    42154225</em></span>
    4216 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554220"></a>
     4226</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554286"></a>
    42174227
    42184228nt pipe support (G)
    4219 </h3></div></div></div><a class="indexterm" name="id2554221"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
     4229</h3></div></div></div><a class="indexterm" name="id2554288"></a><a name="NTPIPESUPPORT"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether
    42204230    <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> will allow Windows NT
    42214231    clients to connect to the NT SMB specific <code class="constant">IPC$</code>
     
    42234233        alone.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>nt pipe support</code></em> = <code class="literal">yes</code>
    42244234</em></span>
    4225 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554276"></a>
     4235</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554342"></a>
    42264236
    42274237nt status support (G)
    4228 </h3></div></div></div><a class="indexterm" name="id2554277"></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
     4238</h3></div></div></div><a class="indexterm" name="id2554343"></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
    42294239    support with Windows NT/2k/XP clients. This is a developer debugging option and should be left alone.
    42304240    If this option is set to <code class="constant">no</code> then Samba offers
     
    42324242    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>
    42334243</em></span>
    4234 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554337"></a>
     4244</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554404"></a>
    42354245
    42364246null passwords (G)
    4237 </h3></div></div></div><a class="indexterm" name="id2554338"></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>
    4238 </em></span>
    4239 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554391"></a>
     4247</h3></div></div></div><a class="indexterm" name="id2554405"></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>
     4248</em></span>
     4249</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554457"></a>
    42404250
    42414251obey pam restrictions (G)
    4242 </h3></div></div></div><a class="indexterm" name="id2554392"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
     4252</h3></div></div></div><a class="indexterm" name="id2554458"></a><a name="OBEYPAMRESTRICTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba 3.0 is configured to enable PAM support
    42434253    (i.e. --with-pam), this parameter will control whether or not Samba
    42444254    should obey PAM's account and session management directives.  The
     
    42504260</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>obey pam restrictions</code></em> = <code class="literal">no</code>
    42514261</em></span>
    4252 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554455"></a>
     4262</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554522"></a>
    42534263
    42544264only user (S)
    4255 </h3></div></div></div><a class="indexterm" name="id2554456"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
     4265</h3></div></div></div><a class="indexterm" name="id2554523"></a><a name="ONLYUSER"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean option that controls whether
    42564266    connections with usernames not in the <em class="parameter"><code>user</code></em>
    42574267    list will be allowed. By default this option is disabled so that a
     
    42664276    name of the user.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>only user</code></em> = <code class="literal">no</code>
    42674277</em></span>
    4268 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554544"></a>
     4278</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554611"></a>
    42694279
    42704280oplock break wait time (G)
    4271 </h3></div></div></div><a class="indexterm" name="id2554545"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4281</h3></div></div></div><a class="indexterm" name="id2554612"></a><a name="OPLOCKBREAKWAITTIME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    42724282        This is a tuning parameter added due to bugs in both Windows 9x and WinNT. If Samba responds to a client too
    42734283        quickly when that client issues an SMB that can cause an oplock break request, then the network client can
     
    42784288        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock break wait time</code></em> = <code class="literal">0</code>
    42794289</em></span>
    4280 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554599"></a>
     4290</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554666"></a>
    42814291
    42824292oplock contention limit (S)
    4283 </h3></div></div></div><a class="indexterm" name="id2554600"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4293</h3></div></div></div><a class="indexterm" name="id2554667"></a><a name="OPLOCKCONTENTIONLIMIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    42844294        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
    42854295        granting of oplocks under multiple client contention for the same file.
     
    42934303        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplock contention limit</code></em> = <code class="literal">2</code>
    42944304</em></span>
    4295 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554681"></a>
     4305</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554748"></a>
    42964306
    42974307oplocks (S)
    4298 </h3></div></div></div><a class="indexterm" name="id2554682"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4308</h3></div></div></div><a class="indexterm" name="id2554749"></a><a name="OPLOCKS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    42994309        This boolean option tells <code class="literal">smbd</code> whether to
    43004310        issue oplocks (opportunistic locks) to file open requests on this
     
    43134323        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>oplocks</code></em> = <code class="literal">yes</code>
    43144324</em></span>
    4315 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554774"></a>
     4325</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554834"></a>
    43164326
    43174327os2 driver map (G)
    4318 </h3></div></div></div><a class="indexterm" name="id2554775"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
     4328</h3></div></div></div><a class="indexterm" name="id2554835"></a><a name="OS2DRIVERMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>The parameter is used to define the absolute
    43194329    path to a file containing a mapping of Windows NT printer driver
    43204330    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
     
    43264336    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>os2 driver map</code></em> = <code class="literal"></code>
    43274337</em></span>
    4328 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554841"></a>
     4338</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554901"></a>
    43294339
    43304340os level (G)
    4331 </h3></div></div></div><a class="indexterm" name="id2554842"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4341</h3></div></div></div><a class="indexterm" name="id2554902"></a><a name="OSLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    43324342        This integer value controls what level Samba advertises itself as for browse elections. The value of this
    43334343        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.
     
    43454355</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>os level</code></em> = <code class="literal">65</code>
    43464356</em></span>
    4347 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2554940"></a>
     4357</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555010"></a>
    43484358
    43494359pam password change (G)
    4350 </h3></div></div></div><a class="indexterm" name="id2554941"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
     4360</h3></div></div></div><a class="indexterm" name="id2555011"></a><a name="PAMPASSWORDCHANGE"></a><div class="variablelist"><dl><dt></dt><dd><p>With the addition of better PAM support in Samba 2.2,
    43514361    this parameter, it is possible to use PAM's password change control
    43524362    flag for Samba.  If enabled, then PAM will be used for password
     
    43564366    <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>
    43574367</em></span>
    4358 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555013"></a>
     4368</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555082"></a>
    43594369
    43604370panic action (G)
    4361 </h3></div></div></div><a class="indexterm" name="id2555014"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
     4371</h3></div></div></div><a class="indexterm" name="id2555083"></a><a name="PANICACTION"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a Samba developer option that allows a
    43624372        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
    43634373        draw attention to the fact that a problem occurred.
     
    43664376</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>panic action</code></em> = <code class="literal">"/bin/sleep 90000"</code>
    43674377</em></span>
    4368 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555089"></a>
     4378</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555158"></a>
    43694379
    43704380paranoid server security (G)
    4371 </h3></div></div></div><a class="indexterm" name="id2555090"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
     4381</h3></div></div></div><a class="indexterm" name="id2555159"></a><a name="PARANOIDSERVERSECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>Some version of NT 4.x allow non-guest
    43724382    users with a bad passowrd. When this option is enabled, samba will not
    43734383    use a broken NT 4.x server as password server, but instead complain
     
    43774387    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>
    43784388</em></span>
    4379 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555140"></a>
     4389</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555209"></a>
    43804390
    43814391passdb backend (G)
    4382 </h3></div></div></div><a class="indexterm" name="id2555141"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
     4392</h3></div></div></div><a class="indexterm" name="id2555210"></a><a name="PASSDBBACKEND"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows the administrator to chose which backend
    43834393    will be used for storing user and possibly group information.  This allows
    43844394    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'
     
    44154425</pre><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb backend</code></em> = <code class="literal">tdbsam</code>
    44164426</em></span>
    4417 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555299"></a>
     4427</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555368"></a>
    44184428
    44194429passdb expand explicit (G)
    4420 </h3></div></div></div><a class="indexterm" name="id2555300"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4430</h3></div></div></div><a class="indexterm" name="id2555369"></a><a name="PASSDBEXPANDEXPLICIT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    44214431        This parameter controls whether Samba substitutes %-macros in the passdb fields if they are explicitly set. We
    44224432        used to expand macros here, but this turned out to be a bug because the Windows client can expand a variable
     
    44244434    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passdb expand explicit</code></em> = <code class="literal">no</code>
    44254435</em></span>
    4426 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555346"></a>
     4436</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555415"></a>
    44274437
    44284438passwd chat debug (G)
    4429 </h3></div></div></div><a class="indexterm" name="id2555347"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
     4439</h3></div></div></div><a class="indexterm" name="id2555416"></a><a name="PASSWDCHATDEBUG"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean specifies if the passwd chat script
    44304440    parameter is run in <span class="emphasis"><em>debug</em></span> mode. In this mode the
    44314441    strings passed to and received from the passwd chat are printed
     
    44404450        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>
    44414451</em></span>
    4442 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555449"></a>
     4452</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555518"></a>
    44434453
    44444454passwd chat timeout (G)
    4445 </h3></div></div></div><a class="indexterm" name="id2555450"></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
     4455</h3></div></div></div><a class="indexterm" name="id2555519"></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
    44464456    answer from a passwd chat script being run. Once the initial answer is received
    44474457    the subsequent answers must be received in one tenth of this time. The default it
    44484458    two seconds.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>passwd chat timeout</code></em> = <code class="literal">2</code>
    44494459</em></span>
    4450 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555494"></a>
     4460</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555563"></a>
    44514461
    44524462passwd chat (G)
    4453 </h3></div></div></div><a class="indexterm" name="id2555495"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
     4463</h3></div></div></div><a class="indexterm" name="id2555564"></a><a name="PASSWDCHAT"></a><div class="variablelist"><dl><dt></dt><dd><p>This string controls the <span class="emphasis"><em>"chat"</em></span>
    44544464    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
    44554465    program to change the user's password. The string describes a
     
    44824492</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>
    44834493</em></span>
    4484 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555700"></a>
     4494</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555769"></a>
    44854495
    44864496passwd program (G)
    4487 </h3></div></div></div><a class="indexterm" name="id2555701"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
     4497</h3></div></div></div><a class="indexterm" name="id2555770"></a><a name="PASSWDPROGRAM"></a><div class="variablelist"><dl><dt></dt><dd><p>The name of a program that can be used to set
    44884498    UNIX user passwords.  Any occurrences of <em class="parameter"><code>%u</code></em>
    44894499    will be replaced with the user name. The user name is checked for
     
    45064516</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>passwd program</code></em> = <code class="literal">/bin/passwd %u</code>
    45074517</em></span>
    4508 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555835"></a>
     4518</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555904"></a>
    45094519
    45104520password level (G)
    4511 </h3></div></div></div><a class="indexterm" name="id2555836"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
     4521</h3></div></div></div><a class="indexterm" name="id2555905"></a><a name="PASSWORDLEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>Some client/server combinations have difficulty
    45124522    with mixed-case passwords.  One offending client is Windows for
    45134523    Workgroups, which for some reason forces passwords to upper
     
    45314541</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>password level</code></em> = <code class="literal">4</code>
    45324542</em></span>
    4533 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2555972"></a>
     4543</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556041"></a>
    45344544
    45354545password server (G)
    4536 </h3></div></div></div><a class="indexterm" name="id2555973"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
     4546</h3></div></div></div><a class="indexterm" name="id2556042"></a><a name="PASSWORDSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>By specifying the name of another SMB server
    45374547    or Active Directory domain controller with this option,
    45384548    and using <code class="literal">security = [ads|domain|server]</code>
     
    45944604</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>
    45954605</em></span>
    4596 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556270"></a>
     4606</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556339"></a>
    45974607
    45984608<a name="DIRECTORY"></a>directory
    4599 </h3></div></div></div><a class="indexterm" name="id2556271"></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="id2556301"></a>
     4609</h3></div></div></div><a class="indexterm" name="id2556340"></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="id2556370"></a>
    46004610
    46014611path (S)
    4602 </h3></div></div></div><a class="indexterm" name="id2556302"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
     4612</h3></div></div></div><a class="indexterm" name="id2556371"></a><a name="PATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a directory to which
    46034613        the user of the service is to be given access. In the case of
    46044614        printable services, this is where print data will spool prior to
     
    46174627</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>path</code></em> = <code class="literal">/home/fred</code>
    46184628</em></span>
    4619 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556405"></a>
     4629</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556474"></a>
    46204630
    46214631perfcount module (G)
    4622 </h3></div></div></div><a class="indexterm" name="id2556406"></a><a name="PERFCOUNTMODULE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the perfcount backend to be used when monitoring SMB
     4632</h3></div></div></div><a class="indexterm" name="id2556476"></a><a name="PERFCOUNTMODULE"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the perfcount backend to be used when monitoring SMB
    46234633        operations.  Only one perfcount module may be used, and it must implement all of the
    46244634        apis contained in the smb_perfcount_handler structure defined in smb.h.
    4625         </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="id2556439"></a>
     4635        </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="id2556508"></a>
    46264636
    46274637pid directory (G)
    4628 </h3></div></div></div><a class="indexterm" name="id2556440"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4638</h3></div></div></div><a class="indexterm" name="id2556509"></a><a name="PIDDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46294639        This option specifies the directory where pid files will be placed. 
    46304640        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">${prefix}/var/locks</code>
     
    46324642</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>pid directory</code></em> = <code class="literal">pid directory = /var/run/</code>
    46334643</em></span>
    4634 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556499"></a>
     4644</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556568"></a>
    46354645
    46364646posix locking (S)
    4637 </h3></div></div></div><a class="indexterm" name="id2556500"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4647</h3></div></div></div><a class="indexterm" name="id2556569"></a><a name="POSIXLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46384648        The <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a>
    46394649        daemon maintains an database of file locks obtained by SMB clients. The default behavior is
     
    46434653        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>posix locking</code></em> = <code class="literal">yes</code>
    46444654</em></span>
    4645 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556554"></a>
     4655</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556623"></a>
    46464656
    46474657postexec (S)
    4648 </h3></div></div></div><a class="indexterm" name="id2556555"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
     4658</h3></div></div></div><a class="indexterm" name="id2556624"></a><a name="POSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run
    46494659        whenever the service is disconnected. It takes the usual
    46504660        substitutions. The command may be run as the root on some
     
    46544664</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>
    46554665</em></span>
    4656 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556627"></a>
     4666</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556696"></a>
    46574667
    46584668preexec close (S)
    4659 </h3></div></div></div><a class="indexterm" name="id2556628"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4669</h3></div></div></div><a class="indexterm" name="id2556697"></a><a name="PREEXECCLOSE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46604670        This boolean option controls whether a non-zero return code from <a class="link" href="smb.conf.5.html#PREEXEC" target="_top">preexec</a>
    46614671        should close the service being connected to.
    46624672        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preexec close</code></em> = <code class="literal">no</code>
    46634673</em></span>
    4664 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556682"></a>
     4674</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556751"></a>
    46654675
    46664676<a name="EXEC"></a>exec
    4667 </h3></div></div></div><a class="indexterm" name="id2556683"></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="id2556714"></a>
     4677</h3></div></div></div><a class="indexterm" name="id2556752"></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="id2556783"></a>
    46684678
    46694679preexec (S)
    4670 </h3></div></div></div><a class="indexterm" name="id2556715"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
     4680</h3></div></div></div><a class="indexterm" name="id2556784"></a><a name="PREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies a command to be run whenever
    46714681        the service is connected to. It takes the usual substitutions.</p><p>An interesting example is to send the users a welcome
    46724682        message every time they log in. Maybe a message of the day? Here
     
    46804690</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>
    46814691</em></span>
    4682 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556822"></a>
     4692</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556891"></a>
    46834693
    46844694<a name="PREFEREDMASTER"></a>prefered master
    4685 </h3></div></div></div><a class="indexterm" name="id2556823"></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="id2556855"></a>
     4695</h3></div></div></div><a class="indexterm" name="id2556892"></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="id2556924"></a>
    46864696
    46874697preferred master (G)
    4688 </h3></div></div></div><a class="indexterm" name="id2556856"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4698</h3></div></div></div><a class="indexterm" name="id2556926"></a><a name="PREFERREDMASTER"></a><div class="variablelist"><dl><dt></dt><dd><p>
    46894699        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.
    46904700        </p><p>
     
    47004710        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preferred master</code></em> = <code class="literal">auto</code>
    47014711</em></span>
    4702 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2556948"></a>
     4712</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557017"></a>
    47034713
    47044714preload modules (G)
    4705 </h3></div></div></div><a class="indexterm" name="id2556949"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
     4715</h3></div></div></div><a class="indexterm" name="id2557018"></a><a name="PRELOADMODULES"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of paths to modules that should
    47064716        be loaded into smbd before a client connects. This improves
    47074717        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>
     
    47094719</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>
    47104720</em></span>
    4711 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557009"></a>
     4721</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557078"></a>
    47124722
    47134723<a name="AUTOSERVICES"></a>auto services
    4714 </h3></div></div></div><a class="indexterm" name="id2557010"></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="id2557042"></a>
     4724</h3></div></div></div><a class="indexterm" name="id2557079"></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="id2557111"></a>
    47154725
    47164726preload (G)
    4717 </h3></div></div></div><a class="indexterm" name="id2557043"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
     4727</h3></div></div></div><a class="indexterm" name="id2557112"></a><a name="PRELOAD"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a list of services that you want to be
    47184728        automatically added to the browse lists. This is most useful
    47194729        for homes and printers services that would otherwise not be
     
    47264736</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>preload</code></em> = <code class="literal">fred lp colorlp</code>
    47274737</em></span>
    4728 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557120"></a>
     4738</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557189"></a>
    47294739
    47304740preserve case (S)
    4731 </h3></div></div></div><a class="indexterm" name="id2557121"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4741</h3></div></div></div><a class="indexterm" name="id2557190"></a><a name="PRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47324742        This controls if new filenames are created with the case that the client passes, or if
    47334743        they are forced to be the <a class="link" href="smb.conf.5.html#DEFAULTCASE" target="_top">default case</a>.
     
    47364746        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>preserve case</code></em> = <code class="literal">yes</code>
    47374747</em></span>
    4738 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557187"></a>
     4748</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557256"></a>
    47394749
    47404750<a name="PRINTOK"></a>print ok
    4741 </h3></div></div></div><a class="indexterm" name="id2557188"></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="id2557218"></a>
     4751</h3></div></div></div><a class="indexterm" name="id2557257"></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="id2557287"></a>
    47424752
    47434753printable (S)
    4744 </h3></div></div></div><a class="indexterm" name="id2557219"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
     4754</h3></div></div></div><a class="indexterm" name="id2557288"></a><a name="PRINTABLE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this parameter is <code class="constant">yes</code>, then
    47454755    clients may open, write to and submit spool files on the directory
    47464756    specified for the service. </p><p>Note that a printable service will ALWAYS allow writing
     
    47494759    the resource.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>printable</code></em> = <code class="literal">no</code>
    47504760</em></span>
    4751 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557281"></a>
     4761</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557350"></a>
    47524762
    47534763printcap cache time (G)
    4754 </h3></div></div></div><a class="indexterm" name="id2557282"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
     4764</h3></div></div></div><a class="indexterm" name="id2557351"></a><a name="PRINTCAPCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the number of seconds before the printing
    47554765    subsystem is again asked for the known printers.  If the value
    47564766    is greater than 60 the initial waiting time is set to 60 seconds
     
    47624772</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap cache time</code></em> = <code class="literal">600</code>
    47634773</em></span>
    4764 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557350"></a>
     4774</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557419"></a>
    47654775
    47664776<a name="PRINTCAP"></a>printcap
    4767 </h3></div></div></div><a class="indexterm" name="id2557351"></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="id2557383"></a>
     4777</h3></div></div></div><a class="indexterm" name="id2557420"></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="id2557452"></a>
    47684778
    47694779printcap name (G)
    4770 </h3></div></div></div><a class="indexterm" name="id2557384"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4780</h3></div></div></div><a class="indexterm" name="id2557453"></a><a name="PRINTCAPNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    47714781        This parameter may be used to override the compiled-in default printcap name used by the server (usually
    47724782        <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.
     
    48034813</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printcap name</code></em> = <code class="literal">/etc/myprintcap</code>
    48044814</em></span>
    4805 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557567"></a>
     4815</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557636"></a>
    48064816
    48074817print command (S)
    4808 </h3></div></div></div><a class="indexterm" name="id2557568"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
     4818</h3></div></div></div><a class="indexterm" name="id2557637"></a><a name="PRINTCOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>After a print job has finished spooling to
    48094819    a service, this command will be used via a <code class="literal">system()</code>
    48104820    call to process the spool file. Typically the command specified will
     
    48484858        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>
    48494859</em></span>
    4850 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557837"></a>
     4860</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557906"></a>
    48514861
    48524862printer admin (S)
    4853 </h3></div></div></div><a class="indexterm" name="id2557838"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4863</h3></div></div></div><a class="indexterm" name="id2557907"></a><a name="PRINTERADMIN"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48544864        This lists users who can do anything to printers
    48554865        via the remote administration interfaces offered
     
    48674877</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer admin</code></em> = <code class="literal">admin, @staff</code>
    48684878</em></span>
    4869 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557906"></a>
     4879</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2557975"></a>
    48704880
    48714881<a name="PRINTER"></a>printer
    4872 </h3></div></div></div><a class="indexterm" name="id2557907"></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="id2557938"></a>
     4882</h3></div></div></div><a class="indexterm" name="id2557976"></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="id2558007"></a>
    48734883
    48744884printer name (S)
    4875 </h3></div></div></div><a class="indexterm" name="id2557939"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4885</h3></div></div></div><a class="indexterm" name="id2558008"></a><a name="PRINTERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>
    48764886        This parameter specifies the name of the printer to which print jobs spooled through a printable service
    48774887        will be sent.
     
    48864896</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printer name</code></em> = <code class="literal">laserwriter</code>
    48874897</em></span>
    4888 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558025"></a>
     4898</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558094"></a>
    48894899
    48904900printing (S)
    4891 </h3></div></div></div><a class="indexterm" name="id2558026"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
     4901</h3></div></div></div><a class="indexterm" name="id2558096"></a><a name="PRINTING"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters controls how printer status  information is
    48924902    interpreted on your system. It also affects the  default values for
    48934903    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
     
    49064916<code class="literal">testparm -v.</code></code>
    49074917</em></span>
    4908 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558179"></a>
     4918</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558248"></a>
    49094919
    49104920printjob username (S)
    4911 </h3></div></div></div><a class="indexterm" name="id2558180"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
     4921</h3></div></div></div><a class="indexterm" name="id2558249"></a><a name="PRINTJOBUSERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies which user information will be
    49124922    passed to the printing system. Usually, the username is sent,
    49134923    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>
     
    49154925</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>printjob username</code></em> = <code class="literal">%D\%U</code>
    49164926</em></span>
    4917 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558240"></a>
     4927</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558309"></a>
    49184928
    49194929private dir (G)
    4920 </h3></div></div></div><a class="indexterm" name="id2558241"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
     4930</h3></div></div></div><a class="indexterm" name="id2558310"></a><a name="PRIVATEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameters defines the directory
    49214931    smbd will use for storing such files as <code class="filename">smbpasswd</code>
    49224932    and <code class="filename">secrets.tdb</code>.
    49234933</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>private dir</code></em> = <code class="literal">${prefix}/private</code>
    49244934</em></span>
    4925 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558294"></a>
     4935</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558363"></a>
    49264936
    49274937profile acls (S)
    4928 </h3></div></div></div><a class="indexterm" name="id2558295"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     4938</h3></div></div></div><a class="indexterm" name="id2558364"></a><a name="PROFILEACLS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49294939        This boolean parameter was added to fix the problems that people have been
    49304940        having with storing user profiles on Samba shares from Windows 2000 or
     
    49544964        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>profile acls</code></em> = <code class="literal">no</code>
    49554965</em></span>
    4956 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558378"></a>
     4966</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558436"></a>
    49574967
    49584968queuepause command (S)
    4959 </h3></div></div></div><a class="indexterm" name="id2558379"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     4969</h3></div></div></div><a class="indexterm" name="id2558437"></a><a name="QUEUEPAUSECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    49604970    executed on the server host in order to pause the printer queue.</p><p>This command should be a program or script which takes
    49614971    a printer name as its only parameter and stops the printer queue,
     
    49684978        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>
    49694979</em></span>
    4970 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558455"></a>
     4980</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558513"></a>
    49714981
    49724982queueresume command (S)
    4973 </h3></div></div></div><a class="indexterm" name="id2558456"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
     4983</h3></div></div></div><a class="indexterm" name="id2558514"></a><a name="QUEUERESUMECOMMAND"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the command to be
    49744984    executed on the server host in order to resume the printer queue. It
    49754985    is the command to undo the behavior that is caused by the
     
    49864996</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>queueresume command</code></em> = <code class="literal">enable %p</code>
    49874997</em></span>
    4988 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558558"></a>
     4998</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558616"></a>
    49894999
    49905000read list (S)
    4991 </h3></div></div></div><a class="indexterm" name="id2558559"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5001</h3></div></div></div><a class="indexterm" name="id2558617"></a><a name="READLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    49925002        This is a list of users that are given read-only access to a service. If the connecting user is in this list
    49935003        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
     
    49995009</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>read list</code></em> = <code class="literal">mary, @students</code>
    50005010</em></span>
    5001 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558657"></a>
     5011</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558715"></a>
    50025012
    50035013read only (S)
    5004 </h3></div></div></div><a class="indexterm" name="id2558658"></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
     5014</h3></div></div></div><a class="indexterm" name="id2558716"></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
    50055015    of a service may not create or modify files in the service's
    50065016    directory.</p><p>Note that a printable service (<code class="literal">printable = yes</code>)
     
    50085018    (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>
    50095019</em></span>
    5010 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558734"></a>
     5020</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558792"></a>
    50115021
    50125022read raw (G)
    5013 </h3></div></div></div><a class="indexterm" name="id2558735"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     5023</h3></div></div></div><a class="indexterm" name="id2558793"></a><a name="READRAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    50145024    will support the raw read SMB requests when transferring data
    50155025    to clients.</p><p>If enabled, raw reads allow reads of 65535 bytes in
     
    50205030        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>
    50215031</em></span>
    5022 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558794"></a>
     5032</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558852"></a>
    50235033
    50245034realm (G)
    5025 </h3></div></div></div><a class="indexterm" name="id2558796"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
     5035</h3></div></div></div><a class="indexterm" name="id2558854"></a><a name="REALM"></a><div class="variablelist"><dl><dt></dt><dd><p>This option specifies the kerberos realm to use. The realm is
    50265036        used as the ADS equivalent of the NT4 <code class="literal">domain</code>. It
    50275037        is usually set to the DNS name of the kerberos server.
     
    50305040</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>realm</code></em> = <code class="literal">mysambabox.mycompany.com</code>
    50315041</em></span>
    5032 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558859"></a>
     5042</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558917"></a>
    50335043
    50345044registry shares (G)
    5035 </h3></div></div></div><a class="indexterm" name="id2558860"></a><a name="REGISTRYSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5045</h3></div></div></div><a class="indexterm" name="id2558918"></a><a name="REGISTRYSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50365046        This turns on or off support for share definitions read from
    50375047        registry. Shares defined in <span class="emphasis"><em>smb.conf</em></span> take
     
    50485058</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>registry shares</code></em> = <code class="literal">yes</code>
    50495059</em></span>
    5050 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2558946"></a>
     5060</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559004"></a>
    50515061
    50525062remote announce (G)
    5053 </h3></div></div></div><a class="indexterm" name="id2558947"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5063</h3></div></div></div><a class="indexterm" name="id2559005"></a><a name="REMOTEANNOUNCE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50545064        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
    50555065        to arbitrary IP addresses with an arbitrary workgroup name.
     
    50755085        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote announce</code></em> = <code class="literal"></code>
    50765086</em></span>
    5077 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559051"></a>
     5087</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559109"></a>
    50785088
    50795089remote browse sync (G)
    5080 </h3></div></div></div><a class="indexterm" name="id2559052"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5090</h3></div></div></div><a class="indexterm" name="id2559110"></a><a name="REMOTEBROWSESYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    50815091        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
    50825092        synchronization of browse lists with the master browser of a Samba
     
    51105120        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>remote browse sync</code></em> = <code class="literal"></code>
    51115121</em></span>
    5112 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559164"></a>
     5122</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559222"></a>
    51135123
    51145124rename user script (G)
    5115 </h3></div></div></div><a class="indexterm" name="id2559165"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5125</h3></div></div></div><a class="indexterm" name="id2559223"></a><a name="RENAMEUSERSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51165126        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.
    51175127        </p><p>
     
    51315141        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>rename user script</code></em> = <code class="literal">no</code>
    51325142</em></span>
    5133 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559254"></a>
     5143</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559312"></a>
    51345144
    51355145reset on zero vc (G)
    5136 </h3></div></div></div><a class="indexterm" name="id2559255"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5146</h3></div></div></div><a class="indexterm" name="id2559313"></a><a name="RESETONZEROVC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    51375147        This boolean option controls whether an incoming session setup
    51385148        should kill other connections coming from the same IP. This matches
     
    51535163        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>reset on zero vc</code></em> = <code class="literal">no</code>
    51545164</em></span>
    5155 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559307"></a>
     5165</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559365"></a>
    51565166
    51575167restrict anonymous (G)
    5158 </h3></div></div></div><a class="indexterm" name="id2559308"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
     5168</h3></div></div></div><a class="indexterm" name="id2559366"></a><a name="RESTRICTANONYMOUS"></a><div class="variablelist"><dl><dt></dt><dd><p>The setting of this parameter determines whether user and
    51595169    group list information is returned for an anonymous connection.
    51605170    and mirrors the effects of the
     
    51795189        </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>restrict anonymous</code></em> = <code class="literal">0</code>
    51805190</em></span>
    5181 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559391"></a>
     5191</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559449"></a>
    51825192
    51835193<a name="ROOT"></a>root
    5184 </h3></div></div></div><a class="indexterm" name="id2559392"></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="id2559424"></a>
     5194</h3></div></div></div><a class="indexterm" name="id2559450"></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="id2559482"></a>
    51855195
    51865196<a name="ROOTDIR"></a>root dir
    5187 </h3></div></div></div><a class="indexterm" name="id2559425"></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="id2559456"></a>
     5197</h3></div></div></div><a class="indexterm" name="id2559483"></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="id2559514"></a>
    51885198
    51895199root directory (G)
    5190 </h3></div></div></div><a class="indexterm" name="id2559457"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
     5200</h3></div></div></div><a class="indexterm" name="id2559515"></a><a name="ROOTDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>The server will <code class="literal">chroot()</code> (i.e.
    51915201    Change its root directory) to this directory on startup. This is
    51925202    not strictly necessary for secure operation. Even without it the
     
    52115221</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>root directory</code></em> = <code class="literal">/homes/smb</code>
    52125222</em></span>
    5213 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559580"></a>
     5223</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559638"></a>
    52145224
    52155225root postexec (S)
    5216 </h3></div></div></div><a class="indexterm" name="id2559581"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5226</h3></div></div></div><a class="indexterm" name="id2559639"></a><a name="ROOTPOSTEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    52175227        This is the same as the <em class="parameter"><code>postexec</code></em>
    52185228        parameter except that the command is run as root. This is useful for
     
    52205230        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root postexec</code></em> = <code class="literal"></code>
    52215231</em></span>
    5222 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559628"></a>
     5232</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559686"></a>
    52235233
    52245234root preexec close (S)
    5225 </h3></div></div></div><a class="indexterm" name="id2559629"></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
     5235</h3></div></div></div><a class="indexterm" name="id2559687"></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
    52265236        </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>
    52275237</em></span>
    5228 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559677"></a>
     5238</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559735"></a>
    52295239
    52305240root preexec (S)
    5231 </h3></div></div></div><a class="indexterm" name="id2559678"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5241</h3></div></div></div><a class="indexterm" name="id2559736"></a><a name="ROOTPREEXEC"></a><div class="variablelist"><dl><dt></dt><dd><p>
    52325242        This is the same as the <em class="parameter"><code>preexec</code></em>
    52335243        parameter except that the command is run as root. This is useful for
     
    52355245        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>root preexec</code></em> = <code class="literal"></code>
    52365246</em></span>
    5237 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559725"></a>
     5247</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559783"></a>
    52385248
    52395249security mask (S)
    5240 </h3></div></div></div><a class="indexterm" name="id2559726"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5250</h3></div></div></div><a class="indexterm" name="id2559784"></a><a name="SECURITYMASK"></a><div class="variablelist"><dl><dt></dt><dd><p>
    52415251        This parameter controls what UNIX permission bits will be set when a Windows NT client is manipulating the
    52425252        UNIX permission on a file using the native NT security dialog box.
     
    52575267</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security mask</code></em> = <code class="literal">0770</code>
    52585268</em></span>
    5259 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559831"></a>
     5269</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2559889"></a>
    52605270
    52615271security (G)
    5262 </h3></div></div></div><a class="indexterm" name="id2559832"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
     5272</h3></div></div></div><a class="indexterm" name="id2559890"></a><a name="SECURITY"></a><div class="variablelist"><dl><dt></dt><dd><p>This option affects how clients respond to
    52635273    Samba and is one of the most important settings in the <code class="filename">
    52645274    smb.conf</code> file.</p><p>The option sets the "security mode bit" in replies to
     
    53845394</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>security</code></em> = <code class="literal">DOMAIN</code>
    53855395</em></span>
    5386 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560716"></a>
     5396</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560768"></a>
    53875397
    53885398server schannel (G)
    5389 </h3></div></div></div><a class="indexterm" name="id2560717"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5399</h3></div></div></div><a class="indexterm" name="id2560770"></a><a name="SERVERSCHANNEL"></a><div class="variablelist"><dl><dt></dt><dd><p>
    53905400        This controls whether the server offers or even demands the use of the netlogon schannel.
    53915401        <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.
     
    53985408</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server schannel</code></em> = <code class="literal">yes</code>
    53995409</em></span>
    5400 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560832"></a>
     5410</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560884"></a>
    54015411
    54025412server signing (G)
    5403 </h3></div></div></div><a class="indexterm" name="id2560833"></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
     5413</h3></div></div></div><a class="indexterm" name="id2560885"></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
    54045414    are <span class="emphasis"><em>auto</em></span>, <span class="emphasis"><em>mandatory</em></span>
    54055415    and <span class="emphasis"><em>disabled</em></span>.
     
    54085418        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>
    54095419</em></span>
    5410 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560893"></a>
     5420</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560945"></a>
    54115421
    54125422server string (G)
    5413 </h3></div></div></div><a class="indexterm" name="id2560894"></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
     5423</h3></div></div></div><a class="indexterm" name="id2560946"></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
    54145424        manager and next to the IPC connection in <code class="literal">net view</code>. It
    54155425        can be any string that you wish to show to your users.</p><p>It also sets what will appear in browse lists next
     
    54205430</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>server string</code></em> = <code class="literal">University of GNUs Samba Server</code>
    54215431</em></span>
    5422 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2560984"></a>
     5432</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561036"></a>
    54235433
    54245434set directory (S)
    5425 </h3></div></div></div><a class="indexterm" name="id2560985"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5435</h3></div></div></div><a class="indexterm" name="id2561038"></a><a name="SETDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54265436        If <code class="literal">set directory = no</code>, then        users of the
    54275437        service may not use the setdir command to change directory.
     
    54325442        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>set directory</code></em> = <code class="literal">no</code>
    54335443</em></span>
    5434 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561044"></a>
     5444</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561096"></a>
    54355445
    54365446set primary group script (G)
    5437 </h3></div></div></div><a class="indexterm" name="id2561045"></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
     5447</h3></div></div></div><a class="indexterm" name="id2561098"></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
    54385448        primary group in addition to the auxiliary groups.  This script
    54395449        sets the primary group in the unix userdatase when an
     
    54475457</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>
    54485458</em></span>
    5449 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561126"></a>
     5459</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561178"></a>
    54505460
    54515461set quota command (G)
    5452 </h3></div></div></div><a class="indexterm" name="id2561127"></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
     5462</h3></div></div></div><a class="indexterm" name="id2561180"></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
    54535463        whenever there is no operating system API available from the OS that
    54545464        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
     
    54605470</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>
    54615471</em></span>
    5462 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561290"></a>
     5472</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561342"></a>
    54635473
    54645474share:fake_fscaps (G)
    5465 </h3></div></div></div><a class="indexterm" name="id2561291"></a><a name="SHARE:FAKE_FSCAPS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5475</h3></div></div></div><a class="indexterm" name="id2561343"></a><a name="SHARE:FAKE_FSCAPS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54665476        This is needed to support some special application that makes
    54675477        QFSINFO calls to check whether we set the SPARSE_FILES bit
     
    54735483        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>share:fake_fscaps</code></em> = <code class="literal">0</code>
    54745484</em></span>
    5475 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561349"></a>
     5485</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561401"></a>
    54765486
    54775487share modes (S)
    5478 </h3></div></div></div><a class="indexterm" name="id2561350"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
     5488</h3></div></div></div><a class="indexterm" name="id2561402"></a><a name="SHAREMODES"></a><div class="variablelist"><dl><dt></dt><dd><p>This enables or disables the honoring of
    54795489        the <em class="parameter"><code>share modes</code></em> during a file open. These
    54805490        modes are used by clients to gain exclusive read or write access
     
    54885498        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>
    54895499</em></span>
    5490 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561426"></a>
     5500</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561478"></a>
    54915501
    54925502short preserve case (S)
    5493 </h3></div></div></div><a class="indexterm" name="id2561427"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5503</h3></div></div></div><a class="indexterm" name="id2561479"></a><a name="SHORTPRESERVECASE"></a><div class="variablelist"><dl><dt></dt><dd><p>
    54945504        This boolean parameter controls if new files which conform to 8.3 syntax, that is all in upper case and of
    54955505        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>.
     
    54985508        </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>
    54995509</em></span>
    5500 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561505"></a>
     5510</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561557"></a>
    55015511
    55025512show add printer wizard (G)
    5503 </h3></div></div></div><a class="indexterm" name="id2561506"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
     5513</h3></div></div></div><a class="indexterm" name="id2561558"></a><a name="SHOWADDPRINTERWIZARD"></a><div class="variablelist"><dl><dt></dt><dd><p>With the introduction of MS-RPC based printing support
    55045514    for Windows NT/2000 client in Samba 2.2, a "Printers..." folder will
    55055515    appear on Samba hosts in the share listing.  Normally this folder will
     
    55195529                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>
    55205530</em></span>
    5521 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561588"></a>
     5531</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561640"></a>
    55225532
    55235533shutdown script (G)
    5524 </h3></div></div></div><a class="indexterm" name="id2561589"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
     5534</h3></div></div></div><a class="indexterm" name="id2561642"></a><a name="SHUTDOWNSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This a full path name to a script called by
    55255535         <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> that should
    55265536        start a shutdown procedure.</p><p>If the connected user posseses the <code class="constant">SeRemoteShutdownPrivilege</code>,
     
    55485558</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>
    55495559</em></span>
    5550 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561742"></a>
     5560</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561794"></a>
    55515561
    55525562smb encrypt (S)
    5553 </h3></div></div></div><a class="indexterm" name="id2561743"></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
     5563</h3></div></div></div><a class="indexterm" name="id2561796"></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
    55545564    extension to the SMB/CIFS protocol negotiated as part of the UNIX extensions.
    55555565    SMB encryption uses the GSSAPI (SSPI on Windows) ability to encrypt
     
    55795589    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>
    55805590</em></span>
    5581 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561855"></a>
     5591</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561911"></a>
    55825592
    55835593smb passwd file (G)
    5584 </h3></div></div></div><a class="indexterm" name="id2561856"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
     5594</h3></div></div></div><a class="indexterm" name="id2561912"></a><a name="SMBPASSWDFILE"></a><div class="variablelist"><dl><dt></dt><dd><p>This option sets the path to the encrypted smbpasswd file. By
    55855595    default the path to the smbpasswd file  is compiled into Samba.</p><p>
    55865596    An example of use is:
     
    55905600    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>smb passwd file</code></em> = <code class="literal">${prefix}/private/smbpasswd</code>
    55915601</em></span>
    5592 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561908"></a>
     5602</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561965"></a>
    55935603
    55945604smb ports (G)
    5595 </h3></div></div></div><a class="indexterm" name="id2561909"></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>
    5596 </em></span>
    5597 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2561950"></a>
     5605</h3></div></div></div><a class="indexterm" name="id2561966"></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>
     5606</em></span>
     5607</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562007"></a>
    55985608
    55995609socket address (G)
    5600 </h3></div></div></div><a class="indexterm" name="id2561951"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
     5610</h3></div></div></div><a class="indexterm" name="id2562008"></a><a name="SOCKETADDRESS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to control what
    56015611        address Samba will listen for connections on. This is used to
    56025612        support multiple virtual interfaces on the one server, each
     
    56075617</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket address</code></em> = <code class="literal">192.168.2.20</code>
    56085618</em></span>
    5609 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562020"></a>
     5619</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562076"></a>
    56105620
    56115621socket options (G)
    5612 </h3></div></div></div><a class="indexterm" name="id2562021"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
     5622</h3></div></div></div><a class="indexterm" name="id2562078"></a><a name="SOCKETOPTIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option allows you to set socket options
    56135623    to be used when talking with the client.</p><p>Socket options are controls on the networking layer
    56145624    of the operating systems which allow the connection to be
     
    56385648</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>socket options</code></em> = <code class="literal">IPTOS_LOWDELAY</code>
    56395649</em></span>
    5640 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562231"></a>
     5650</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562287"></a>
    56415651
    56425652stat cache (G)
    5643 </h3></div></div></div><a class="indexterm" name="id2562232"></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
     5653</h3></div></div></div><a class="indexterm" name="id2562288"></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
    56445654        speed up case insensitive name mappings. You should never need
    56455655        to change this parameter.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>stat cache</code></em> = <code class="literal">yes</code>
    56465656</em></span>
    5647 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562282"></a>
     5657</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562338"></a>
    56485658
    56495659state directory (G)
    5650 </h3></div></div></div><a class="indexterm" name="id2562283"></a><a name="STATEDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>Usually, most of the TDB files are stored in the
     5660</h3></div></div></div><a class="indexterm" name="id2562339"></a><a name="STATEDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>Usually, most of the TDB files are stored in the
    56515661        <em class="parameter"><code>lock directory</code></em>. Since
    56525662        Samba 3.4.0, it is possible to differentiate between TDB files
     
    56605670</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>state directory</code></em> = <code class="literal">/var/run/samba/locks/state</code>
    56615671</em></span>
    5662 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562368"></a>
     5672</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562424"></a>
    56635673
    56645674store dos attributes (S)
    5665 </h3></div></div></div><a class="indexterm" name="id2562369"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5675</h3></div></div></div><a class="indexterm" name="id2562425"></a><a name="STOREDOSATTRIBUTES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    56665676        If this parameter is set Samba attempts to first read DOS attributes (SYSTEM, HIDDEN, ARCHIVE or
    56675677        READ-ONLY) from a filesystem extended attribute, before mapping DOS attributes to UNIX permission bits (such
     
    56825692        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>store dos attributes</code></em> = <code class="literal">no</code>
    56835693</em></span>
    5684 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562498"></a>
     5694</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562554"></a>
    56855695
    56865696strict allocate (S)
    5687 </h3></div></div></div><a class="indexterm" name="id2562499"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
    5688     disk space allocation in the server. When this is set to <code class="constant">yes</code> 
     5697</h3></div></div></div><a class="indexterm" name="id2562555"></a><a name="STRICTALLOCATE"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean that controls the handling of
     5698    disk space allocation in the server. When this is set to <code class="constant">yes</code>
    56895699    the server will change from UNIX behaviour of not committing real
    56905700    disk storage blocks when a file is extended to the Windows behaviour
     
    56925702    when a file is created or extended to be a given size. In UNIX
    56935703    terminology this means that Samba will stop creating sparse files.
    5694     This can be slow on some systems.</p><p>When strict allocate is <code class="constant">no</code> the server does sparse
    5695     disk block allocation when a file is extended.</p><p>Setting this to <code class="constant">yes</code> can help Samba return
    5696     out of quota messages on systems that are restricting the disk quota
    5697     of users.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict allocate</code></em> = <code class="literal">no</code>
    5698 </em></span>
    5699 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562568"></a>
     5704    This can be slow on some systems. When you work with large files like
     5705    &gt;100MB or so you may even run into problems with clients running into
     5706    timeouts.</p><p>When you have an extent based filesystem it's likely that we can make
     5707    use of unwritten extents which allows Samba to allocate even large amounts
     5708    of space very fast and you will not see any timeout problems caused by
     5709    strict allocate. With strict allocate in use you will also get much better
     5710    out of quota messages in case you use quotas. Another advantage of
     5711    activating this setting is that it will help to reduce file
     5712    fragmentation.</p><p>To give you an idea on which filesystems this setting might currently
     5713    be a good option for you: XFS, ext4, btrfs, ocfs2 on Linux and JFS2 on
     5714    AIX support unwritten extents. On Filesystems that do not support it,
     5715    preallocation is probably an expensive operation where you will see reduced
     5716    performance and risk to let clients run into timeouts when creating large
     5717    files. Examples are ext3, ZFS, HFS+ and most others, so be aware if you
     5718    activate this setting on those filesystems.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict allocate</code></em> = <code class="literal">no</code>
     5719</em></span>
     5720</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562638"></a>
    57005721
    57015722strict locking (S)
    5702 </h3></div></div></div><a class="indexterm" name="id2562570"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5723</h3></div></div></div><a class="indexterm" name="id2562639"></a><a name="STRICTLOCKING"></a><div class="variablelist"><dl><dt></dt><dd><p>
    57035724        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>,
    57045725        the server will check every read and write access for file locks, and deny access if locks exist. This can be slow on
     
    57165737        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>strict locking</code></em> = <code class="literal">Auto</code>
    57175738</em></span>
    5718 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562648"></a>
     5739</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562718"></a>
    57195740
    57205741strict sync (S)
    5721 </h3></div></div></div><a class="indexterm" name="id2562649"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
     5742</h3></div></div></div><a class="indexterm" name="id2562719"></a><a name="STRICTSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>Many Windows applications (including the Windows 98 explorer
    57225743    shell) seem to confuse flushing buffer contents to disk with doing
    57235744    a sync to disk. Under UNIX, a sync call forces the process to be
     
    57335754    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>
    57345755</em></span>
    5735 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562713"></a>
     5756</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562783"></a>
    57365757
    57375758svcctl list (G)
    5738 </h3></div></div></div><a class="indexterm" name="id2562714"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
     5759</h3></div></div></div><a class="indexterm" name="id2562784"></a><a name="SVCCTLLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This option defines a list of init scripts that smbd
    57395760    will use for starting and stopping Unix services via the Win32
    57405761    ServiceControl API.  This allows Windows administrators to
     
    57495770</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>svcctl list</code></em> = <code class="literal">cups postfix portmap httpd</code>
    57505771</em></span>
    5751 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562799"></a>
     5772</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562869"></a>
    57525773
    57535774sync always (S)
    5754 </h3></div></div></div><a class="indexterm" name="id2562800"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
     5775</h3></div></div></div><a class="indexterm" name="id2562870"></a><a name="SYNCALWAYS"></a><div class="variablelist"><dl><dt></dt><dd><p>This is a boolean parameter that controls
    57555776    whether writes will always be written to stable storage before
    57565777    the write call returns. If this is <code class="constant">no</code> then the server will be
     
    57635784    any effect.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>sync always</code></em> = <code class="literal">no</code>
    57645785</em></span>
    5765 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562871"></a>
     5786</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562940"></a>
    57665787
    57675788syslog only (G)
    5768 </h3></div></div></div><a class="indexterm" name="id2562872"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5789</h3></div></div></div><a class="indexterm" name="id2562942"></a><a name="SYSLOGONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    57695790    If this parameter is set then Samba debug messages are logged into the system
    57705791    syslog only, and not to the debug log files. There still will be some
     
    57725793    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog only</code></em> = <code class="literal">no</code>
    57735794</em></span>
    5774 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562918"></a>
     5795</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562988"></a>
    57755796
    57765797syslog (G)
    5777 </h3></div></div></div><a class="indexterm" name="id2562919"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5798</h3></div></div></div><a class="indexterm" name="id2562989"></a><a name="SYSLOG"></a><div class="variablelist"><dl><dt></dt><dd><p>
    57785799    This parameter maps how Samba debug messages are logged onto the system syslog logging levels.
    57795800    Samba debug level zero maps onto syslog <code class="constant">LOG_ERR</code>, debug level one maps onto
     
    57865807    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>syslog</code></em> = <code class="literal">1</code>
    57875808</em></span>
    5788 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2562989"></a>
     5809</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563058"></a>
    57895810
    57905811template homedir (G)
    5791 </h3></div></div></div><a class="indexterm" name="id2562990"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5812</h3></div></div></div><a class="indexterm" name="id2563060"></a><a name="TEMPLATEHOMEDIR"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    57925813        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon  uses this
    57935814        parameter to fill in the home directory for that user. If the
     
    57975818        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>
    57985819</em></span>
    5799 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563054"></a>
     5820</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563124"></a>
    58005821
    58015822template shell (G)
    5802 </h3></div></div></div><a class="indexterm" name="id2563055"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
     5823</h3></div></div></div><a class="indexterm" name="id2563125"></a><a name="TEMPLATESHELL"></a><div class="variablelist"><dl><dt></dt><dd><p>When filling out the user information for a Windows NT
    58035824        user, the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon uses this
    5804         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="id2563094"></a>
     5825        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="id2563163"></a>
    58055826
    58065827time offset (G)
    5807 </h3></div></div></div><a class="indexterm" name="id2563095"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
     5828</h3></div></div></div><a class="indexterm" name="id2563164"></a><a name="TIMEOFFSET"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is a setting in minutes to add
    58085829        to the normal GMT to local time conversion. This is useful if
    58095830        you are serving a lot of PCs that have incorrect daylight
     
    58125833</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>time offset</code></em> = <code class="literal">60</code>
    58135834</em></span>
    5814 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563154"></a>
     5835</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563223"></a>
    58155836
    58165837time server (G)
    5817 </h3></div></div></div><a class="indexterm" name="id2563155"></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
     5838</h3></div></div></div><a class="indexterm" name="id2563224"></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
    58185839clients.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>time server</code></em> = <code class="literal">no</code>
    58195840</em></span>
    5820 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563204"></a>
     5841</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563274"></a>
    58215842
    58225843unix charset (G)
    5823 </h3></div></div></div><a class="indexterm" name="id2563205"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
     5844</h3></div></div></div><a class="indexterm" name="id2563275"></a><a name="UNIXCHARSET"></a><div class="variablelist"><dl><dt></dt><dd><p>Specifies the charset the unix machine
    58245845                Samba runs on uses. Samba needs to know this in order to be able to
    58255846                convert text to the charsets other SMB clients use.
     
    58305851</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>unix charset</code></em> = <code class="literal">ASCII</code>
    58315852</em></span>
    5832 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563270"></a>
     5853</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563340"></a>
    58335854
    58345855unix extensions (G)
    5835 </h3></div></div></div><a class="indexterm" name="id2563271"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5856</h3></div></div></div><a class="indexterm" name="id2563341"></a><a name="UNIXEXTENSIONS"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    58365857    implements the CIFS UNIX extensions, as defined by HP.
    58375858    These extensions enable Samba to better serve UNIX CIFS clients
     
    58435864    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>unix extensions</code></em> = <code class="literal">yes</code>
    58445865</em></span>
    5845 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563335"></a>
     5866</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563404"></a>
    58465867
    58475868unix password sync (G)
    5848 </h3></div></div></div><a class="indexterm" name="id2563336"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
     5869</h3></div></div></div><a class="indexterm" name="id2563406"></a><a name="UNIXPASSWORDSYNC"></a><div class="variablelist"><dl><dt></dt><dd><p>This boolean parameter controls whether Samba
    58495870    attempts to synchronize the UNIX password with the SMB password
    58505871    when the encrypted SMB password in the smbpasswd file is changed.
     
    58555876        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>
    58565877</em></span>
    5857 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563396"></a>
     5878</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563466"></a>
    58585879
    58595880update encrypted (G)
    5860 </h3></div></div></div><a class="indexterm" name="id2563397"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5881</h3></div></div></div><a class="indexterm" name="id2563467"></a><a name="UPDATEENCRYPTED"></a><div class="variablelist"><dl><dt></dt><dd><p>
    58615882        This boolean parameter allows a user logging on with a plaintext password to have their encrypted (hashed)
    58625883        password in the smbpasswd file to be updated automatically as they log on. This option allows a site to
     
    58765897        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>update encrypted</code></em> = <code class="literal">no</code>
    58775898</em></span>
    5878 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563527"></a>
     5899</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563583"></a>
    58795900
    58805901use client driver (S)
    5881 </h3></div></div></div><a class="indexterm" name="id2563528"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
     5902</h3></div></div></div><a class="indexterm" name="id2563584"></a><a name="USECLIENTDRIVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter applies only to Windows NT/2000
    58825903    clients.  It has no effect on Windows 95/98/ME clients.  When
    58835904    serving a printer to Windows NT/2000 clients without first installing
     
    59045925        server.</em></span></p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use client driver</code></em> = <code class="literal">no</code>
    59055926</em></span>
    5906 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563608"></a>
     5927</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563676"></a>
    59075928
    59085929use mmap (G)
    5909 </h3></div></div></div><a class="indexterm" name="id2563609"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
     5930</h3></div></div></div><a class="indexterm" name="id2563677"></a><a name="USEMMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>This global parameter determines if the tdb internals of Samba can
    59105931    depend on mmap working correctly on the running system. Samba requires a coherent
    59115932    mmap/read-write system memory cache. Currently only HPUX does not have such a
     
    59165937    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use mmap</code></em> = <code class="literal">yes</code>
    59175938</em></span>
    5918 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563660"></a>
     5939</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563728"></a>
    59195940
    59205941username level (G)
    5921 </h3></div></div></div><a class="indexterm" name="id2563661"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
     5942</h3></div></div></div><a class="indexterm" name="id2563729"></a><a name="USERNAMELEVEL"></a><div class="variablelist"><dl><dt></dt><dd><p>This option helps Samba to try and 'guess' at
    59225943    the real UNIX username, as many DOS clients send an all-uppercase
    59235944    username. By default Samba tries all lowercase, followed by the
     
    59345955</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username level</code></em> = <code class="literal">5</code>
    59355956</em></span>
    5936 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563742"></a>
     5957</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563810"></a>
    59375958
    59385959username map script (G)
    5939 </h3></div></div></div><a class="indexterm" name="id2563743"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
     5960</h3></div></div></div><a class="indexterm" name="id2563811"></a><a name="USERNAMEMAPSCRIPT"></a><div class="variablelist"><dl><dt></dt><dd><p>This script is a mutually exclusive alternative to the
    59405961        <a class="link" href="smb.conf.5.html#USERNAMEMAP" target="_top">username map</a> parameter.  This parameter
    59415962        specifies and external program or script that must accept a single
     
    59485969</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>
    59495970</em></span>
    5950 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563818"></a>
     5971</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2563886"></a>
    59515972
    59525973username map (G)
    5953 </h3></div></div></div><a class="indexterm" name="id2563820"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     5974</h3></div></div></div><a class="indexterm" name="id2563887"></a><a name="USERNAMEMAP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    59545975        This option allows you to specify a file containing a mapping of usernames from the clients to the server.
    59555976        This can be used for several purposes. The most common is to map usernames that users use on DOS or Windows
     
    60356056# no username map</code>
    60366057</em></span>
    6037 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564098"></a>
     6058</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564166"></a>
    60386059
    60396060<a name="USER"></a>user
    6040 </h3></div></div></div><a class="indexterm" name="id2564099"></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="id2564130"></a>
     6061</h3></div></div></div><a class="indexterm" name="id2564167"></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="id2564198"></a>
    60416062
    60426063<a name="USERS"></a>users
    6043 </h3></div></div></div><a class="indexterm" name="id2564131"></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="id2564162"></a>
     6064</h3></div></div></div><a class="indexterm" name="id2564199"></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="id2564229"></a>
    60446065
    60456066username (S)
    6046 </h3></div></div></div><a class="indexterm" name="id2564163"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
     6067</h3></div></div></div><a class="indexterm" name="id2564230"></a><a name="USERNAME"></a><div class="variablelist"><dl><dt></dt><dd><p>Multiple users may be specified in a comma-delimited
    60476068    list, in which case the supplied password will be tested against
    60486069    each username in turn (left to right).</p><p>The <em class="parameter"><code>username</code></em> line is needed only when
     
    60826103</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>username</code></em> = <code class="literal">fred, mary, jack, jane, @users, @pcgroup</code>
    60836104</em></span>
    6084 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564332"></a>
     6105</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564400"></a>
    60856106
    60866107usershare allow guests (G)
    6087 </h3></div></div></div><a class="indexterm" name="id2564333"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
     6108</h3></div></div></div><a class="indexterm" name="id2564401"></a><a name="USERSHAREALLOWGUESTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether user defined shares are allowed
    60886109        to be accessed by non-authenticated users or not. It is the equivalent
    60896110        of allowing people who can create a share the option of setting
     
    60926113        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>
    60936114</em></span>
    6094 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564385"></a>
     6115</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564452"></a>
    60956116
    60966117usershare max shares (G)
    6097 </h3></div></div></div><a class="indexterm" name="id2564386"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
     6118</h3></div></div></div><a class="indexterm" name="id2564453"></a><a name="USERSHAREMAXSHARES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of user defined shares
    60986119        that are allowed to be created by users belonging to the group owning the
    60996120        usershare directory. If set to zero (the default) user defined shares are ignored.
    61006121        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare max shares</code></em> = <code class="literal">0</code>
    61016122</em></span>
    6102 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564430"></a>
     6123</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564498"></a>
    61036124
    61046125usershare owner only (G)
    6105 </h3></div></div></div><a class="indexterm" name="id2564431"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
     6126</h3></div></div></div><a class="indexterm" name="id2564499"></a><a name="USERSHAREOWNERONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether the pathname exported by
    61066127        a user defined shares must be owned by the user creating the
    61076128        user defined share or not. If set to True (the default) then
     
    61136134        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare owner only</code></em> = <code class="literal">True</code>
    61146135</em></span>
    6115 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564480"></a>
     6136</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564547"></a>
    61166137
    61176138usershare path (G)
    6118 </h3></div></div></div><a class="indexterm" name="id2564481"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
     6139</h3></div></div></div><a class="indexterm" name="id2564548"></a><a name="USERSHAREPATH"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the absolute path of the directory on the
    61196140        filesystem used to store the user defined share definition files.
    61206141        This directory must be owned by root, and have no access for
     
    61376158        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>usershare path</code></em> = <code class="literal">NULL</code>
    61386159</em></span>
    6139 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564551"></a>
     6160</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564618"></a>
    61406161
    61416162usershare prefix allow list (G)
    6142 </h3></div></div></div><a class="indexterm" name="id2564552"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     6163</h3></div></div></div><a class="indexterm" name="id2564619"></a><a name="USERSHAREPREFIXALLOWLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    61436164        the root of which are allowed to be exported by user defined share definitions.
    61446165        If the pathname to be exported doesn't start with one of the strings in this
     
    61556176</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix allow list</code></em> = <code class="literal">/home /data /space</code>
    61566177</em></span>
    6157 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564630"></a>
     6178</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564691"></a>
    61586179
    61596180usershare prefix deny list (G)
    6160 </h3></div></div></div><a class="indexterm" name="id2564631"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
     6181</h3></div></div></div><a class="indexterm" name="id2564692"></a><a name="USERSHAREPREFIXDENYLIST"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies a list of absolute pathnames
    61616182        the root of which are NOT allowed to be exported by user defined share definitions.
    61626183        If the pathname exported starts with one of the strings in this
     
    61746195</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare prefix deny list</code></em> = <code class="literal">/etc /dev /private</code>
    61756196</em></span>
    6176 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564704"></a>
     6197</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564766"></a>
    61776198
    61786199usershare template share (G)
    6179 </h3></div></div></div><a class="indexterm" name="id2564706"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
     6200</h3></div></div></div><a class="indexterm" name="id2564767"></a><a name="USERSHARETEMPLATESHARE"></a><div class="variablelist"><dl><dt></dt><dd><p>User defined shares only have limited possible parameters
    61806201        such as path, guest ok, etc. This parameter allows usershares to
    61816202        "cloned" from an existing share. If "usershare template share"
     
    61926213</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>usershare template share</code></em> = <code class="literal">template_share</code>
    61936214</em></span>
    6194 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564778"></a>
     6215</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564839"></a>
    61956216
    61966217use sendfile (S)
    6197 </h3></div></div></div><a class="indexterm" name="id2564779"></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>
     6218</h3></div></div></div><a class="indexterm" name="id2564840"></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>
    61986219    system call is supported by the underlying operating system, then some SMB read calls
    61996220    (mainly ReadAndX and ReadRaw) will use the more efficient sendfile system call for files that
     
    62046225    </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use sendfile</code></em> = <code class="literal">false</code>
    62056226</em></span>
    6206 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564835"></a>
     6227</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564896"></a>
    62076228
    62086229use spnego (G)
    6209 </h3></div></div></div><a class="indexterm" name="id2564836"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
     6230</h3></div></div></div><a class="indexterm" name="id2564897"></a><a name="USESPNEGO"></a><div class="variablelist"><dl><dt></dt><dd><p>This variable controls controls whether samba will try
    62106231    to use Simple and Protected NEGOciation (as specified by rfc2478) with
    62116232    WindowsXP and Windows2000 clients to agree upon an authentication mechanism.
     
    62156236        disabled.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>use spnego</code></em> = <code class="literal">yes</code>
    62166237</em></span>
    6217 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564885"></a>
     6238</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564946"></a>
    62186239
    62196240utmp directory (G)
    6220 </h3></div></div></div><a class="indexterm" name="id2564886"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
     6241</h3></div></div></div><a class="indexterm" name="id2564947"></a><a name="UTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is only available if Samba has
    62216242        been configured and compiled with the option <code class="literal">
    62226243        --with-utmp</code>. It specifies a directory pathname that is
     
    62306251</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>utmp directory</code></em> = <code class="literal">/var/run/utmp</code>
    62316252</em></span>
    6232 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2564963"></a>
     6253</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565024"></a>
    62336254
    62346255utmp (G)
    6235 </h3></div></div></div><a class="indexterm" name="id2564964"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6256</h3></div></div></div><a class="indexterm" name="id2565025"></a><a name="UTMP"></a><div class="variablelist"><dl><dt></dt><dd><p>
    62366257        This boolean parameter is only available if Samba has been configured and compiled 
    62376258        with the option <code class="literal">--with-utmp</code>. If set to
     
    62456266        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>utmp</code></em> = <code class="literal">no</code>
    62466267</em></span>
    6247 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565025"></a>
     6268</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565086"></a>
    62486269
    62496270valid users (S)
    6250 </h3></div></div></div><a class="indexterm" name="id2565026"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6271</h3></div></div></div><a class="indexterm" name="id2565087"></a><a name="VALIDUSERS"></a><div class="variablelist"><dl><dt></dt><dd><p>
    62516272    This is a list of users that should be allowed to login to this service. Names starting with
    62526273    '@', '+' and  '&amp;' are interpreted using the same rules as described in the
     
    62646285</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>valid users</code></em> = <code class="literal">greg, @pcusers</code>
    62656286</em></span>
    6266 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565117"></a>
     6287</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565178"></a>
    62676288
    62686289-valid (S)
    6269 </h3></div></div></div><a class="indexterm" name="id2565118"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
     6290</h3></div></div></div><a class="indexterm" name="id2565179"></a><a name="-VALID"></a><div class="variablelist"><dl><dt></dt><dd><p> This parameter indicates whether a share is
    62706291        valid and thus can be used. When this parameter is set to false,
    62716292        the share will be in no way visible nor accessible.
     
    62766297        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>-valid</code></em> = <code class="literal">yes</code>
    62776298</em></span>
    6278 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565166"></a>
     6299</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565227"></a>
    62796300
    62806301veto files (S)
    6281 </h3></div></div></div><a class="indexterm" name="id2565167"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6302</h3></div></div></div><a class="indexterm" name="id2565228"></a><a name="VETOFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    62826303        This is a list of files and directories that are neither visible nor accessible.  Each entry in
    62836304        the list must be separated by a '/', which allows spaces to be included in the entry. '*' and '?'
     
    63106331        </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>
    63116332</em></span>
    6312 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565285"></a>
     6333</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565346"></a>
    63136334
    63146335veto oplock files (S)
    6315 </h3></div></div></div><a class="indexterm" name="id2565286"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6336</h3></div></div></div><a class="indexterm" name="id2565347"></a><a name="VETOOPLOCKFILES"></a><div class="variablelist"><dl><dt></dt><dd><p>
    63166337        This parameter is only valid when the <a class="link" href="smb.conf.5.html#OPLOCKS" target="_top">oplocks</a>
    63176338        parameter is turned on for a share. It allows the Samba administrator
     
    63346355# No files are vetoed for oplock grants</code>
    63356356</em></span>
    6336 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565378"></a>
     6357</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565439"></a>
    63376358
    63386359<a name="VFSOBJECT"></a>vfs object
    6339 </h3></div></div></div><a class="indexterm" name="id2565379"></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="id2565410"></a>
     6360</h3></div></div></div><a class="indexterm" name="id2565440"></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="id2565471"></a>
    63406361
    63416362vfs objects (S)
    6342 </h3></div></div></div><a class="indexterm" name="id2565411"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
     6363</h3></div></div></div><a class="indexterm" name="id2565472"></a><a name="VFSOBJECTS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the backend names which
    63436364        are used for Samba VFS I/O operations.  By default, normal
    63446365        disk I/O operations are used but these can be overloaded
     
    63476368</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>vfs objects</code></em> = <code class="literal">extd_audit recycle</code>
    63486369</em></span>
    6349 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565470"></a>
     6370</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565531"></a>
    63506371
    63516372volume (S)
    6352 </h3></div></div></div><a class="indexterm" name="id2565471"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
     6373</h3></div></div></div><a class="indexterm" name="id2565532"></a><a name="VOLUME"></a><div class="variablelist"><dl><dt></dt><dd><p>This allows you to override the volume label
    63536374        returned for a share. Useful for CDROMs with installation programs
    63546375        that insist on a particular volume label.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>volume</code></em> = <code class="literal">
    63556376# the name of the share</code>
    63566377</em></span>
    6357 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565514"></a>
     6378</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565575"></a>
    63586379
    63596380wide links (S)
    6360 </h3></div></div></div><a class="indexterm" name="id2565515"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
     6381</h3></div></div></div><a class="indexterm" name="id2565576"></a><a name="WIDELINKS"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not links
    63616382        in the UNIX file system may be followed by the server. Links
    63626383        that point to areas within the directory tree exported by the
     
    63716392        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>wide links</code></em> = <code class="literal">no</code>
    63726393</em></span>
    6373 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565582"></a>
     6394</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565643"></a>
    63746395
    63756396winbind cache time (G)
    6376 </h3></div></div></div><a class="indexterm" name="id2565583"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
     6397</h3></div></div></div><a class="indexterm" name="id2565644"></a><a name="WINBINDCACHETIME"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
    63776398        seconds the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon will cache
    63786399        user and group information before querying a Windows NT server
     
    63826403        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind cache time</code></em> = <code class="literal">300</code>
    63836404</em></span>
    6384 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565653"></a>
     6405</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565714"></a>
    63856406
    63866407winbind enum groups (G)
    6387 </h3></div></div></div><a class="indexterm" name="id2565654"></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
     6408</h3></div></div></div><a class="indexterm" name="id2565715"></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
    63886409        the enumeration of groups through the <code class="literal">setgrent()</code>,
    63896410        <code class="literal">getgrent()</code> and
     
    63936414        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>
    63946415</em></span>
    6395 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565744"></a>
     6416</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565805"></a>
    63966417
    63976418winbind enum users (G)
    6398 </h3></div></div></div><a class="indexterm" name="id2565745"></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
     6419</h3></div></div></div><a class="indexterm" name="id2565806"></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
    63996420        necessary to suppress the enumeration of users through the <code class="literal">setpwent()</code>,
    64006421         <code class="literal">getpwent()</code> and
     
    64086429        usernames. </p></div><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind enum users</code></em> = <code class="literal">no</code>
    64096430</em></span>
    6410 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565837"></a>
     6431</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565898"></a>
    64116432
    64126433winbind expand groups (G)
    6413 </h3></div></div></div><a class="indexterm" name="id2565838"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
     6434</h3></div></div></div><a class="indexterm" name="id2565899"></a><a name="WINBINDEXPANDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>This option controls the maximum depth that winbindd
    64146435              will traverse when flattening nested group memberships
    64156436              of Windows domain groups.  This is different from the
     
    64236444         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>
    64246445</em></span>
    6425 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565906"></a>
     6446</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565967"></a>
    64266447
    64276448winbind nested groups (G)
    6428 </h3></div></div></div><a class="indexterm" name="id2565907"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
     6449</h3></div></div></div><a class="indexterm" name="id2565968"></a><a name="WINBINDNESTEDGROUPS"></a><div class="variablelist"><dl><dt></dt><dd><p>If set to yes, this parameter activates the support for nested
    64296450                 groups. Nested groups are also called local groups or
    64306451                 aliases. They work like their counterparts in Windows: Nested
     
    64346455                 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>
    64356456</em></span>
    6436 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2565956"></a>
     6457</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566017"></a>
    64376458
    64386459winbind normalize names (G)
    6439 </h3></div></div></div><a class="indexterm" name="id2565957"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
     6460</h3></div></div></div><a class="indexterm" name="id2566018"></a><a name="WINBINDNORMALIZENAMES"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether winbindd will replace
    64406461          whitespace in user and group names with an underscore (_) character.
    64416462          For example, whether the name "Space Kadet" should be
     
    64576478</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind normalize names</code></em> = <code class="literal">yes</code>
    64586479</em></span>
    6459 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566034"></a>
     6480</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566095"></a>
    64606481
    64616482winbind nss info (G)
    6462 </h3></div></div></div><a class="indexterm" name="id2566035"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
     6483</h3></div></div></div><a class="indexterm" name="id2566096"></a><a name="WINBINDNSSINFO"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control how Winbind retrieves Name
    64636484        Service Information to construct a user's home directory and login shell.
    64646485        Currently the following settings are available:
     
    64826503</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind nss info</code></em> = <code class="literal">template sfu</code>
    64836504</em></span>
    6484 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566154"></a>
     6505</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566215"></a>
    64856506
    64866507winbind offline logon (G)
    6487 </h3></div></div></div><a class="indexterm" name="id2566155"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
     6508</h3></div></div></div><a class="indexterm" name="id2566216"></a><a name="WINBINDOFFLINELOGON"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter is designed to control whether Winbind should
    64886509        allow to login with the <em class="parameter"><code>pam_winbind</code></em>
    64896510        module using Cached Credentials. If enabled, winbindd will store user credentials
     
    64936514</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind offline logon</code></em> = <code class="literal">true</code>
    64946515</em></span>
    6495 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566223"></a>
     6516</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566284"></a>
    64966517
    64976518winbind reconnect delay (G)
    6498 </h3></div></div></div><a class="indexterm" name="id2566224"></a><a name="WINBINDRECONNECTDELAY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
     6519</h3></div></div></div><a class="indexterm" name="id2566285"></a><a name="WINBINDRECONNECTDELAY"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies the number of
    64996520        seconds the <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon will wait between
    65006521        attempts to contact a Domain controller for a domain that is
    65016522        determined to be down or not contactable.</p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind reconnect delay</code></em> = <code class="literal">30</code>
    65026523</em></span>
    6503 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566276"></a>
     6524</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566337"></a>
    65046525
    65056526winbind refresh tickets (G)
    6506 </h3></div></div></div><a class="indexterm" name="id2566277"></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
     6527</h3></div></div></div><a class="indexterm" name="id2566338"></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
    65076528        retrieved using the <em class="parameter"><code>pam_winbind</code></em> module.
    65086529
     
    65116532</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind refresh tickets</code></em> = <code class="literal">true</code>
    65126533</em></span>
    6513 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566343"></a>
     6534</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566404"></a>
    65146535
    65156536winbind rpc only (G)
    6516 </h3></div></div></div><a class="indexterm" name="id2566344"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6537</h3></div></div></div><a class="indexterm" name="id2566405"></a><a name="WINBINDRPCONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    65176538        Setting this parameter to <code class="literal">yes</code> forces
    65186539        winbindd to use RPC instead of LDAP to retrieve information from Domain
     
    65206541        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind rpc only</code></em> = <code class="literal">no</code>
    65216542</em></span>
    6522 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566392"></a>
     6543</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566453"></a>
    65236544
    65246545winbind separator (G)
    6525 </h3></div></div></div><a class="indexterm" name="id2566393"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
     6546</h3></div></div></div><a class="indexterm" name="id2566454"></a><a name="WINBINDSEPARATOR"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter allows an admin to define the character
    65266547        used when listing a username of the form of <em class="replaceable"><code>DOMAIN
    65276548        </code></em>\<em class="replaceable"><code>user</code></em>.  This parameter
     
    65346555</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind separator</code></em> = <code class="literal">+</code>
    65356556</em></span>
    6536 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566479"></a>
     6557</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566540"></a>
    65376558
    65386559winbind trusted domains only (G)
    6539 </h3></div></div></div><a class="indexterm" name="id2566480"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6560</h3></div></div></div><a class="indexterm" name="id2566541"></a><a name="WINBINDTRUSTEDDOMAINSONLY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    65406561        This parameter is designed to allow Samba servers that are members
    65416562        of a Samba controlled domain to use UNIX accounts distributed via NIS,
     
    65486569        </p><p>Default: <span class="emphasis"><em><em class="parameter"><code>winbind trusted domains only</code></em> = <code class="literal">no</code>
    65496570</em></span>
    6550 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566546"></a>
     6571</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566607"></a>
    65516572
    65526573winbind use default domain (G)
    6553 </h3></div></div></div><a class="indexterm" name="id2566547"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
     6574</h3></div></div></div><a class="indexterm" name="id2566608"></a><a name="WINBINDUSEDEFAULTDOMAIN"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter specifies whether the
    65546575         <a class="citerefentry" href="winbindd.8.html"><span class="citerefentry"><span class="refentrytitle">winbindd</span>(8)</span></a> daemon should operate on users 
    65556576        without domain component in their username. Users without a domain
     
    65616582</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>winbind use default domain</code></em> = <code class="literal">yes</code>
    65626583</em></span>
    6563 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566619"></a>
     6584</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566680"></a>
    65646585
    65656586wins hook (G)
    6566 </h3></div></div></div><a class="indexterm" name="id2566620"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
     6587</h3></div></div></div><a class="indexterm" name="id2566681"></a><a name="WINSHOOK"></a><div class="variablelist"><dl><dt></dt><dd><p>When Samba is running as a WINS server this
    65676588        allows you to call an external program for all changes to the
    65686589        WINS database. The primary use for this option is to allow the
     
    65856606                        empty then the name should be deleted.</p></li></ul></div><p>An example script that calls the BIND dynamic DNS update
    65866607        program <code class="literal">nsupdate</code> is provided in the examples
    6587         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="id2566725"></a>
     6608        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="id2566786"></a>
    65886609
    65896610wins proxy (G)
    6590 </h3></div></div></div><a class="indexterm" name="id2566726"></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
     6611</h3></div></div></div><a class="indexterm" name="id2566788"></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
    65916612        queries on behalf of  other hosts. You may need to set this
    65926613        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>
    65936614</em></span>
    6594 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566780"></a>
     6615</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566841"></a>
    65956616
    65966617wins server (G)
    6597 </h3></div></div></div><a class="indexterm" name="id2566781"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
     6618</h3></div></div></div><a class="indexterm" name="id2566842"></a><a name="WINSSERVER"></a><div class="variablelist"><dl><dt></dt><dd><p>This specifies the IP address (or DNS name: IP
    65986619        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
    65996620        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
     
    66146635</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>
    66156636</em></span>
    6616 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566891"></a>
     6637</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566952"></a>
    66176638
    66186639wins support (G)
    6619 </h3></div></div></div><a class="indexterm" name="id2566892"></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
     6640</h3></div></div></div><a class="indexterm" name="id2566953"></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
    66206641        not set this to <code class="constant">yes</code> unless you have a multi-subnetted network and
    66216642        you wish a particular <code class="literal">nmbd</code> to be your WINS server.
     
    66236644        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>
    66246645</em></span>
    6625 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2566960"></a>
     6646</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567022"></a>
    66266647
    66276648workgroup (G)
    6628 </h3></div></div></div><a class="indexterm" name="id2566962"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
     6649</h3></div></div></div><a class="indexterm" name="id2567023"></a><a name="WORKGROUP"></a><div class="variablelist"><dl><dt></dt><dd><p>This controls what workgroup your server will
    66296650        appear to be in when queried by clients. Note that this parameter
    66306651        also controls the Domain name used with
     
    66346655</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>workgroup</code></em> = <code class="literal">MYGROUP</code>
    66356656</em></span>
    6636 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567033"></a>
     6657</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567094"></a>
    66376658
    66386659<a name="WRITABLE"></a>writable
    6639 </h3></div></div></div><a class="indexterm" name="id2567034"></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="id2567064"></a>
     6660</h3></div></div></div><a class="indexterm" name="id2567095"></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="id2567125"></a>
    66406661
    66416662writeable (S)
    6642 </h3></div></div></div><a class="indexterm" name="id2567065"></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>
    6643 </em></span>
    6644 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567115"></a>
     6663</h3></div></div></div><a class="indexterm" name="id2567126"></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>
     6664</em></span>
     6665</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567176"></a>
    66456666
    66466667write cache size (S)
    6647 </h3></div></div></div><a class="indexterm" name="id2567116"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
     6668</h3></div></div></div><a class="indexterm" name="id2567178"></a><a name="WRITECACHESIZE"></a><div class="variablelist"><dl><dt></dt><dd><p>If this integer parameter is set to non-zero value,
    66486669    Samba will create an in-memory cache for each oplocked file
    66496670    (it does <span class="emphasis"><em>not</em></span> do this for
     
    66636684#  for a 256k cache size per file</code>
    66646685</em></span>
    6665 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567199"></a>
     6686</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567260"></a>
    66666687
    66676688write list (S)
    6668 </h3></div></div></div><a class="indexterm" name="id2567200"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6689</h3></div></div></div><a class="indexterm" name="id2567261"></a><a name="WRITELIST"></a><div class="variablelist"><dl><dt></dt><dd><p>
    66696690    This is a list of users that are given read-write access to a service. If the
    66706691    connecting user is in this list then they will be given write access, no matter
     
    66816702</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>write list</code></em> = <code class="literal">admin, root, @staff</code>
    66826703</em></span>
    6683 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567292"></a>
     6704</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567353"></a>
    66846705
    66856706write raw (G)
    6686 </h3></div></div></div><a class="indexterm" name="id2567293"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
     6707</h3></div></div></div><a class="indexterm" name="id2567354"></a><a name="WRITERAW"></a><div class="variablelist"><dl><dt></dt><dd><p>This parameter controls whether or not the server
    66876708    will support raw write SMB's when transferring data from clients.
    66886709    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>
    66896710</em></span>
    6690 </p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567336"></a>
     6711</p></dd></dl></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2567397"></a>
    66916712
    66926713wtmp directory (G)
    6693 </h3></div></div></div><a class="indexterm" name="id2567337"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
     6714</h3></div></div></div><a class="indexterm" name="id2567398"></a><a name="WTMPDIRECTORY"></a><div class="variablelist"><dl><dt></dt><dd><p>
    66946715        This parameter is only available if Samba has been configured and compiled with the option <code class="literal">
    66956716        --with-utmp</code>. It specifies a directory pathname that is used to store the wtmp or wtmpx files (depending on
     
    67036724</p><p>Example: <span class="emphasis"><em><em class="parameter"><code>wtmp directory</code></em> = <code class="literal">/var/log/wtmp</code>
    67046725</em></span>
    6705 </p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id2567420"></a><h2>WARNINGS</h2><p>
     6726</p></dd></dl></div></div></div></div><div class="refsect1" lang="en"><a name="id2567481"></a><h2>WARNINGS</h2><p>
    67066727        Although the configuration file permits service names to contain spaces, your client software may not.
    67076728        Spaces will be ignored in comparisons anyway, so it shouldn't be a problem - but be aware of the possibility.
     
    67166737        care when designing these sections. In particular, ensure that the permissions on spool directories are
    67176738        correct.
    6718         </p></div><div class="refsect1" lang="en"><a name="id2567470"></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="id2567481"></a><h2>SEE ALSO</h2><p>
    6719         <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="id2567560"></a><h2>AUTHOR</h2><p>
     6739        </p></div><div class="refsect1" lang="en"><a name="id2567531"></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="id2567542"></a><h2>SEE ALSO</h2><p>
     6740        <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="id2567621"></a><h2>AUTHOR</h2><p>
    67206741        The original Samba software and related utilities were created by Andrew Tridgell. Samba is now developed
    67216742        by the Samba Team as an Open Source project similar to the way the Linux kernel is developed.
  • vendor/current/docs/htmldocs/manpages/smbcacls.1.html

    r414 r427  
    5757Try to authenticate with kerberos. Only useful in
    5858an Active Directory environment.
     59</p></dd><dt><span class="term">-C|--use-ccache</span></dt><dd><p>
     60Try to use the credentials cached by winbind.
    5961</p></dd><dt><span class="term">-A|--authentication-file=filename</span></dt><dd><p>This option allows
    6062you to specify a file from which to read the username and
     
    7981via the <code class="literal">ps</code> command.  To be safe always allow
    8082<code class="literal">rpcclient</code> to prompt for a password and type
    81 it in directly. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481697"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by
     83it in directly. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481709"></a><h2>ACL FORMAT</h2><p>The format of an ACL is one or more ACL entries separated by
    8284        either commas or newlines.  An ACL entry is one of the following: </p><pre class="programlisting">
    8385REVISION:&lt;revision number&gt;
     
    104106                permissions</p></li><li><p><span class="emphasis"><em>CHANGE</em></span> - Equivalent to 'RXWD' permissions
    105107                </p></li><li><p><span class="emphasis"><em>FULL</em></span> - Equivalent to 'RWXDPO'
    106                 permissions</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2481861"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcacls</code> program sets the exit status
     108                permissions</p></li></ul></div></div><div class="refsect1" lang="en"><a name="id2481873"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcacls</code> program sets the exit status
    107109        depending on the success or otherwise of the operations performed. 
    108110        The exit status may be one of the following values. </p><p>If the operation succeeded, smbcacls returns and exit
     
    110112        or there was an error getting or setting the ACLs, an exit status
    111113        of 1 is returned.  If there was an error parsing any command line
    112         arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2481894"></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="id2481904"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     114        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2481906"></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="id2481916"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    113115        were created by Andrew Tridgell. Samba is now developed
    114116        by the Samba Team as an Open Source project similar
  • vendor/current/docs/htmldocs/manpages/smbclient.1.html

    r414 r427  
    11<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>smbclient</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.74.0"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="refentry" lang="en"><a name="smbclient.1"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>smbclient &#8212; ftp-like client to access SMB/CIFS resources
    2         on servers</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbclient</code> [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-L &lt;netbios name&gt;] [-U username] [-I destinationIP] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-g] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-k] [-P] [-c &lt;command&gt;]</p></div><div class="cmdsynopsis"><p><code class="literal">smbclient</code> {servicename} [password] [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-D Directory] [-U username] [-W workgroup] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-g] [-l log-basename] [-I destinationIP] [-E] [-c &lt;command string&gt;] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-T&lt;c|x&gt;IXFqgbNan] [-k]</p></div></div><div class="refsect1" lang="en"><a name="id2483752"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbclient</code> is a client that can
     2        on servers</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="cmdsynopsis"><p><code class="literal">smbclient</code> [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-L &lt;netbios name&gt;] [-U username] [-I destinationIP] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-C] [-g] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-k] [-P] [-c &lt;command&gt;]</p></div><div class="cmdsynopsis"><p><code class="literal">smbclient</code> {servicename} [password] [-b &lt;buffer size&gt;] [-d debuglevel] [-e] [-D Directory] [-U username] [-W workgroup] [-M &lt;netbios name&gt;] [-m maxprotocol] [-A authfile] [-N] [-C] [-g] [-l log-basename] [-I destinationIP] [-E] [-c &lt;command string&gt;] [-i scope] [-O &lt;socket options&gt;] [-p port] [-R &lt;name resolve order&gt;] [-s &lt;smb config file&gt;] [-T&lt;c|x&gt;IXFqgbNan] [-k]</p></div></div><div class="refsect1" lang="en"><a name="id2483767"></a><h2>DESCRIPTION</h2><p>This tool is part of the <a class="citerefentry" href="samba.7.html"><span class="citerefentry"><span class="refentrytitle">samba</span>(7)</span></a> suite.</p><p><code class="literal">smbclient</code> is a client that can
    33        'talk' to an SMB/CIFS server. It offers an interface
    44        similar to that of the ftp program (see <a class="citerefentry" href="ftp.1.html"><span class="citerefentry"><span class="refentrytitle">ftp</span>(1)</span></a>). 
     
    66        to the local machine, putting files from the local machine to
    77        the server, retrieving directory information from the server
    8         and so on. </p></div><div class="refsect1" lang="en"><a name="id2483792"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">servicename</span></dt><dd><p>servicename is the name of the service
     8        and so on. </p></div><div class="refsect1" lang="en"><a name="id2481476"></a><h2>OPTIONS</h2><div class="variablelist"><dl><dt><span class="term">servicename</span></dt><dd><p>servicename is the name of the service
    99                you want to use on the server. A service name takes the form
    1010                <code class="filename">//server/service</code> where <em class="parameter"><code>server
     
    154154Try to authenticate with kerberos. Only useful in
    155155an Active Directory environment.
     156</p></dd><dt><span class="term">-C|--use-ccache</span></dt><dd><p>
     157Try to use the credentials cached by winbind.
    156158</p></dd><dt><span class="term">-A|--authentication-file=filename</span></dt><dd><p>This option allows
    157159you to specify a file from which to read the username and
     
    263265                commands to be executed instead of prompting from stdin. <em class="parameter"><code>
    264266                -N</code></em> is implied by <em class="parameter"><code>-c</code></em>.</p><p>This is particularly useful in scripts and for printing stdin
    265                 to the server, e.g. <code class="literal">-c 'print -'</code>. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2533270"></a><h2>OPERATIONS</h2><p>Once the client is running, the user is presented with
     267                to the server, e.g. <code class="literal">-c 'print -'</code>. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2533296"></a><h2>OPERATIONS</h2><p>Once the client is running, the user is presented with
    266268        a prompt : </p><p><code class="prompt">smb:\&gt; </code></p><p>The backslash ("\\") indicates the current working directory
    267269        on the server, and will change if the current working directory
     
    464466                the given arbitrary number. Without an argument prints out the current
    465467                vuid being used. Used for internal Samba testing purposes.
    466                 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2534521"></a><h2>NOTES</h2><p>Some servers are fussy about the case of supplied usernames,
     468                </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2534407"></a><h2>NOTES</h2><p>Some servers are fussy about the case of supplied usernames,
    467469        passwords, share names (AKA service names) and machine names.
    468470        If you fail to connect try giving all parameters in uppercase.
     
    471473        on a valid NetBIOS name being used, so you need to supply a valid
    472474        name that would be known to the server.</p><p>smbclient supports long file names where the server
    473         supports the LANMAN2 protocol or above. </p></div><div class="refsect1" lang="en"><a name="id2534546"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the
     475        supports the LANMAN2 protocol or above. </p></div><div class="refsect1" lang="en"><a name="id2534432"></a><h2>ENVIRONMENT VARIABLES</h2><p>The variable <code class="envar">USER</code> may contain the
    474476        username of the person  using the client. This information is
    475477        used only if the protocol  level is high enough to support
     
    481483        to instead of connecting to a server.  This functionality is primarily
    482484        intended as a development aid, and works best when using a LMHOSTS
    483         file</p></div><div class="refsect1" lang="en"><a name="id2534582"></a><h2>INSTALLATION</h2><p>The location of the client program is a matter for
     485        file</p></div><div class="refsect1" lang="en"><a name="id2534468"></a><h2>INSTALLATION</h2><p>The location of the client program is a matter for
    484486        individual system administrators. The following are thus
    485487        suggestions only. </p><p>It is recommended that the smbclient software be installed
     
    492494        running SMB/CIFS server. It is possible to run <a class="citerefentry" href="smbd.8.html"><span class="citerefentry"><span class="refentrytitle">smbd</span>(8)</span></a> as an ordinary user - running that server as a daemon
    493495        on a user-accessible port (typically any port number over 1024)
    494         would provide a suitable test server. </p></div><div class="refsect1" lang="en"><a name="id2534634"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the client are logged in a
     496        would provide a suitable test server. </p></div><div class="refsect1" lang="en"><a name="id2534520"></a><h2>DIAGNOSTICS</h2><p>Most diagnostics issued by the client are logged in a
    495497        specified log file. The log file name is specified at compile time,
    496498        but may be overridden on the command line. </p><p>The number and nature of diagnostics available depends
    497499        on the debug level used by the client. If you have problems,
    498         set the debug level to 3 and peruse the log files. </p></div><div class="refsect1" lang="en"><a name="id2534653"></a><h2>VERSION</h2><p>This man page is correct for version 3.2 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2534664"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     500        set the debug level to 3 and peruse the log files. </p></div><div class="refsect1" lang="en"><a name="id2534539"></a><h2>VERSION</h2><p>This man page is correct for version 3.2 of the Samba suite.</p></div><div class="refsect1" lang="en"><a name="id2534550"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    499501        were created by Andrew Tridgell. Samba is now developed
    500502        by the Samba Team as an Open Source project similar
  • vendor/current/docs/htmldocs/manpages/smbcquotas.1.html

    r414 r427  
    4141Try to authenticate with kerberos. Only useful in
    4242an Active Directory environment.
     43</p></dd><dt><span class="term">-C|--use-ccache</span></dt><dd><p>
     44Try to use the credentials cached by winbind.
    4345</p></dd><dt><span class="term">-A|--authentication-file=filename</span></dt><dd><p>This option allows
    4446you to specify a file from which to read the username and
     
    6365via the <code class="literal">ps</code> command.  To be safe always allow
    6466<code class="literal">rpcclient</code> to prompt for a password and type
    65 it in directly. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481668"></a><h2>QUOTA_SET_COMAND</h2><p>The format of an the QUOTA_SET_COMMAND is an operation
     67it in directly. </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481680"></a><h2>QUOTA_SET_COMAND</h2><p>The format of an the QUOTA_SET_COMMAND is an operation
    6668        name followed by a set of parameters specific to that operation.
    6769        </p><p>To set user quotas for the user specified by -u or for the
     
    7577        </p><p><strong class="userinput"><code>
    7678        FSQFLAGS:QUOTA_ENABLED/DENY_DISK/LOG_SOFTLIMIT/LOG_HARD_LIMIT
    77         </code></strong></p><p>All limits are specified as a number of bytes.</p></div><div class="refsect1" lang="en"><a name="id2481721"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcquotas</code> program sets the exit status
     79        </code></strong></p><p>All limits are specified as a number of bytes.</p></div><div class="refsect1" lang="en"><a name="id2481733"></a><h2>EXIT STATUS</h2><p>The <code class="literal">smbcquotas</code> program sets the exit status
    7880        depending on the success or otherwise of the operations performed.
    7981        The exit status may be one of the following values. </p><p>If the operation succeeded, smbcquotas returns an exit
     
    8183        or when there was an error getting or setting the quota(s), an exit status
    8284        of 1 is returned.  If there was an error parsing any command line
    83         arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2481754"></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="id2481764"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     85        arguments, an exit status of 2 is returned. </p></div><div class="refsect1" lang="en"><a name="id2481766"></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="id2481776"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    8486        were created by Andrew Tridgell. Samba is now developed
    8587        by the Samba Team as an Open Source project similar
  • vendor/current/docs/htmldocs/manpages/smbtree.1.html

    r414 r427  
    4545Try to authenticate with kerberos. Only useful in
    4646an Active Directory environment.
     47</p></dd><dt><span class="term">-C|--use-ccache</span></dt><dd><p>
     48Try to use the credentials cached by winbind.
    4749</p></dd><dt><span class="term">-A|--authentication-file=filename</span></dt><dd><p>This option allows
    4850you to specify a file from which to read the username and
     
    6870<code class="literal">rpcclient</code> to prompt for a password and type
    6971it in directly. </p></dd><dt><span class="term">-h|--help</span></dt><dd><p>Print a summary of command line options.
    70 </p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481517"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
    71         suite.</p></div><div class="refsect1" lang="en"><a name="id2481528"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
     72</p></dd></dl></div></div><div class="refsect1" lang="en"><a name="id2481528"></a><h2>VERSION</h2><p>This man page is correct for version 3 of the Samba
     73        suite.</p></div><div class="refsect1" lang="en"><a name="id2481539"></a><h2>AUTHOR</h2><p>The original Samba software and related utilities
    7274        were created by Andrew Tridgell. Samba is now developed
    7375        by the Samba Team as an Open Source project similar
Note: See TracChangeset for help on using the changeset viewer.