diff mbox

manpage: document the mount.cifs vers= option

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

Commit Message

Jeff Layton March 19, 2013, 2:35 p.m. UTC
Signed-off-by: Jeff Layton <jlayton@samba.org>
---
 mount.cifs.8 | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

Comments

Tom Talpey March 19, 2013, 2:58 p.m. UTC | #1
A couple of comments on the SMB2/3 revision history below.

> -----Original Message-----
> From: linux-cifs-owner@vger.kernel.org [mailto:linux-cifs-
> owner@vger.kernel.org] On Behalf Of Jeff Layton
> Sent: Tuesday, March 19, 2013 10:35 AM
> To: linux-cifs@vger.kernel.org
> Subject: [PATCH] manpage: document the mount.cifs vers= option
> 
> 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..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@vger.kernel.org More majordomo info at
> http://vger.kernel.org/majordomo-info.html
--
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..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: