summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/locking/level2oplocks.xml
diff options
context:
space:
mode:
authorAlexander Bokovoy <ab@samba.org>2003-04-11 15:01:39 +0000
committerAlexander Bokovoy <ab@samba.org>2003-04-11 15:01:39 +0000
commitd90a4ea71a17f22b9d65462189d6e074b4fa9e6e (patch)
treee5341e3d01b274d76571eb570c8ec8e66a52076b /docs/docbook/smbdotconf/locking/level2oplocks.xml
parent7d19f81d96d8474c5ab7a9d950b1e32b41baf8c8 (diff)
downloadsamba-d90a4ea71a17f22b9d65462189d6e074b4fa9e6e.tar.gz
samba-d90a4ea71a17f22b9d65462189d6e074b4fa9e6e.tar.bz2
samba-d90a4ea71a17f22b9d65462189d6e074b4fa9e6e.zip
Finish conversion of Locking options
(This used to be commit 9613c217786147c9deda9770887dc069659b1deb)
Diffstat (limited to 'docs/docbook/smbdotconf/locking/level2oplocks.xml')
-rw-r--r--docs/docbook/smbdotconf/locking/level2oplocks.xml66
1 files changed, 34 insertions, 32 deletions
diff --git a/docs/docbook/smbdotconf/locking/level2oplocks.xml b/docs/docbook/smbdotconf/locking/level2oplocks.xml
index adae6d268f..c2c090b1a8 100644
--- a/docs/docbook/smbdotconf/locking/level2oplocks.xml
+++ b/docs/docbook/smbdotconf/locking/level2oplocks.xml
@@ -1,39 +1,41 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="LEVEL2OPLOCKS"/>level2 oplocks (S)</term>
- <listitem><para>This parameter controls whether Samba supports
- level2 (read-only) oplocks on a share.</para>
+<samba:parameter name="level2 oplocks"
+ context="S"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>This parameter controls whether Samba supports
+ level2 (read-only) oplocks on a share.</para>
- <para>Level2, or read-only oplocks allow Windows NT clients
- that have an oplock on a file to downgrade from a read-write oplock
- to a read-only oplock once a second client opens the file (instead
- of releasing all oplocks on a second open, as in traditional,
- exclusive oplocks). This allows all openers of the file that
- support level2 oplocks to cache the file for read-ahead only (ie.
- they may not cache writes or lock requests) and increases performance
- for many accesses of files that are not commonly written (such as
- application .EXE files).</para>
+ <para>Level2, or read-only oplocks allow Windows NT clients
+ that have an oplock on a file to downgrade from a read-write oplock
+ to a read-only oplock once a second client opens the file (instead
+ of releasing all oplocks on a second open, as in traditional,
+ exclusive oplocks). This allows all openers of the file that
+ support level2 oplocks to cache the file for read-ahead only (ie.
+ they may not cache writes or lock requests) and increases performance
+ for many accesses of files that are not commonly written (such as
+ application .EXE files).</para>
- <para>Once one of the clients which have a read-only oplock
- writes to the file all clients are notified (no reply is needed
- or waited for) and told to break their oplocks to &quot;none&quot; and
- delete any read-ahead caches.</para>
+ <para>Once one of the clients which have a read-only oplock
+ writes to the file all clients are notified (no reply is needed
+ or waited for) and told to break their oplocks to &quot;none&quot; and
+ delete any read-ahead caches.</para>
- <para>It is recommended that this parameter be turned on
- to speed access to shared executables.</para>
+ <para>It is recommended that this parameter be turned on to
+ speed access to shared executables.</para>
- <para>For more discussions on level2 oplocks see the CIFS spec.</para>
+ <para>For more discussions on level2 oplocks see the CIFS spec.</para>
- <para>Currently, if <link linkend="KERNELOPLOCKS"><parameter moreinfo="none">kernel
- oplocks</parameter></link> are supported then level2 oplocks are
- not granted (even if this parameter is set to <constant>yes</constant>).
- Note also, the <link linkend="OPLOCKS"><parameter moreinfo="none">oplocks</parameter>
- </link> parameter must be set to <constant>yes</constant> on this share in order for
- this parameter to have any effect.</para>
+ <para>Currently, if <link linkend="KERNELOPLOCKS"><parameter moreinfo="none">kernel
+ oplocks</parameter></link> are supported then level2 oplocks are
+ not granted (even if this parameter is set to <constant>yes</constant>).
+ Note also, the <link linkend="OPLOCKS"><parameter moreinfo="none">oplocks</parameter>
+ </link> parameter must be set to <constant>yes</constant> on this share in order for
+ this parameter to have any effect.</para>
- <para>See also the <link linkend="OPLOCKS"><parameter moreinfo="none">oplocks</parameter>
- </link> and <link linkend="OPLOCKS"><parameter moreinfo="none">kernel oplocks</parameter>
- </link> parameters.</para>
+ <para>See also the <link linkend="OPLOCKS"><parameter moreinfo="none">oplocks</parameter>
+ </link> and <link linkend="OPLOCKS"><parameter moreinfo="none">kernel oplocks</parameter>
+ </link> parameters.</para>
- <para>Default: <command moreinfo="none">level2 oplocks = yes</command></para>
- </listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">level2 oplocks = yes</command></para>
+</listitem>
+</samba:parameter>