summaryrefslogtreecommitdiffstats
path: root/docs-xml/smbdotconf/filename/vetooplockfiles.xml
blob: 8d6a9224953ee65560ca89f4f4ab8371e79b6bbc (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
<samba:parameter name="veto oplock files"
                 context="S"
                 type="string"
                 substitution="1"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
	<para>
	This parameter is only valid when the <smbconfoption name="oplocks"/>
	parameter is turned on for a share. It allows the Samba administrator
	to selectively turn off the granting of oplocks on selected files that
	match a wildcarded list, similar to the wildcarded list used in the
	<smbconfoption name="veto files"/> parameter.
	</para>


	<para>
	You might want to do this on files that you know will be heavily contended 
	for by clients. A good example of this is in the NetBench SMB benchmark 
	program, which causes heavy client contention for files ending in 
	<filename moreinfo="none">.SEM</filename>. To cause Samba not to grant 
	oplocks on these files you would use the line (either in the [global] 
	section or in the section for the particular NetBench share.
	</para>

	<para>
	An example of use is:
<programlisting>
veto oplock files = /.*SEM/
</programlisting>
	</para>
</description>
<value type="default"><comment>No files are vetoed for oplock grants</comment></value>
</samba:parameter>