summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJeremy Allison <jra@samba.org>1997-10-09 20:30:29 +0000
committerJeremy Allison <jra@samba.org>1997-10-09 20:30:29 +0000
commit502a377794f157502cc1432c3d923209a6d69ff4 (patch)
tree7113c7545ebac0df69da68c71dcb88207b1f3101
parent12f2c006e0d3770c248bcfe2602580f5e6ff00ad (diff)
downloadsamba-502a377794f157502cc1432c3d923209a6d69ff4.tar.gz
samba-502a377794f157502cc1432c3d923209a6d69ff4.tar.bz2
samba-502a377794f157502cc1432c3d923209a6d69ff4.zip
Added in oplock info.
Jeremy (jallison@whistle.com) (This used to be commit 229b6c409240a8dca9172702b8fefb31aa3b13a1)
-rw-r--r--docs/textdocs/Speed.txt39
1 files changed, 27 insertions, 12 deletions
diff --git a/docs/textdocs/Speed.txt b/docs/textdocs/Speed.txt
index b11885fc37..cb086a9711 100644
--- a/docs/textdocs/Speed.txt
+++ b/docs/textdocs/Speed.txt
@@ -43,21 +43,36 @@ only one accessing the file and it will agressively cache file
data. With some oplock types the client may even cache file open/close
operations. This can give enormous performance benefits.
-Samba does not support opportunistic locks because they are very
-difficult to do under Unix. Samba can fake them, however, by granting
-a oplock whenever a client asks for one. This is controlled using the
-smb.conf option "fake oplocks". If you set "fake oplocks = yes" then
-you are telling the client that it may agressively cache the file
-data.
-
-By enabling this option on all read-only shares or shares that you know
+With the release of Samba 1.9.18 we now correctly support opportunistic
+locks. This is turned on by default, and can be turned off on a share-
+by-share basis by setting the parameter :
+
+oplocks = False
+
+We recommend that you leave oplocks on however, as current benchmark
+tests with NetBench seem to give approximately a 30% improvement in
+speed with them on. This is on average however, and the actual
+improvement seen can be orders of magnitude greater, depending on
+what the client redirector is doing.
+
+Previous to Samba 1.9.18 there was a 'fake oplocks' option. This
+option has been left in the code for backwards compatibility reasons
+but it's use is now deprecated. A short summary of what the old
+code did follows.
+
+Old 'fake oplocks' option - deprecated.
+---------------------------------------
+
+Samba can also fake oplocks, by granting a oplock whenever a client
+asks for one. This is controlled using the smb.conf option "fake
+oplocks". If you set "fake oplocks = yes" then you are telling the
+client that it may agressively cache the file data for all opens.
+
+Enabling 'fake oplocks' on all read-only shares or shares that you know
will only be accessed from one client at a time 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!
-
-This option is disabled by default.
+at the same time you can get data corruption.
SOCKET OPTIONS
--------------