diff mbox

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

Message ID 1363708534-25460-1-git-send-email-jlayton@samba.org (mailing list archive)
State New, archived
Headers show

Commit Message

Jeff Layton March 19, 2013, 3:55 p.m. UTC
Thanks to Tom Talpey for clarifying some of the info here.

Cc: Tom Talpey <ttalpey@microsoft.com>
Signed-off-by: Jeff Layton <jlayton@samba.org>
---
 mount.cifs.8 | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

Comments

Tom Talpey March 19, 2013, 4:49 p.m. UTC | #1
> -----Original Message-----
> From: Jeff Layton [mailto:jlayton@poochiereds.net] On Behalf Of Jeff Layton
> Sent: Tuesday, March 19, 2013 11:56 AM
> To: linux-cifs@vger.kernel.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@microsoft.com>
> Signed-off-by: Jeff Layton <jlayton@samba.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

--
To unsubscribe from this list: send the line "unsubscribe linux-cifs" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
diff mbox

Patch

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: