| Message ID | 20171104205151.3507-1-jlayton@kernel.org |
|---|---|
| State | New |
| Headers | show |
| Series | [cifs-utils,v3] manpage: update mount.cifs manpage with info about default version being mounted | expand |
2017-11-04 13:51 GMT-07:00 Jeff Layton <jlayton@kernel.org>: > From: Jeff Layton <jlayton@samba.org> > > Signed-off-by: Jeff Layton <jlayton@samba.org> > --- > mount.cifs.rst | 7 +++++-- > 1 file changed, 5 insertions(+), 2 deletions(-) > > diff --git a/mount.cifs.rst b/mount.cifs.rst > index 9714f795fe76..499b9a778927 100644 > --- a/mount.cifs.rst > +++ b/mount.cifs.rst > @@ -517,7 +517,7 @@ prefixpath=arg > vers=arg > SMB protocol version. Allowed values are: > > - - 1.0 - The classic CIFS/SMBv1 protocol. This is the default. > + - 1.0 - The classic CIFS/SMBv1 protocol. > - 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 > @@ -529,6 +529,10 @@ vers=arg > Note too that while this option governs the protocol version used, not > all features of each version are available. > > + In kernels v4.13.5 and later, the client and server negotiate a version > + greater than or equal to ``2.1``. In kernels prior to v4.13.5, the default > + is ``1.0``. Between v4.13 and v4.13.4 (included) the default is 3.0, not sure if we should be so precise here. > + > --verbose > Print additional debugging information for the mount. Note that this > parameter must be specified before the ``-o`` . For example:: > @@ -857,4 +861,3 @@ Steve French > The maintainer of the Linux cifs vfs and the userspace tool mount.cifs > is Steve French. The Linux CIFS Mailing list is the preferred place to > ask questions regarding these programs. > - > \ No newline at end of file > -- > 2.13.6 > > -- > 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 -- Best regards, Pavel Shilovsky -- 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
On Sat, 2017-11-04 at 18:27 -0700, Pavel Shilovsky wrote: > 2017-11-04 13:51 GMT-07:00 Jeff Layton <jlayton@kernel.org>: > > From: Jeff Layton <jlayton@samba.org> > > > > Signed-off-by: Jeff Layton <jlayton@samba.org> > > --- > > mount.cifs.rst | 7 +++++-- > > 1 file changed, 5 insertions(+), 2 deletions(-) > > > > diff --git a/mount.cifs.rst b/mount.cifs.rst > > index 9714f795fe76..499b9a778927 100644 > > --- a/mount.cifs.rst > > +++ b/mount.cifs.rst > > @@ -517,7 +517,7 @@ prefixpath=arg > > vers=arg > > SMB protocol version. Allowed values are: > > > > - - 1.0 - The classic CIFS/SMBv1 protocol. This is the default. > > + - 1.0 - The classic CIFS/SMBv1 protocol. > > - 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 > > @@ -529,6 +529,10 @@ vers=arg > > Note too that while this option governs the protocol version used, not > > all features of each version are available. > > > > + In kernels v4.13.5 and later, the client and server negotiate a version > > + greater than or equal to ``2.1``. In kernels prior to v4.13.5, the default > > + is ``1.0``. > > Between v4.13 and v4.13.4 (included) the default is 3.0, not sure if > we should be so precise here. > Grumble...the merge of that feature outside the normal merge window makes this difficult to document. How about this? The default since v4.13.5 is for the client and server to negotiate the highest possible version greater than or equal to ``2.1``. In kernels prior to v4.13, the default was ``1.0``. For kernels between v4.13 and v4.13.5 the default is ``3.0``. It's still awkward, but I think it's correct. > > + > > --verbose > > Print additional debugging information for the mount. Note that this > > parameter must be specified before the ``-o`` . For example:: > > @@ -857,4 +861,3 @@ Steve French > > The maintainer of the Linux cifs vfs and the userspace tool mount.cifs > > is Steve French. The Linux CIFS Mailing list is the preferred place to > > ask questions regarding these programs. > > - > > \ No newline at end of file > > -- > > 2.13.6 > > > > -- > > 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 > > > -- > Best regards, > Pavel Shilovsky
2017-11-05 5:35 GMT-08:00 Jeff Layton <jlayton@kernel.org>: > On Sat, 2017-11-04 at 18:27 -0700, Pavel Shilovsky wrote: >> 2017-11-04 13:51 GMT-07:00 Jeff Layton <jlayton@kernel.org>: >> > From: Jeff Layton <jlayton@samba.org> >> > >> > Signed-off-by: Jeff Layton <jlayton@samba.org> >> > --- >> > mount.cifs.rst | 7 +++++-- >> > 1 file changed, 5 insertions(+), 2 deletions(-) >> > >> > diff --git a/mount.cifs.rst b/mount.cifs.rst >> > index 9714f795fe76..499b9a778927 100644 >> > --- a/mount.cifs.rst >> > +++ b/mount.cifs.rst >> > @@ -517,7 +517,7 @@ prefixpath=arg >> > vers=arg >> > SMB protocol version. Allowed values are: >> > >> > - - 1.0 - The classic CIFS/SMBv1 protocol. This is the default. >> > + - 1.0 - The classic CIFS/SMBv1 protocol. >> > - 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 >> > @@ -529,6 +529,10 @@ vers=arg >> > Note too that while this option governs the protocol version used, not >> > all features of each version are available. >> > >> > + In kernels v4.13.5 and later, the client and server negotiate a version >> > + greater than or equal to ``2.1``. In kernels prior to v4.13.5, the default >> > + is ``1.0``. >> >> Between v4.13 and v4.13.4 (included) the default is 3.0, not sure if >> we should be so precise here. >> > > Grumble...the merge of that feature outside the normal merge window > makes this difficult to document. How about this? > > The default since v4.13.5 is for the client and server to negotiate > the highest possible version greater than or equal to ``2.1``. In > kernels prior to v4.13, the default was ``1.0``. For kernels > between v4.13 and v4.13.5 the default is ``3.0``. > > It's still awkward, but I think it's correct. Looks good. Reviewed-by: Pavel Shilovsky <pshilov@microsoft.com> -- Best regards, Pavel Shilovsky -- 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
On Sun, 2017-11-05 at 10:06 -0800, Pavel Shilovsky wrote:
> Reviewed-by: Pavel Shilovsky <pshilov@microsoft.com>
Thanks, merged into master branch.
diff --git a/mount.cifs.rst b/mount.cifs.rst index 9714f795fe76..499b9a778927 100644 --- a/mount.cifs.rst +++ b/mount.cifs.rst @@ -517,7 +517,7 @@ prefixpath=arg vers=arg SMB protocol version. Allowed values are: - - 1.0 - The classic CIFS/SMBv1 protocol. This is the default. + - 1.0 - The classic CIFS/SMBv1 protocol. - 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 @@ -529,6 +529,10 @@ vers=arg Note too that while this option governs the protocol version used, not all features of each version are available. + In kernels v4.13.5 and later, the client and server negotiate a version + greater than or equal to ``2.1``. In kernels prior to v4.13.5, the default + is ``1.0``. + --verbose Print additional debugging information for the mount. Note that this parameter must be specified before the ``-o`` . For example:: @@ -857,4 +861,3 @@ Steve French The maintainer of the Linux cifs vfs and the userspace tool mount.cifs is Steve French. The Linux CIFS Mailing list is the preferred place to ask questions regarding these programs. - \ No newline at end of file