summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/locking/fakeoplocks.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/fakeoplocks.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/fakeoplocks.xml')
-rw-r--r--docs/docbook/smbdotconf/locking/fakeoplocks.xml50
1 files changed, 27 insertions, 23 deletions
diff --git a/docs/docbook/smbdotconf/locking/fakeoplocks.xml b/docs/docbook/smbdotconf/locking/fakeoplocks.xml
index 16887726c0..b7deac68ba 100644
--- a/docs/docbook/smbdotconf/locking/fakeoplocks.xml
+++ b/docs/docbook/smbdotconf/locking/fakeoplocks.xml
@@ -1,27 +1,31 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
- <term><anchor id="FAKEOPLOCKS"/>fake oplocks (S)</term>
- <listitem><para>Oplocks are the way that SMB clients get permission
- from a server to locally cache file operations. If a server grants
- an oplock (opportunistic lock) then the client is free to assume
- that it is the only one accessing the file and it will aggressively
- cache file data. With some oplock types the client may even cache
- file open/close operations. This can give enormous performance benefits.
- </para>
+<samba:parameter name="fake oplocks"
+ context="S"
+ xmlns:samba="http://samba.org/common">
+<listitem>
+ <para>Oplocks are the way that SMB clients get permission
+ from a server to locally cache file operations. If a server grants
+ an oplock (opportunistic lock) then the client is free to assume
+ that it is the only one accessing the file and it will aggressively
+ cache file data. With some oplock types the client may even cache
+ file open/close operations. This can give enormous performance benefits.
+ </para>
- <para>When you set <command moreinfo="none">fake oplocks = yes</command>, <ulink url="smbd.8.html"><command moreinfo="none">smbd(8)</command></ulink> will
- always grant oplock requests no matter how many clients are using
- the file.</para>
+ <para>When you set <command moreinfo="none">fake oplocks = yes</command>, <citerefentry>
+ <refentrytitle>smbd</refentrytitle><manvolnum>8</manvolnum></citerefentry> will
+ always grant oplock requests no matter how many clients are using the file.</para>
- <para>It is generally much better to use the real <link linkend="OPLOCKS"><parameter moreinfo="none">oplocks</parameter></link> support rather
- than this parameter.</para>
+ <para>It is generally much better to use the real <link linkend="OPLOCKS">
+ <parameter moreinfo="none">oplocks</parameter></link> support rather
+ than this parameter.</para>
- <para>If you enable this option on all read-only shares or
- shares that you know will only be accessed from one client at a
- time such as physically read-only media like CDROMs, you will see
- a big performance improvement on many operations. If you enable
- this option on shares where multiple clients may be accessing the
- files read-write at the same time you can get data corruption. Use
- this option carefully!</para>
+ <para>If you enable this option on all read-only shares or
+ shares that you know will only be accessed from one client at a
+ time such as physically read-only media like CDROMs, you will see
+ a big performance improvement on many operations. If you enable
+ this option on shares where multiple clients may be accessing the
+ files read-write at the same time you can get data corruption. Use
+ this option carefully!</para>
- <para>Default: <command moreinfo="none">fake oplocks = no</command></para></listitem>
- </samba:parameter>
+ <para>Default: <command moreinfo="none">fake oplocks = no</command></para>
+</listitem>
+</samba:parameter>