syncing tree with SAMBA_3_0
[Samba.git] / docs / docbook / smbdotconf / locking / blockinglocks.xml
blobf11d92f4f5a2789f9e96dbb67beb7e501a4f9a43
1 <samba:parameter name="blocking locks"
2                  context="S"
3                  xmlns:samba="http://samba.org/common">
4 <listitem>
5         <para>This parameter controls the behavior 
6         of <citerefentry><refentrytitle>smbd</refentrytitle>
7         <manvolnum>8</manvolnum></citerefentry> when given a request by a client 
8         to obtain a byte range lock on a region of an open file, and the 
9         request has a time limit associated with it.</para>
10                 
11         <para>If this parameter is set and the lock range requested 
12         cannot be immediately satisfied, samba will internally 
13         queue the lock request, and periodically attempt to obtain 
14         the lock until the timeout period expires.</para>
16         <para>If this parameter is set to <constant>no</constant>, then 
17         samba will behave as previous versions of Samba would and 
18         will fail the lock request immediately if the lock range 
19         cannot be obtained.</para>
21         <para>Default: <command moreinfo="none">blocking locks = yes</command></para>
22 </listitem>
23 </samba:parameter>