summaryrefslogtreecommitdiff
path: root/docs/docbook/smbdotconf/filename/vetooplockfiles.xml
blob: 0c817c97f89d988dc8d22de8dd30480b744a52ab (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
<samba:parameter xmlns:samba="http://samba.org/common">
		<term><anchor id="VETOOPLOCKFILES"/>veto oplock files (S)</term>
		<listitem><para>This parameter is only valid when the <link linkend="OPLOCKS"><parameter moreinfo="none">oplocks</parameter></link>
		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
		<link linkend="VETOFILES"><parameter moreinfo="none">veto files</parameter></link> 
		parameter.</para>

		<para>Default: <emphasis>No files are vetoed for oplock 
		grants</emphasis></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>Example: <command moreinfo="none">veto oplock files = /*.SEM/
		</command></para>
		</listitem>
		</samba:parameter>