1
0
mirror of https://github.com/samba-team/samba.git synced 2025-02-04 17:47:26 +03:00

docs: update kernel oplocks documentation

Signed-off-by: Jeremy Allison <jra@samba.org>
This commit is contained in:
Christian Ambach 2012-03-30 16:11:37 +02:00 committed by Jeremy Allison
parent 2a36408d40
commit 639a775866

View File

@ -1,11 +1,13 @@
<samba:parameter name="kernel oplocks" <samba:parameter name="kernel oplocks"
type="boolean" type="boolean"
context="G" context="S"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"> xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description> <description>
<para>For UNIXes that support kernel based <smbconfoption name="oplocks"/> <para>For UNIXes that support kernel based <smbconfoption name="oplocks"/>
(currently only IRIX and the Linux 2.4 kernel), this parameter (currently only IRIX and the Linux 2.4 kernel), this parameter
allows the use of them to be turned on or off.</para> allows the use of them to be turned on or off. However, this disables
Level II oplocks for clients as the Linux and IRIX kernels do not
support them properly.</para>
<para>Kernel oplocks support allows Samba <parameter moreinfo="none">oplocks <para>Kernel oplocks support allows Samba <parameter moreinfo="none">oplocks
</parameter> to be broken whenever a local UNIX process or NFS operation </parameter> to be broken whenever a local UNIX process or NFS operation
@ -13,6 +15,9 @@
<manvolnum>8</manvolnum></citerefentry> has oplocked. This allows complete <manvolnum>8</manvolnum></citerefentry> has oplocked. This allows complete
data consistency between SMB/CIFS, NFS and local file access (and is data consistency between SMB/CIFS, NFS and local file access (and is
a <emphasis>very</emphasis> cool feature :-).</para> a <emphasis>very</emphasis> cool feature :-).</para>
<para>If you do not need this interaction, you should disable the
parameter on Linux and IRIX to get Level II oplocks and the associated
performance benefit.</para>
<para>This parameter defaults to <constant>on</constant>, but is translated <para>This parameter defaults to <constant>on</constant>, but is translated
to a no-op on systems that no not have the necessary kernel support. to a no-op on systems that no not have the necessary kernel support.