summaryrefslogtreecommitdiffstats
path: root/docs-xml/smbdotconf/protocol/clientmaxprotocol.xml
blob: 784123ecadf6e84a79af8f1142a9d8e90394f3e4 (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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
<samba:parameter name="client max protocol"
                 context="G"
                 type="enum"
                 function="_client_max_protocol"
                 enumlist="enum_protocol"
                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
<description>
    <para>The value of the parameter (a string) is the highest 
    protocol level that will be supported by the client.</para>

    <para>Possible values are :</para>
    <itemizedlist>
	<listitem>
	    <para><constant>CORE</constant>: Earliest version. No 
	    concept of user names.</para>
	</listitem>
			
	<listitem>
	    <para><constant>COREPLUS</constant>: Slight improvements on 
	    CORE for efficiency.</para>
	</listitem>

	<listitem>
	    <para><constant>LANMAN1</constant>: First <emphasis>modern</emphasis>
	    version of the protocol. Long filename support.</para>
	</listitem>

	<listitem>
	    <para><constant>LANMAN2</constant>: Updates to Lanman1 protocol.</para>
	</listitem>

	<listitem>
	    <para><constant>NT1</constant>: Current up to date version of the protocol. 
	    Used by Windows NT. Known as CIFS.</para>
	</listitem>

	<listitem>
	    <para><constant>SMB2</constant>: Re-implementation of the SMB protocol.
	    Used by Windows Vista and later versions of Windows. SMB2 has sub protocols available.</para>
	    <itemizedlist>
		<listitem>
		    <para><constant>SMB2_02</constant>: The earliest SMB2 version.</para>
		</listitem>
		<listitem>
		    <para><constant>SMB2_10</constant>: Windows 7 SMB2 version.</para>
		</listitem>
	    </itemizedlist>
	    <para>By default SMB2 selects the SMB2_10 variant.</para>
	</listitem>

	<listitem>
	    <para><constant>SMB3</constant>: The same as SMB2.
	    Used by Windows 8. SMB3 has sub protocols available.</para>
	    <itemizedlist>
		<listitem>
		    <para><constant>SMB3_00</constant>: Windows 8 SMB3 version.</para>
		</listitem>
		<listitem>
		    <para><constant>SMB3_02</constant>: Windows 8.1 SMB3 version.</para>
		</listitem>
		<listitem>
		    <para><constant>SMB3_11</constant>: Windows 10 SMB3 version.</para>
		</listitem>
	    </itemizedlist>
	    <para>By default SMB3 selects the SMB3_11 variant.</para>
	</listitem>
    </itemizedlist>

    <para>Normally this option should not be set as the automatic 
    negotiation phase in the SMB protocol takes care of choosing 
    the appropriate protocol.</para>

    <para>The value <constant>default</constant> refers to <constant>SMB3_11</constant>.</para>

    <para>IPC$ connections for DCERPC e.g. in winbindd, are handled by the
    <smbconfoption name="client ipc max protocol"/> option.</para>
</description>

<related>server max protocol</related>
<related>client min protocol</related>
<related>client ipc min protocol</related>
<related>client ipc max protocol</related>

<value type="default">default</value>
<value type="example">LANMAN1</value>
</samba:parameter>