docs-xml/smbdotconf/locking/kerneloplocks.xml

   1 <samba:parameter name="kernel oplocks"
   2                  type="boolean"
   3                  context="S"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6         <para>For UNIXes that support kernel based <smbconfoption name="oplocks"/>
   7         (currently only Linux), this parameter allows the use of them to be
   8         turned on or off. However, this disables Level II oplocks for clients as
   9         the Linux kernel does not support them properly.</para>
  10
  11         <para>Kernel oplocks support allows Samba <parameter moreinfo="none">oplocks
  12         </parameter> to be broken whenever a local UNIX process or NFS operation
  13         accesses a file that <citerefentry><refentrytitle>smbd</refentrytitle>
  14         <manvolnum>8</manvolnum></citerefentry> has oplocked. This allows complete
  15         data consistency between SMB/CIFS, NFS and local file access (and is
  16         a <emphasis>very</emphasis> cool feature :-).</para>
  17         <para>If you do not need this interaction, you should disable the
  18         parameter on Linux to get Level II oplocks and the associated
  19         performance benefit.</para>
  20
  21         <para>This parameter defaults to <constant>no</constant> and is translated
  22         to a no-op on systems that do not have the necessary kernel support.</para>
  23 </description>
  24
  25 <related>oplocks</related>
  26 <related>level2 oplocks</related>
  27 <related>smb2 leases</related>
  28 <value type="default">no</value>
  29 </samba:parameter>