2004-04-07 10:15:11 +00:00
<samba:parameter name= "oplocks"
context="S"
type="boolean"
2005-03-12 22:41:20 +00:00
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
2004-04-07 10:15:11 +00:00
<description >
2005-08-25 16:49:40 +00:00
<para >
This boolean option tells <command moreinfo= "none" > smbd</command> whether to
2004-04-07 10:15:11 +00:00
issue oplocks (opportunistic locks) to file open requests on this
share. The oplock code can dramatically (approx. 30% or more) improve
the speed of access to files on Samba servers. It allows the clients
to aggressively cache files locally and you may want to disable this
option for unreliable network environments (it is turned on by
default in Windows NT Servers). For more information see the file
2005-08-25 16:49:40 +00:00
<filename moreinfo= "none" > Speed.txt</filename> in the Samba
<filename moreinfo= "none" > docs/</filename> directory.
</para>
2004-04-07 10:15:11 +00:00
2005-08-25 16:49:40 +00:00
<para >
Oplocks may be selectively turned off on certain files with a share. See
the <smbconfoption name= "veto oplock files" /> parameter. On some systems
2004-04-07 10:15:11 +00:00
oplocks are recognized by the underlying operating system. This
allows data synchronization between all access to oplocked files,
whether it be via Samba or NFS or a local UNIX process. See the
2005-08-25 16:49:40 +00:00
<smbconfoption name= "kernel oplocks" /> parameter for details.
</para>
2004-04-07 10:15:11 +00:00
</description>
<related > kernel oplocks</related>
<related > level2 oplocks</related>
<value type= "default" > yes</value>
</samba:parameter>