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 IRIX and the Linux 2.4 kernel), this parameter
   8         allows the use of them to be turned on or off. However, this disables
   9         Level II oplocks for clients as the Linux and IRIX kernels do not
  10         support them properly.</para>
  11
  12         <para>Kernel oplocks support allows Samba <parameter moreinfo="none">oplocks
  13         </parameter> to be broken whenever a local UNIX process or NFS operation
  14         accesses a file that <citerefentry><refentrytitle>smbd</refentrytitle>
  15         <manvolnum>8</manvolnum></citerefentry> has oplocked. This allows complete
  16         data consistency between SMB/CIFS, NFS and local file access (and is
  17         a <emphasis>very</emphasis> cool feature :-).</para>
  18         <para>If you do not need this interaction, you should disable the
  19         parameter on Linux and IRIX to get Level II oplocks and the associated
  20         performance benefit.</para>
  21
  22         <para>This parameter defaults to <constant>no</constant> and is translated
  23         to a no-op on systems that do not have the necessary kernel support.</para>
  24 </description>
  25
  26 <related>oplocks</related>
  27 <related>level2 oplocks</related>
  28 <value type="default">no</value>
  29 </samba:parameter>