mirror of
https://github.com/samba-team/samba.git
synced 2025-02-03 13:47:25 +03:00
bc10e5039a
Signed-off-by: Stefan Metzmacher <metze@samba.org> Reviewed-by: Günther Deschner <gd@samba.org>
40 lines
1.5 KiB
XML
40 lines
1.5 KiB
XML
<samba:parameter name="smb2 disable oplock break retry"
|
|
context="G"
|
|
type="boolean"
|
|
xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
|
|
<description>
|
|
<para>This boolean parameter controls whether
|
|
<citerefentry><refentrytitle>smbd</refentrytitle>
|
|
<manvolnum>8</manvolnum></citerefentry> will trigger
|
|
smb2 oplock break notification retries when using
|
|
<smbconfoption name="server multi channel support">yes</smbconfoption>.
|
|
</para>
|
|
|
|
<para>The [MS-SMB2] specification documents that a server should
|
|
send smb2 oplock break notification retries on all available channel
|
|
to the given client.</para>
|
|
|
|
<para>But Windows Server versions (at least up to 2019) do not send
|
|
smb2 oplock break notification retries on channel failures.
|
|
That means they do not implement the behavior specified
|
|
in [MS-SMB2].</para>
|
|
|
|
<para>By default Samba behaves according to the specification
|
|
and send smb2 oplock break notification retries.</para>
|
|
|
|
<para>Warning: Only enable this option if existing clients can't
|
|
handle possible retries and it turns out that the Windows Server
|
|
behavior is required.</para>
|
|
|
|
<para>Note: it's likely that this option gets removed again
|
|
if future Windows versions change their behavior.</para>
|
|
|
|
<para>Note: this only applies to oplocks and not SMB2 leases.</para>
|
|
</description>
|
|
|
|
<related>server multi channel support</related>
|
|
|
|
<value type="default">no</value>
|
|
<value type="example">yes</value>
|
|
</samba:parameter>
|