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