docs/smbdotconf/filename/vetooplockfiles.xml

   1 <samba:parameter name="veto oplock files"
   2                  context="S"
   3                                  type="string"
   4                  xmlns:samba="http://samba.org/common">
   5  <description>
   6         <para>This parameter is only valid when the <link linkend="OPLOCKS">
   7         <parameter moreinfo="none">oplocks</parameter></link>
   8         parameter is turned on for a share. It allows the Samba administrator
   9         to selectively turn off the granting of oplocks on selected files that
  10         match a wildcarded list, similar to the wildcarded list used in the
  11         <link linkend="VETOFILES"><parameter moreinfo="none">veto files</parameter></link>
  12         parameter.</para>
  13
  14
  15         <para>You might want to do this on files that you know will
  16         be heavily contended for by clients. A good example of this
  17         is in the NetBench SMB benchmark program, which causes heavy
  18         client contention for files ending in <filename moreinfo="none">.SEM</filename>.
  19         To cause Samba not to grant oplocks on these files you would use
  20         the line (either in the [global] section or in the section for
  21         the particular NetBench share :</para>
  22 </description>
  23 <value type="default"><comment>No files are vetoed for oplock grants</comment></value>
  24 <value type="example">/.*SEM/</value>
  25 </samba:parameter>