Add new framework for smb.conf(5). Please read README before trying to compile.
[Samba/gebeck_regimport.git] / docs / docbook / smbdotconf / locking / blockinglocks.xml
blobea5e90b5cde51b407facf9bb453e8b7104a490b7
1 <samba:parameter xmlns:samba="http://samba.org/common">
2                 <term><anchor id="BLOCKINGLOCKS"/>blocking locks (S)</term>
3                 <listitem><para>This parameter controls the behavior 
4                 of <citerefentry><refentrytitle>smbd</refentrytitle>
5                 <manvolnum>8</manvolnum></citerefentry> when given a request by a client 
6                 to obtain a byte range lock on a region of an open file, and the 
7                 request has a time limit associated with it.</para>
8                 
9                 <para>If this parameter is set and the lock range requested 
10                 cannot be immediately satisfied, samba will internally 
11                 queue the lock request, and periodically attempt to obtain 
12                 the lock until the timeout period expires.</para>
14                 <para>If this parameter is set to <constant>no</constant>, then 
15                 samba will behave as previous versions of Samba would and 
16                 will fail the lock request immediately if the lock range 
17                 cannot be obtained.</para>
19                 <para>Default: <command moreinfo="none">blocking locks = yes</command></para>
21                 </listitem>
22                 </samba:parameter>