docs-xml/smbdotconf/locking/oplocks.xml

   1 <samba:parameter name="oplocks"
   2                  context="S"
   3                                  type="boolean"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6         <para>
   7         This boolean option tells <command moreinfo="none">smbd</command> whether to
   8         issue oplocks (opportunistic locks) to file open requests on this
   9         share. The oplock code can dramatically (approx. 30% or more) improve
  10         the speed of access to files on Samba servers. It allows the clients
  11         to aggressively cache files locally and you may want to disable this
  12         option for unreliable network environments (it is turned on by
  13         default in Windows NT Servers).
  14         </para>
  15
  16         <para>
  17         Oplocks may be selectively turned off on certain files with a share. See
  18         the <smbconfoption name="veto oplock files"/> parameter. On some systems
  19         oplocks are recognized by the underlying operating system. This
  20         allows data synchronization between all access to oplocked files,
  21         whether it be via Samba or NFS or a local UNIX process. See the
  22         <smbconfoption name="kernel oplocks"/> parameter for details.
  23         </para>
  24 </description>
  25
  26 <related>kernel oplocks</related>
  27 <related>level2 oplocks</related>
  28 <value type="default">yes</value>
  29 </samba:parameter>