From: Zorro Lang <zlang@kernel.org>
To: fstests@vger.kernel.org
Cc: David Sterba <dsterba@suse.com>, linux-fsdevel@vger.kernel.org
Subject: [PATCH v2] README: add supported fs list
Date: Sat, 29 Mar 2025 00:46:09 +0800 [thread overview]
Message-ID: <20250328164609.188062-1-zlang@kernel.org> (raw)
To clarify the supported filesystems by fstests, add a fs list to
README file.
Signed-off-by: Zorro Lang <zlang@kernel.org>
Acked-by: "Darrick J. Wong" <djwong@kernel.org>
---
The v1 patch and review points:
https://lore.kernel.org/fstests/20250227200514.4085734-1-zlang@kernel.org/
V2 did below things:
1) Fix some wrong english sentences
2) Explain the meaning of "+" and "-".
3) Add a link to btrfs comment.
4) Split ext2/3/4 to 3 lines.
5) Reorder the fs list by "Level".
Thanks,
Zorro
README | 90 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 90 insertions(+)
diff --git a/README b/README
index 024d39531..5ceaa0c1e 100644
--- a/README
+++ b/README
@@ -1,3 +1,93 @@
+_______________________
+SUPPORTED FS LIST
+_______________________
+
+History
+-------
+
+Firstly, xfstests is the old name of this project, due to it was originally
+developed for testing the XFS file system on the SGI's Irix operating system.
+When xfs was ported to Linux, so was xfstests, now it only supports Linux.
+
+As xfstests has many test cases that can be run on some other filesystems,
+we call them "generic" (and "shared", but it has been removed) cases, you
+can find them in tests/generic/ directory. Then more and more filesystems
+started to use xfstests, and contribute patches. Today xfstests is used
+as a file system regression test suite for lots of Linux's major file systems.
+So it's not "xfs"tests only, we tend to call it "fstests" now.
+
+Supported fs
+------------
+
+Firstly, there's not hard restriction about which filesystem can use fstests.
+Any filesystem can give fstests a try.
+
+Although fstests supports many filesystems, they have different support level
+by fstests. So mark it with 4 levels as below:
+
+L1: Fstests can be run on the specified fs basically.
+L2: Rare support from the specified fs list to fix some generic test failures.
+L3: Normal support from the specified fs list, has some own cases.
+L4: Active support from the fs list, has lots of own cases.
+
+("+" means a slightly higher than the current level, but not reach to the next.
+"-" is opposite, means a little bit lower than the current level.)
+
++------------+-------+---------------------------------------------------------+
+| Filesystem | Level | Comment |
++------------+-------+---------------------------------------------------------+
+| XFS | L4+ | N/A |
++------------+-------+---------------------------------------------------------+
+| Btrfs | L4 | https://btrfs.readthedocs.io/en/latest/dev/Development-\|
+| | | notes.html#fstests-setup |
++------------+-------+---------------------------------------------------------+
+| Ext4 | L4 | N/A |
++------------+-------+---------------------------------------------------------+
+| Ext2 | L3 | N/A |
++------------+-------+---------------------------------------------------------+
+| Ext3 | L3 | N/A |
++------------+-------+---------------------------------------------------------+
+| overlay | L3 | N/A |
++------------+-------+---------------------------------------------------------+
+| f2fs | L3- | N/A |
++------------+-------+---------------------------------------------------------+
+| tmpfs | L3- | N/A |
++------------+-------+---------------------------------------------------------+
+| NFS | L2+ | https://linux-nfs.org/wiki/index.php/Xfstests |
++------------+-------+---------------------------------------------------------+
+| Ceph | L2 | N/A |
++------------+-------+---------------------------------------------------------+
+| CIFS | L2- | https://wiki.samba.org/index.php/Xfstesting-cifs |
++------------+-------+---------------------------------------------------------+
+| ocfs2 | L2- | N/A |
++------------+-------+---------------------------------------------------------+
+| Bcachefs | L1+ | N/A |
++------------+-------+---------------------------------------------------------+
+| Exfat | L1+ | N/A |
++------------+-------+---------------------------------------------------------+
+| AFS | L1 | N/A |
++------------+-------+---------------------------------------------------------+
+| FUSE | L1 | N/A |
++------------+-------+---------------------------------------------------------+
+| GFS2 | L1 | N/A |
++------------+-------+---------------------------------------------------------+
+| Glusterfs | L1 | N/A |
++------------+-------+---------------------------------------------------------+
+| JFS | L1 | N/A |
++------------+-------+---------------------------------------------------------+
+| pvfs2 | L1 | N/A |
++------------+-------+---------------------------------------------------------+
+| Reiser4 | L1 | Reiserfs has been removed, only left reiser4 |
++------------+-------+---------------------------------------------------------+
+| ubifs | L1 | N/A |
++------------+-------+---------------------------------------------------------+
+| udf | L1 | N/A |
++------------+-------+---------------------------------------------------------+
+| Virtiofs | L1 | N/A |
++------------+-------+---------------------------------------------------------+
+| 9p | L1 | N/A |
++------------+-------+---------------------------------------------------------+
+
_______________________
BUILDING THE FSQA SUITE
_______________________
--
2.47.1
next reply other threads:[~2025-03-28 16:46 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-03-28 16:46 Zorro Lang [this message]
2025-04-12 6:26 ` [PATCH v2] README: add supported fs list Zorro Lang
2025-04-12 22:54 ` Anand Jain
2025-04-13 21:56 ` Kent Overstreet
2025-04-14 5:58 ` Zorro Lang
2025-04-14 11:09 ` Kent Overstreet
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250328164609.188062-1-zlang@kernel.org \
--to=zlang@kernel.org \
--cc=dsterba@suse.com \
--cc=fstests@vger.kernel.org \
--cc=linux-fsdevel@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.