s3 docs: Reword posix locking text to answer a common question
[kamenim/samba.git] / docs-xml / smbdotconf / locking / posixlocking.xml
1 <samba:parameter name="posix locking"
2                                  type="boolean"
3                  context="S"
4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
5 <description>
6         <para>
7         The <citerefentry><refentrytitle>smbd</refentrytitle> <manvolnum>8</manvolnum></citerefentry>
8         daemon maintains an database of file locks obtained by SMB clients. The default behavior is 
9         to map this internal database to POSIX locks. This means that file locks obtained by SMB clients are 
10         consistent with those seen by POSIX compliant applications accessing the files via a non-SMB 
11         method (e.g. NFS or local file access). It is very unlikely that you need to set this parameter
12         to "no", unless you are sharing from an NFS mount, which is not a good idea in the first place.
13         </para>
14 </description>
15 <value type="default">yes</value>
16 </samba:parameter>