summaryrefslogtreecommitdiff
path: root/docs-xml/smbdotconf
diff options
context:
space:
mode:
authorChristian Ambach <ambi@samba.org>2012-03-30 16:11:37 +0200
committerJeremy Allison <jra@samba.org>2012-04-11 11:11:39 -0700
commit639a775866230fd1fb1a44d0f4e27522d9ade93a (patch)
tree93f2bd63fb9aeca7524857de6db07393abaca04c /docs-xml/smbdotconf
parent2a36408d4020b67d94f8750951bfead069ca1206 (diff)
downloadsamba-639a775866230fd1fb1a44d0f4e27522d9ade93a.tar.gz
samba-639a775866230fd1fb1a44d0f4e27522d9ade93a.tar.bz2
samba-639a775866230fd1fb1a44d0f4e27522d9ade93a.zip
docs: update kernel oplocks documentation
Signed-off-by: Jeremy Allison <jra@samba.org>
Diffstat (limited to 'docs-xml/smbdotconf')
-rw-r--r--docs-xml/smbdotconf/locking/kerneloplocks.xml9
1 files changed, 7 insertions, 2 deletions
diff --git a/docs-xml/smbdotconf/locking/kerneloplocks.xml b/docs-xml/smbdotconf/locking/kerneloplocks.xml
index c4f12b9bd4..9ac7256fb9 100644
--- a/docs-xml/smbdotconf/locking/kerneloplocks.xml
+++ b/docs-xml/smbdotconf/locking/kerneloplocks.xml
@@ -1,11 +1,13 @@
<samba:parameter name="kernel oplocks"
type="boolean"
- context="G"
+ context="S"
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
<para>For UNIXes that support kernel based <smbconfoption name="oplocks"/>
(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
</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
data consistency between SMB/CIFS, NFS and local file access (and is
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
to a no-op on systems that no not have the necessary kernel support.