Add new framework for smb.conf(5). Please read README before trying to compile.

[Samba/gebeck_regimport.git] / docs / docbook / smbdotconf / locking / oplockcontentionlimit.xml

<samba:parameter xmlns:samba="http://samba.org/common">
                <term><anchor id="OPLOCKCONTENTIONLIMIT"/>oplock contention limit (S)</term>
                <listitem><para>This is a <emphasis>very</emphasis> advanced 
                <ulink url="smbd.8.html">smbd(8)</ulink> tuning option to 
                improve the efficiency of the granting of oplocks under multiple 
                client contention for the same file.</para>
                
                <para>In brief it specifies a number, which causes <citerefentry><refentrytitle>smbd</refentrytitle>
                <manvolnum>8</manvolnum></citerefentry>not to grant an oplock even when requested 
                if the approximate number of clients contending for an oplock on the same file goes over this 
                limit. This causes <command moreinfo="none">smbd</command> to behave in a similar 
                way to Windows NT.</para>

                <para><emphasis>DO NOT CHANGE THIS PARAMETER UNLESS YOU HAVE READ 
                AND UNDERSTOOD THE SAMBA OPLOCK CODE</emphasis>.</para>

                <para>Default: <command moreinfo="none">oplock contention limit = 2</command></para>
                </listitem>
                </samba:parameter>