[PATCH] manpage: document the mount.cifs vers= option

[PATCH] manpage: document the mount.cifs vers= option

[Jeff Layton]

Signed-off-by: Jeff Layton <jlayton-eUNUBHrolfbYtjvyW6yDsg@public.gmane.org>
---
 mount.cifs.8 | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/mount.cifs.8 b/mount.cifs.8
index a4fdd98..6f105ad 100644
--- a/mount.cifs.8
+++ b/mount.cifs.8
@@ -539,6 +539,57 @@ prefixpath=
 It's possible to mount a subdirectory of a share. The preferred way to do this is to append the path to the UNC when mounting. However, it's also possible to do the same by setting this option and providing the path there.
 .RE
 .PP
+vers=
+.RS 4
+SMB protocol version. Allowed values are:
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+1.0 - SMBv1.0: The classic SMB/CIFS protocol. This is the default.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+2.0 - SMBv2.0: The SMB2.0 protocol which was introduced in Microsoft Windows Vista.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+2.1 - SMBv2.1: The SMB2.1 protocol that was introduced in Microsoft Windows 7.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+3.0 - SMBv3.0: The SMB3.0 protocol that was introduced in Microsoft Windows 8 and Server 2012.
+.RE
+.PP
+Note too that while this option governs the protocol version used, not all features of each version are available.
+.RE
+.PP
 \-\-verbose
 .RS 4
 Print additional debugging information for the mount\&. Note that this parameter must be specified before the \-o\&. For example:
-- 
1.7.11.7

RE: [PATCH] manpage: document the mount.cifs vers= option

[Tom Talpey]

A couple of comments on the SMB2/3 revision history below.

