Message ID | 20180521225247.17811-1-lsahlber@redhat.com (mailing list archive) |
---|---|
State | New, archived |
Headers | show |
On Tue, May 22, 2018 at 08:52:47AM +1000, Ronnie Sahlberg wrote: > This is a patch to provide quickstart instructions for how to use xfstest > for CIFS. > > Signed-off-by: Ronnie Sahlberg <lsahlber@redhat.com> > --- > README.cifs | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 61 insertions(+) > create mode 100644 README.cifs > > diff --git a/README.cifs b/README.cifs > new file mode 100644 > index 00000000..92efd24d > --- /dev/null > +++ b/README.cifs > @@ -0,0 +1,61 @@ > +This describes how to get up and running using xfstests for the CIFS filesystem. > + > +There are additional information on testing cifs with xfstest on the samba > +wiki : https://wiki.samba.org/index.php/Xfstesting-cifs Thanks for the documentation! But I think we could simply add a pointer to above wiki link in the "Running tests" section in README file, as the wiki page contains all the specific information for running fstests on CIFS (especially the config template link, the excluded test lists), which, IMHO, should be maintained on the wiki not fstests. > + > + > + > +Quick Setup > +=========== > + > +local.config > +------------ > +Xfstests needs two cifs shares. One normal share and one scratch share. > +The data on the scratch share will be destroyed so set this up as a dedicate > +share on your server and do not store anything important in it. > + > +The first thing we need is to set up some stanzas for different smb dialects. > +These dialects can then be selected using the -s command line option making > +it a convenient way to pick a specific version of smb to test. > + > +Download the example configuration and name it local.config: > + > + wget https://wiki.samba.org/images/9/99/Xfstests.local.config.txt \ > + -O local.config > + > +Update local.config and change SERVER, SHARE, SCRATCH, USERNAME, PASSWORD to > +match your shares. > + > +Create the /mnt/test and /mnt/share mountpoints. > + > + > +Exclusion files > +--------------- > +Some tests do not yet work for SMB and some tests take very long so we may want > +to skip them. In CIFS we do this using exclusion files. > + > +Download the exclusion files for smb3 and for very slow tests: > + > + wget https://wiki.samba.org/images/9/99/Xfstests.exclude.very-slow.txt \ BTW, this link gives me a 404 error, so the same link in the wiki page. Thanks, Eryu > + -O tests/cifs/exclude.very-slow > + wget https://wiki.samba.org/images/d/d9/Xfstests.exclude.known-broken-smb3.txt > + -O tests/cifs/exclude.known-broken-smb3 > + > + > +Running full set of tests > +========================= > +With some luck you should be ready to run your first xfstest now. > + > +When runnig the "full" set of tests there are multiple tests that are > +known to fail. Reasons can be that they just don't map well to cifs, > +we are missing features in cifs or there are bugs that needs to be fixed. > + > +For regression testing is useful to run all the tests that are known to work. > +We can acheive this per protocol version using exclude files and filter > +out the known broken tests. > + > +SMB3 > +---- > + > + sudo ./check -s smb3 -E tests/cifs/exclude.known-broken-smb3 \ > + -E tests/cifs/exclude.very-slow > -- > 2.13.3 > > -- > To unsubscribe from this list: send the line "unsubscribe fstests" 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 fstests" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html
On Tue, May 22, 2018 at 08:52:47AM +1000, Ronnie Sahlberg wrote: > This is a patch to provide quickstart instructions for how to use xfstest > for CIFS. > > Signed-off-by: Ronnie Sahlberg <lsahlber@redhat.com> > --- > README.cifs | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 61 insertions(+) > create mode 100644 README.cifs > > diff --git a/README.cifs b/README.cifs > new file mode 100644 > index 00000000..92efd24d > --- /dev/null > +++ b/README.cifs > @@ -0,0 +1,61 @@ > +This describes how to get up and running using xfstests for the CIFS filesystem. > + > +There are additional information on testing cifs with xfstest on the samba > +wiki : https://wiki.samba.org/index.php/Xfstesting-cifs > + > + > + > +Quick Setup > +=========== > + > +local.config > +------------ > +Xfstests needs two cifs shares. One normal share and one scratch share. > +The data on the scratch share will be destroyed so set this up as a dedicate > +share on your server and do not store anything important in it. > + > +The first thing we need is to set up some stanzas for different smb dialects. > +These dialects can then be selected using the -s command line option making > +it a convenient way to pick a specific version of smb to test. > + > +Download the example configuration and name it local.config: > + > + wget https://wiki.samba.org/images/9/99/Xfstests.local.config.txt \ > + -O local.config We actually have example config files in configs/ already. So why not just add a "example.cifs.config" file in there? > +Update local.config and change SERVER, SHARE, SCRATCH, USERNAME, PASSWORD to > +match your shares. > + > +Create the /mnt/test and /mnt/share mountpoints. > + > + > +Exclusion files > +--------------- > +Some tests do not yet work for SMB and some tests take very long so we may want > +to skip them. In CIFS we do this using exclusion files. > + > +Download the exclusion files for smb3 and for very slow tests: > + > + wget https://wiki.samba.org/images/9/99/Xfstests.exclude.very-slow.txt \ > + -O tests/cifs/exclude.very-slow > + wget https://wiki.samba.org/images/d/d9/Xfstests.exclude.known-broken-smb3.txt > + -O tests/cifs/exclude.known-broken-smb3 I'd prefer we don't deep link to files like this - it's too easy for them to get broken (e.g. by a wiki upgrade and re-org). Can you refer to obtaining them from the "Using xfstests with CIFS" page linked above instead? Also, it would be better to refer to tests that are not compatible with CIFS to call them "incompatible" instead of "broken". Broken implies there's something wrong with the tests, and that's not the case here. The first impression of "oh, there's lots of broken tests in xfstests" is not correct, nor is it a good one. Cheers, Dave.
diff --git a/README.cifs b/README.cifs new file mode 100644 index 00000000..92efd24d --- /dev/null +++ b/README.cifs @@ -0,0 +1,61 @@ +This describes how to get up and running using xfstests for the CIFS filesystem. + +There are additional information on testing cifs with xfstest on the samba +wiki : https://wiki.samba.org/index.php/Xfstesting-cifs + + + +Quick Setup +=========== + +local.config +------------ +Xfstests needs two cifs shares. One normal share and one scratch share. +The data on the scratch share will be destroyed so set this up as a dedicate +share on your server and do not store anything important in it. + +The first thing we need is to set up some stanzas for different smb dialects. +These dialects can then be selected using the -s command line option making +it a convenient way to pick a specific version of smb to test. + +Download the example configuration and name it local.config: + + wget https://wiki.samba.org/images/9/99/Xfstests.local.config.txt \ + -O local.config + +Update local.config and change SERVER, SHARE, SCRATCH, USERNAME, PASSWORD to +match your shares. + +Create the /mnt/test and /mnt/share mountpoints. + + +Exclusion files +--------------- +Some tests do not yet work for SMB and some tests take very long so we may want +to skip them. In CIFS we do this using exclusion files. + +Download the exclusion files for smb3 and for very slow tests: + + wget https://wiki.samba.org/images/9/99/Xfstests.exclude.very-slow.txt \ + -O tests/cifs/exclude.very-slow + wget https://wiki.samba.org/images/d/d9/Xfstests.exclude.known-broken-smb3.txt + -O tests/cifs/exclude.known-broken-smb3 + + +Running full set of tests +========================= +With some luck you should be ready to run your first xfstest now. + +When runnig the "full" set of tests there are multiple tests that are +known to fail. Reasons can be that they just don't map well to cifs, +we are missing features in cifs or there are bugs that needs to be fixed. + +For regression testing is useful to run all the tests that are known to work. +We can acheive this per protocol version using exclude files and filter +out the known broken tests. + +SMB3 +---- + + sudo ./check -s smb3 -E tests/cifs/exclude.known-broken-smb3 \ + -E tests/cifs/exclude.very-slow
This is a patch to provide quickstart instructions for how to use xfstest for CIFS. Signed-off-by: Ronnie Sahlberg <lsahlber@redhat.com> --- README.cifs | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 README.cifs