docs-xml/smbdotconf/locking/locking.xml

   1 <samba:parameter name="locking"
   2                  type="boolean"
   3                  context="S"
   4                  parm="1"
   5                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   6 <description>
   7         <para>This controls whether or not locking will be
   8         performed by the server in response to lock requests from the
   9         client.</para>
  10
  11         <para>If <command moreinfo="none">locking = no</command>, all lock and unlock
  12         requests will appear to succeed and all lock queries will report
  13         that the file in question is available for locking.</para>
  14
  15         <para>If <command moreinfo="none">locking = yes</command>, real locking will be performed
  16         by the server.</para>
  17
  18         <para>This option <emphasis>may</emphasis> be useful for read-only
  19         filesystems which <emphasis>may</emphasis> not need locking (such as
  20         CDROM drives), although setting this parameter of <constant>no</constant>
  21         is not really recommended even in this case.</para>
  22
  23         <para>Be careful about disabling locking either globally or in a
  24         specific service, as lack of locking may result in data corruption.
  25         You should never need to set this parameter.</para>
  26 </description>
  27
  28 <value type="default">yes</value>
  29 </samba:parameter>