docs/smbdotconf/locking/oplockcontentionlimit.xml

   1 <samba:parameter name="oplock contention limit"
   2                  context="S"
   3                                  type="integer"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6         <para>This is a <emphasis>very</emphasis> advanced
   7         <citerefentry><refentrytitle>smbd</refentrytitle>
   8         <manvolnum>8</manvolnum></citerefentry> tuning option to
   9         improve the efficiency of the granting of oplocks under multiple
  10         client contention for the same file.</para>
  11
  12         <para>In brief it specifies a number, which causes <citerefentry><refentrytitle>smbd</refentrytitle>
  13         <manvolnum>8</manvolnum></citerefentry>not to grant an oplock even when requested
  14         if the approximate number of clients contending for an oplock on the same file goes over this
  15         limit. This causes <command moreinfo="none">smbd</command> to behave in a similar
  16         way to Windows NT.</para>
  17
  18 <warning><para>DO NOT CHANGE THIS PARAMETER UNLESS YOU HAVE READ
  19                 AND UNDERSTOOD THE SAMBA OPLOCK CODE.</para></warning>
  20
  21 </description>
  22 <value type="default">2</value>
  23 </samba:parameter>