> -----Original Message-----
> From: linux-cifs-owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org [mailto:linux-cifs-
> owner-u79uwXL29TY76Z2rM5mHXA@public.gmane.org] On Behalf Of Jeff Layton
> Sent: Tuesday, March 19, 2013 10:35 AM
> To: linux-cifs-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
> Subject: [PATCH] manpage: document the mount.cifs vers= option
> 
> Signed-off-by: Jeff Layton <jlayton-eUNUBHrolfbYtjvyW6yDsg@public.gmane.org>
> ---
>  mount.cifs.8 | 51
> +++++++++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 51 insertions(+)
> 
> diff --git a/mount.cifs.8 b/mount.cifs.8 index a4fdd98..6f105ad 100644
> --- a/mount.cifs.8
> +++ b/mount.cifs.8
> @@ -539,6 +539,57 @@ prefixpath=
>  It's possible to mount a subdirectory of a share. The preferred way to do this
> is to append the path to the UNC when mounting. However, it's also possible
> to do the same by setting this option and providing the path there.
>  .RE
>  .PP
> +vers=
> +.RS 4
> +SMB protocol version. Allowed values are:
> +.sp
> +.RS 4
> +.ie n \{\
> +\h'-04'\(bu\h'+03'\c
> +.\}
> +.el \{\
> +.sp -1
> +.IP \(bu 2.3
> +.\}
> +1.0 - SMBv1.0: The classic SMB/CIFS protocol. This is the default.
> +.RE
> +.sp
> +.RS 4
> +.ie n \{\
> +\h'-04'\(bu\h'+03'\c
> +.\}
> +.el \{\
> +.sp -1
> +.IP \(bu 2.3
> +.\}
> +2.0 - SMBv2.0: The SMB2.0 protocol which was introduced in Microsoft
> Windows Vista.

SMB2.0 was introduced in Vista, but was not supported until Vista Service Pack 1, and Windows Server 2008. The dialect was changed to 2.002 in these releases, btw.

Also the word "which" is different from the two other cases below, which use "that". 

> +.RE
> +.sp
> +.RS 4
> +.ie n \{\
> +\h'-04'\(bu\h'+03'\c
> +.\}
> +.el \{\
> +.sp -1
> +.IP \(bu 2.3
> +.\}
> +2.1 - SMBv2.1: The SMB2.1 protocol that was introduced in Microsoft
> Windows 7.

SMB2.1 was also supported by Windows Server 2008R2.

> +.RE
> +.sp
> +.RS 4
> +.ie n \{\
> +\h'-04'\(bu\h'+03'\c
> +.\}
> +.el \{\
> +.sp -1
> +.IP \(bu 2.3
> +.\}
> +3.0 - SMBv3.0: The SMB3.0 protocol that was introduced in Microsoft
> Windows 8 and Server 2012.

"Windows Server 2012".

> +.RE
> +.PP
> +Note too that while this option governs the protocol version used, not all
> features of each version are available.
> +.RE
> +.PP
>  \-\-verbose
>  .RS 4
>  Print additional debugging information for the mount\&. Note that this
> parameter must be specified before the \-o\&. For example:
> --
> 1.7.11.7
> 
> --
> To unsubscribe from this list: send the line "unsubscribe linux-cifs" in the
> body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org More majordomo info at
> http://vger.kernel.org/majordomo-info.html

[PATCH v2][cifs-utils] manpage: document the mount.cifs vers= option

[Jeff Layton]

Thanks to Tom Talpey for clarifying some of the info here.

Cc: Tom Talpey <ttalpey-0li6OtcxBFHby3iVrkZq2A@public.gmane.org>
Signed-off-by: Jeff Layton <jlayton-eUNUBHrolfbYtjvyW6yDsg@public.gmane.org>
---
 mount.cifs.8 | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/mount.cifs.8 b/mount.cifs.8
index a4fdd98..1cd2de5 100644
--- a/mount.cifs.8
+++ b/mount.cifs.8
@@ -539,6 +539,57 @@ prefixpath=
 It's possible to mount a subdirectory of a share. The preferred way to do this is to append the path to the UNC when mounting. However, it's also possible to do the same by setting this option and providing the path there.
 .RE
 .PP
+vers=
+.RS 4
+SMB protocol version. Allowed values are:
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+1.0 - The classic CIFS/SMBv1 protocol. This is the default.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+2.0 - The SMBv2.0 protocol that was introduced in Microsoft Windows Vista and Windows Server 2008. Note that the dialect number in the on-the-wire protocol with this version is technically "2.002".
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+2.1 - The SMBv2.1 protocol that was introduced in Microsoft Windows 7 and Windows Server 2008R2.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+3.0 - The SMBv3.0 protocol that was introduced in Microsoft Windows 8 and Windows Server 2012.
+.RE
+.PP
+Note too that while this option governs the protocol version used, not all features of each version are available.
+.RE
+.PP
 \-\-verbose
 .RS 4
 Print additional debugging information for the mount\&. Note that this parameter must be specified before the \-o\&. For example:
-- 
1.7.11.7

RE: [PATCH v2][cifs-utils] manpage: document the mount.cifs vers= option

[Tom Talpey]

> -----Original Message-----
> From: Jeff Layton [mailto:jlayton-vpEMnDpepFuMZCB2o+C8xQ@public.gmane.org] On Behalf Of Jeff Layton
> Sent: Tuesday, March 19, 2013 11:56 AM
> To: linux-cifs-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
> Cc: Tom Talpey
> Subject: [PATCH v2][cifs-utils] manpage: document the mount.cifs vers=
> option
> 
> Thanks to Tom Talpey for clarifying some of the info here.
> 
> Cc: Tom Talpey <ttalpey-0li6OtcxBFHby3iVrkZq2A@public.gmane.org>
> Signed-off-by: Jeff Layton <jlayton-eUNUBHrolfbYtjvyW6yDsg@public.gmane.org>
> ---
>  mount.cifs.8 | 51
> +++++++++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 51 insertions(+)
> 
> diff --git a/mount.cifs.8 b/mount.cifs.8 index a4fdd98..1cd2de5 100644
> --- a/mount.cifs.8
> +++ b/mount.cifs.8
> @@ -539,6 +539,57 @@ prefixpath=
>  It's possible to mount a subdirectory of a share. The preferred way to do this
> is to append the path to the UNC when mounting. However, it's also possible
> to do the same by setting this option and providing the path there.
>  .RE
>  .PP
> +vers=
> +.RS 4
> +SMB protocol version. Allowed values are:
> +.sp
> +.RS 4
> +.ie n \{\
> +\h'-04'\(bu\h'+03'\c
> +.\}
> +.el \{\
> +.sp -1
> +.IP \(bu 2.3
> +.\}
> +1.0 - The classic CIFS/SMBv1 protocol. This is the default.
> +.RE
> +.sp
> +.RS 4
> +.ie n \{\
> +\h'-04'\(bu\h'+03'\c
> +.\}
> +.el \{\
> +.sp -1
> +.IP \(bu 2.3
> +.\}
> +2.0 - The SMBv2.0 protocol that was introduced in Microsoft Windows Vista

Vista *Service Pack 1*. Vista RTM, which speaks dialect 2.000, only interoperates
with itself. Unless the cifs.ko client speaks 2.000 - does it? Not recommended!

Tom.

> and Windows Server 2008. Note that the dialect number in the on-the-wire
> protocol with this version is technically "2.002".
> +.RE
> +.sp
> +.RS 4
> +.ie n \{\
> +\h'-04'\(bu\h'+03'\c
> +.\}
> +.el \{\
> +.sp -1
> +.IP \(bu 2.3
> +.\}
> +2.1 - The SMBv2.1 protocol that was introduced in Microsoft Windows 7 and
> Windows Server 2008R2.
> +.RE
> +.sp
> +.RS 4
> +.ie n \{\
> +\h'-04'\(bu\h'+03'\c
> +.\}
> +.el \{\
> +.sp -1
> +.IP \(bu 2.3
> +.\}
> +3.0 - The SMBv3.0 protocol that was introduced in Microsoft Windows 8 and
> Windows Server 2012.
> +.RE
> +.PP
> +Note too that while this option governs the protocol version used, not all
> features of each version are available.
> +.RE
> +.PP
>  \-\-verbose
>  .RS 4
>  Print additional debugging information for the mount\&. Note that this
> parameter must be specified before the \-o\&. For example:
> --
> 1.7.11.7

[PATCH v3] manpage: document the mount.cifs vers= option

[Jeff Layton]

Thanks to Tom Talpey for clarifying some of the info here.

Cc: Tom Talpey <ttalpey-0li6OtcxBFHby3iVrkZq2A@public.gmane.org>
Signed-off-by: Jeff Layton <jlayton-eUNUBHrolfbYtjvyW6yDsg@public.gmane.org>
---
 mount.cifs.8 | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/mount.cifs.8 b/mount.cifs.8
index a4fdd98..515bd40 100644
--- a/mount.cifs.8
+++ b/mount.cifs.8
@@ -539,6 +539,57 @@ prefixpath=
 It's possible to mount a subdirectory of a share. The preferred way to do this is to append the path to the UNC when mounting. However, it's also possible to do the same by setting this option and providing the path there.
 .RE
 .PP
+vers=
+.RS 4
+SMB protocol version. Allowed values are:
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+1.0 - The classic CIFS/SMBv1 protocol. This is the default.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+2.0 - The SMBv2.002 protocol. This was initially introduced in Windows Vista Service Pack 1, and Windows Server 2008. Note that the initial release version of Windows Vista spoke a slightly different dialect (2.000) that is not supported.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+2.1 - The SMBv2.1 protocol that was introduced in Microsoft Windows 7 and Windows Server 2008R2.
+.RE
+.sp
+.RS 4
+.ie n \{\
+\h'-04'\(bu\h'+03'\c
+.\}
+.el \{\
+.sp -1
+.IP \(bu 2.3
+.\}
+3.0 - The SMBv3.0 protocol that was introduced in Microsoft Windows 8 and Windows Server 2012.
+.RE
+.PP
+Note too that while this option governs the protocol version used, not all features of each version are available.
+.RE
+.PP
 \-\-verbose
 .RS 4
 Print additional debugging information for the mount\&. Note that this parameter must be specified before the \-o\&. For example:
-- 
1.7.11.7