docs-xml/smbdotconf/protocol/smb2_disable_oplock_break_retry.xml

   1 <samba:parameter name="smb2 disable oplock break retry"
   2                  context="G"
   3                  type="boolean"
   4                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   5 <description>
   6     <para>This boolean parameter controls whether
   7     <citerefentry><refentrytitle>smbd</refentrytitle>
   8     <manvolnum>8</manvolnum></citerefentry> will trigger
   9     smb2 oplock break notification retries when using
  10     <smbconfoption name="server multi channel support">yes</smbconfoption>.
  11     </para>
  12
  13     <para>The [MS-SMB2] specification documents that a server should
  14     send smb2 oplock break notification retries on all available channel
  15     to the given client.</para>
  16
  17     <para>But Windows Server versions (at least up to 2019) do not send
  18     smb2 oplock break notification retries on channel failures.
  19     That means they do not implement the behavior specified
  20     in [MS-SMB2].</para>
  21
  22     <para>By default Samba behaves according to the specification
  23     and send smb2 oplock break notification retries.</para>
  24
  25     <para>Warning: Only enable this option if existing clients can't
  26     handle possible retries and it turns out that the Windows Server
  27     behavior is required.</para>
  28
  29     <para>Note: it's likely that this option gets removed again
  30     if future Windows versions change their behavior.</para>
  31
  32     <para>Note: this only applies to oplocks and not SMB2 leases.</para>
  33 </description>
  34
  35 <related>server multi channel support</related>
  36
  37 <value type="default">no</value>
  38 <value type="example">yes</value>
  39 </samba:parameter>