vetooplockfiles.xml   [plain text]

<samba:parameter name="veto oplock files"
                 context="S"
                 xmlns:samba="http://samba.org/common">
<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>