CVE-2016-2115: docs-xml: add "client ipc min protocol" and "client ipc max protocol...
[samba.git] / docs-xml / smbdotconf / protocol / clientmaxprotocol.xml
1 <samba:parameter name="client max protocol"
2                  context="G"
3                  type="enum"
4                  function="_client_max_protocol"
5                  enumlist="enum_protocol"
6                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
7 <description>
8     <para>The value of the parameter (a string) is the highest 
9     protocol level that will be supported by the client.</para>
10
11     <para>Possible values are :</para>
12     <itemizedlist>
13         <listitem>
14             <para><constant>CORE</constant>: Earliest version. No 
15             concept of user names.</para>
16         </listitem>
17                         
18         <listitem>
19             <para><constant>COREPLUS</constant>: Slight improvements on 
20             CORE for efficiency.</para>
21         </listitem>
22
23         <listitem>
24             <para><constant>LANMAN1</constant>: First <emphasis>modern</emphasis>
25             version of the protocol. Long filename support.</para>
26         </listitem>
27
28         <listitem>
29             <para><constant>LANMAN2</constant>: Updates to Lanman1 protocol.</para>
30         </listitem>
31
32         <listitem>
33             <para><constant>NT1</constant>: Current up to date version of the protocol. 
34             Used by Windows NT. Known as CIFS.</para>
35         </listitem>
36
37         <listitem>
38             <para><constant>SMB2</constant>: Re-implementation of the SMB protocol.
39             Used by Windows Vista and later versions of Windows. SMB2 has sub protocols available.</para>
40             <itemizedlist>
41                 <listitem>
42                     <para><constant>SMB2_02</constant>: The earliest SMB2 version.</para>
43                 </listitem>
44                 <listitem>
45                     <para><constant>SMB2_10</constant>: Windows 7 SMB2 version.</para>
46                 </listitem>
47                 <listitem>
48                     <para><constant>SMB2_22</constant>: Early Windows 8 SMB2 version.</para>
49                 </listitem>
50                 <listitem>
51                     <para><constant>SMB2_24</constant>: Windows 8 beta SMB2 version.</para>
52                 </listitem>
53             </itemizedlist>
54             <para>By default SMB2 selects the SMB2_10 variant.</para>
55         </listitem>
56
57         <listitem>
58             <para><constant>SMB3</constant>: The same as SMB2.
59             Used by Windows 8. SMB3 has sub protocols available.</para>
60             <itemizedlist>
61                 <listitem>
62                     <para><constant>SMB3_00</constant>: Windows 8 SMB3 version. (mostly the same as SMB2_24)</para>
63                 </listitem>
64                 <listitem>
65                     <para><constant>SMB3_02</constant>: Windows 8.1 SMB3 version.</para>
66                 </listitem>
67                 <listitem>
68                     <para><constant>SMB3_10</constant>: early Windows 10 technical preview SMB3 version.</para>
69                 </listitem>
70                 <listitem>
71                     <para><constant>SMB3_11</constant>: Windows 10 technical preview SMB3 version (maybe final).</para>
72                 </listitem>
73             </itemizedlist>
74             <para>By default SMB3 selects the SMB3_11 variant.</para>
75         </listitem>
76     </itemizedlist>
77
78     <para>Normally this option should not be set as the automatic 
79     negotiation phase in the SMB protocol takes care of choosing 
80     the appropriate protocol.</para>
81
82     <para>The value <constant>default</constant> refers to <constant>NT1</constant>.</para>
83
84     <para>IPC$ connections for DCERPC e.g. in winbindd, are handled by the
85     <smbconfoption name="client ipc max protocol"/> option.</para>
86 </description>
87
88 <related>server max protocol</related>
89 <related>client min protocol</related>
90 <related>client ipc min protocol</related>
91 <related>client ipc max protocol</related>
92
93 <value type="default">default</value>
94 <value type="example">LANMAN1</value>
95 </samba:parameter>