blob: 1b67100b7eb3c33815c90780ada8c6cec08fee56 (
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
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
|
<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>
|