Skip to contentSkip to conversation

README: add supported fs list

PATCH Superseded Zorro Lang 4 participants 6 messages Feb 27, 2025 – Mar 1, 2025 VFS

v1 of 2 Superseded Latest is v2 →

lore
Share & tools
lore

Zorro Lang

author
#0 lore raw

PATCH 1/1 README: add supported fs list

To clarify the supported filesystems by fstests, add a fs list to README file.

---

Hi,

David Sterba suggests to have a supported fs list in fstests:

https://lore.kernel.org/fstests/20250227073535.7gt7mj5gunp67axr@dell-per750-06-vm-08.rhts.eng.pek2.redhat.com/T/#m742e4f1f6668d39c1a48450e7176a366e0a2f6f9

I think that's a good suggestion, so I send this patch now. But tell the truth, it's hard to find all filesystems which are supported by fstests. Especially some filesystems might use fstests, but never be metioned in fstests code. So please review this patch or send another patch to tell fstests@ list, if you know any other filesystem is suppported.

And if anyone has review point about the support "level" and "comment" part, please feel free to tell me :)

Thanks,
Zorro

 README | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)
README +82 -0
index 024d39531..055935917 100644
@@ -1,3 +1,85 @@
+_______________________
+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.
+With xfs was ported to Linux, so was xfstests, now it only supports Linux.
+
+As xfstests has some test cases are good to 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.
+
++------------+-------+---------------------------------------------------------+
+| Filesystem | Level |                       Comment                           |
++------------+-------+---------------------------------------------------------+
+| AFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Bcachefs   |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Btrfs      |  L4   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Ceph       |  L2   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| CIFS       |  L2-  | https://wiki.samba.org/index.php/Xfstesting-cifs        |
++------------+-------+---------------------------------------------------------+
+| Ext2/3/4   |  L3+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Exfat      |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| f2fs       |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| FUSE       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| GFS2       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Glusterfs  |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| JFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| NFS        |  L2+  | https://linux-nfs.org/wiki/index.php/Xfstests           |
++------------+-------+---------------------------------------------------------+
+| ocfs2      |  L2-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| overlay    |  L3   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| pvfs2      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Reiser4    |  L1   | Reiserfs has been removed, only left reiser4            |
++------------+-------+---------------------------------------------------------+
+| tmpfs      |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| ubifs      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| udf        |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Virtiofs   |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| XFS        |  L4+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| 9p         |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+
 _______________________
 BUILDING THE FSQA SUITE
 _______________________
Signature · 1 line
2.47.1
#1 lore raw
Quoted 32 lines · Zorro Lang

To clarify the supported filesystems by fstests, add a fs list to README file.

---

Hi,

David Sterba suggests to have a supported fs list in fstests:

https://lore.kernel.org/fstests/20250227073535.7gt7mj5gunp67axr@dell-per750-06-vm-08.rhts.eng.pek2.redhat.com/T/#m742e4f1f6668d39c1a48450e7176a366e0a2f6f9

I think that's a good suggestion, so I send this patch now. But tell the truth, it's hard to find all filesystems which are supported by fstests. Especially some filesystems might use fstests, but never be metioned in fstests code. So please review this patch or send another patch to tell fstests@ list, if you know any other filesystem is suppported.

And if anyone has review point about the support "level" and "comment" part, please feel free to tell me :)

Thanks,
Zorro

 README | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)
README +0 -0
index 024d39531..055935917 100644

README line 10

Quoted 10 lines
README +10 -0
@@ -1,3 +1,85 @@
+_______________________
+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.
+With xfs was ported to Linux, so was xfstests, now it only supports Linux.

When

README line 12

Quoted 2 lines
README +2 -0
+
+As xfstests has some test cases are good to run on some other filesystems,

many test cases that can be run

Quoted 24 lines
README +24 -0
+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.
+
++------------+-------+---------------------------------------------------------+
+| Filesystem | Level |                       Comment                           |
++------------+-------+---------------------------------------------------------+
+| AFS        |  L1   | N/A                                                     |

README line 46

Quoted 10 lines
README +10 -0
++------------+-------+---------------------------------------------------------+
+| Bcachefs   |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Btrfs      |  L4   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Ceph       |  L2   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| CIFS       |  L2-  | https://wiki.samba.org/index.php/Xfstesting-cifs        |
++------------+-------+---------------------------------------------------------+
+| Ext2/3/4   |  L3+  | N/A                                                     |

What do the plus and minus mean?

Quoted 25 lines
README +25 -0
++------------+-------+---------------------------------------------------------+
+| Exfat      |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| f2fs       |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| FUSE       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| GFS2       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Glusterfs  |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| JFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| NFS        |  L2+  | https://linux-nfs.org/wiki/index.php/Xfstests           |
++------------+-------+---------------------------------------------------------+
+| ocfs2      |  L2-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| overlay    |  L3   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| pvfs2      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Reiser4    |  L1   | Reiserfs has been removed, only left reiser4            |
++------------+-------+---------------------------------------------------------+
+| tmpfs      |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+

README line 81

Quoted 10 lines
README +10 -0
+| ubifs      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| udf        |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Virtiofs   |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| XFS        |  L4+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| 9p         |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+

This roughly tracks with my observations over the years.

--D

Quoted 8 lines
README +1 -0
+
 _______________________
 BUILDING THE FSQA SUITE
 _______________________
Signature · 1 line
2.47.1
#2 lore raw
Quoted 46 lines · Darrick J. Wong
Quoted 32 lines · Zorro Lang

To clarify the supported filesystems by fstests, add a fs list to README file.

---

Hi,

David Sterba suggests to have a supported fs list in fstests:

https://lore.kernel.org/fstests/20250227073535.7gt7mj5gunp67axr@dell-per750-06-vm-08.rhts.eng.pek2.redhat.com/T/#m742e4f1f6668d39c1a48450e7176a366e0a2f6f9

I think that's a good suggestion, so I send this patch now. But tell the truth, it's hard to find all filesystems which are supported by fstests. Especially some filesystems might use fstests, but never be metioned in fstests code. So please review this patch or send another patch to tell fstests@ list, if you know any other filesystem is suppported.

And if anyone has review point about the support "level" and "comment" part, please feel free to tell me :)

Thanks,
Zorro

 README | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)
README +0 -0
index 024d39531..055935917 100644

README line 10

Quoted 10 lines
README +10 -0
@@ -1,3 +1,85 @@
+_______________________
+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.
+With xfs was ported to Linux, so was xfstests, now it only supports Linux.

When

Quoted 4 lines

README line 12

Quoted 2 lines
README +2 -0
+
+As xfstests has some test cases are good to run on some other filesystems,

many test cases that can be run

Sure, will change these.

Quoted 29 lines
Quoted 29 lines
README +28 -0
+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.
+
++------------+-------+---------------------------------------------------------+
+| Filesystem | Level |                       Comment                           |
++------------+-------+---------------------------------------------------------+
+| AFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Bcachefs   |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Btrfs      |  L4   | N/A                                                     |
Quoted 8 lines

README line 46

Quoted 6 lines
README +6 -0
++------------+-------+---------------------------------------------------------+
+| Ceph       |  L2   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| CIFS       |  L2-  | https://wiki.samba.org/index.php/Xfstesting-cifs        |
++------------+-------+---------------------------------------------------------+
+| Ext2/3/4   |  L3+  | N/A                                                     |

What do the plus and minus mean?

Oh, I didn't explain them.

("+" 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.)

Is that good to you?

Quoted 37 lines
Quoted 26 lines
README +25 -0
++------------+-------+---------------------------------------------------------+
+| Exfat      |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| f2fs       |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| FUSE       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| GFS2       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Glusterfs  |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| JFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| NFS        |  L2+  | https://linux-nfs.org/wiki/index.php/Xfstests           |
++------------+-------+---------------------------------------------------------+
+| ocfs2      |  L2-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| overlay    |  L3   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| pvfs2      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Reiser4    |  L1   | Reiserfs has been removed, only left reiser4            |
++------------+-------+---------------------------------------------------------+
+| tmpfs      |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+

README line 81

Quoted 10 lines
README +10 -0
+| ubifs      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| udf        |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Virtiofs   |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| XFS        |  L4+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| 9p         |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
Quoted 1 line

This roughly tracks with my observations over the years.

Some filesystems I never tried, likes "9p" and "ubifs" etc, I just found these names from common/rc.

If any fs list has any supplement to the fs name or the "comment", or would like to modify the "level", please feel free to tell me.

Thanks,
Zorro

Quoted 12 lines

--D

Quoted 8 lines
README +1 -0
+
 _______________________
 BUILDING THE FSQA SUITE
 _______________________
Signature · 1 line
2.47.1
#3 lore raw
Quoted 92 lines · Zorro Lang
Quoted 46 lines · Darrick J. Wong
Quoted 32 lines · Zorro Lang

To clarify the supported filesystems by fstests, add a fs list to README file.

---

Hi,

David Sterba suggests to have a supported fs list in fstests:

https://lore.kernel.org/fstests/20250227073535.7gt7mj5gunp67axr@dell-per750-06-vm-08.rhts.eng.pek2.redhat.com/T/#m742e4f1f6668d39c1a48450e7176a366e0a2f6f9

I think that's a good suggestion, so I send this patch now. But tell the truth, it's hard to find all filesystems which are supported by fstests. Especially some filesystems might use fstests, but never be metioned in fstests code. So please review this patch or send another patch to tell fstests@ list, if you know any other filesystem is suppported.

And if anyone has review point about the support "level" and "comment" part, please feel free to tell me :)

Thanks,
Zorro

 README | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)
README +0 -0
index 024d39531..055935917 100644

README line 10

Quoted 10 lines
README +10 -0
@@ -1,3 +1,85 @@
+_______________________
+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.
+With xfs was ported to Linux, so was xfstests, now it only supports Linux.

When

Quoted 4 lines

README line 12

Quoted 2 lines
README +2 -0
+
+As xfstests has some test cases are good to run on some other filesystems,

many test cases that can be run

Sure, will change these.

Quoted 29 lines
Quoted 29 lines
README +28 -0
+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.
+
++------------+-------+---------------------------------------------------------+
+| Filesystem | Level |                       Comment                           |
++------------+-------+---------------------------------------------------------+
+| AFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Bcachefs   |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Btrfs      |  L4   | N/A                                                     |
Quoted 8 lines

README line 46

Quoted 6 lines
README +6 -0
++------------+-------+---------------------------------------------------------+
+| Ceph       |  L2   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| CIFS       |  L2-  | https://wiki.samba.org/index.php/Xfstesting-cifs        |
++------------+-------+---------------------------------------------------------+
+| Ext2/3/4   |  L3+  | N/A                                                     |

What do the plus and minus mean?

Quoted 6 lines

Oh, I didn't explain them.

("+" 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.)

Is that good to you?

<shrug> Insofar as those ratings are ongoing and fluid anyway, ok. :)

Quoted 37 lines
Quoted 37 lines
Quoted 36 lines
README +35 -0
++------------+-------+---------------------------------------------------------+
+| Exfat      |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| f2fs       |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| FUSE       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| GFS2       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Glusterfs  |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| JFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| NFS        |  L2+  | https://linux-nfs.org/wiki/index.php/Xfstests           |
++------------+-------+---------------------------------------------------------+
+| ocfs2      |  L2-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| overlay    |  L3   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| pvfs2      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Reiser4    |  L1   | Reiserfs has been removed, only left reiser4            |
++------------+-------+---------------------------------------------------------+
+| tmpfs      |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| ubifs      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| udf        |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Virtiofs   |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| XFS        |  L4+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| 9p         |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
Quoted 4 lines
Quoted 1 line

This roughly tracks with my observations over the years.

Some filesystems I never tried, likes "9p" and "ubifs" etc, I just found these names from common/rc.

Wasn't sandeen trying to make fstests work with fat at some point? Well, it's not hard to add more to the table.

Looks good to me,

--D

Quoted 22 lines

If any fs list has any supplement to the fs name or the "comment", or would like to modify the "level", please feel free to tell me.

Thanks,
Zorro

Quoted 12 lines

--D

Quoted 8 lines
README +1 -0
+
 _______________________
 BUILDING THE FSQA SUITE
 _______________________
Signature · 1 line
2.47.1
#4 lore raw
In reply to Zorro Lang
Quoted 10 lines · Zorro Lang

To clarify the supported filesystems by fstests, add a fs list to README file.

---

Hi,

David Sterba suggests to have a supported fs list in fstests:

Quoted 7 lines

https://lore.kernel.org/fstests/20250227073535.7gt7mj5gunp67axr@dell-per750-06-vm-08.rhts.eng.pek2.redhat.com/T/#m742e4f1f6668d39c1a48450e7176a366e0a2f6f9

I think that's a good suggestion, so I send this patch now. But tell the truth, it's hard to find all filesystems which are supported by fstests. Especially some filesystems might use fstests, but never be metioned in fstests code. So please review this patch or send another patch to tell fstests@ list, if you know any other filesystem is suppported.

The idea is to make the list best-effort, we don't know which of the L1 and L2 are tested. It would be interesting to try them to see the actual level of support. I kind of doubt that anybody has run e.g. pvfs2 recently.

Quoted 27 lines

And if anyone has review point about the support "level" and "comment" part, please feel free to tell me :)

Thanks,
Zorro

 README | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)
README +13 -0
index 024d39531..055935917 100644
@@ -1,3 +1,85 @@
+_______________________
+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.
+With xfs was ported to Linux, so was xfstests, now it only supports Linux.
+
+As xfstests has some test cases are good to run on some other filesystems,
+we call them "generic" (and "shared", but it has been removed) cases, you

README line 23

Quoted 10 lines
README +10 -0
+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.

This could list what are the assumptions of a generic filesystem. For example the mkfs.$FSTYP and fsck.$FSTYP should exist as the generic fallback applies (other filesystems have the exceptions that skip eg. fsck if it's known not to exist).

Quoted 6 lines
README +6 -0
+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.

README line 40

Quoted 10 lines
README +10 -0
+L4: Active support from the fs list, has lots of own cases.
+
++------------+-------+---------------------------------------------------------+
+| Filesystem | Level |                       Comment                           |
++------------+-------+---------------------------------------------------------+
+| AFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Bcachefs   |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Btrfs      |  L4   | N/A                                                     |

https://btrfs.readthedocs.io/en/latest/dev/Development-notes.html#fstests-setup

some additional information about required packages, kernel configs and devices. This could be in fstests/README too.

README line 46

Quoted 6 lines
README +6 -0
++------------+-------+---------------------------------------------------------+
+| Ceph       |  L2   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| CIFS       |  L2-  | https://wiki.samba.org/index.php/Xfstesting-cifs        |
++------------+-------+---------------------------------------------------------+
+| Ext2/3/4   |  L3+  | N/A                                                     |

I'd suggest to split ext4 from that and give it L4, not sure if ext2 is still being tested maybe it's worth L3. The standalone Ext3 module does not exist and is covered by ext4, so it probably works with fstests but is interesting maybe only for historical reasons.

Quoted 25 lines
README +25 -0
++------------+-------+---------------------------------------------------------+
+| Exfat      |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| f2fs       |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| FUSE       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| GFS2       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Glusterfs  |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| JFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| NFS        |  L2+  | https://linux-nfs.org/wiki/index.php/Xfstests           |
++------------+-------+---------------------------------------------------------+
+| ocfs2      |  L2-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| overlay    |  L3   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| pvfs2      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Reiser4    |  L1   | Reiserfs has been removed, only left reiser4            |
++------------+-------+---------------------------------------------------------+
+| tmpfs      |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+

README line 81

Quoted 10 lines
README +10 -0
+| ubifs      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| udf        |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Virtiofs   |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| XFS        |  L4+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| 9p         |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+

The table works as the way to present it but with so few links/comments writing it as a simple list could give a better idea what filesystems are in each category. Sorted alphabetically, like:

L4: Btrfs, Ext4, XFS
L3: ...
etc

#5 lore raw
Quoted 19 lines · David Sterba
Quoted 10 lines · Zorro Lang

To clarify the supported filesystems by fstests, add a fs list to README file.

---

Hi,

David Sterba suggests to have a supported fs list in fstests:

Quoted 7 lines

https://lore.kernel.org/fstests/20250227073535.7gt7mj5gunp67axr@dell-per750-06-vm-08.rhts.eng.pek2.redhat.com/T/#m742e4f1f6668d39c1a48450e7176a366e0a2f6f9

I think that's a good suggestion, so I send this patch now. But tell the truth, it's hard to find all filesystems which are supported by fstests. Especially some filesystems might use fstests, but never be metioned in fstests code. So please review this patch or send another patch to tell fstests@ list, if you know any other filesystem is suppported.

Quoted 3 lines

The idea is to make the list best-effort, we don't know which of the L1 and L2 are tested. It would be interesting to try them to see the actual level of support. I kind of doubt that anybody has run e.g. pvfs2 recently.

Hi David,

Thanks for your reviewing :)

I never tried pvfs2 either. The "level" won't be changeless. That depends on how many test cases are there for the specific fs. L1 means I never saw more patches after one patch named "add support to $FSTYP" to change common/rc a bit. L2 means I saw a few more fixes after that signle patch. Anyway, if someone is still testing on someone FSTYP, please feel free to share your experience and change the level.

Quoted 36 lines
Quoted 36 lines

And if anyone has review point about the support "level" and "comment" part, please feel free to tell me :)

Thanks,
Zorro

 README | 82 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 82 insertions(+)
README +20 -0
index 024d39531..055935917 100644
@@ -1,3 +1,85 @@
+_______________________
+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.
+With xfs was ported to Linux, so was xfstests, now it only supports Linux.
+
+As xfstests has some test cases are good to 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
+------------
Quoted 8 lines

README line 23

Quoted 3 lines
README +3 -0
+
+Firstly, there's not hard restriction about which filesystem can use fstests.
+Any filesystem can give fstests a try.

This could list what are the assumptions of a generic filesystem. For example the mkfs.$FSTYP and fsck.$FSTYP should exist as the generic fallback applies (other filesystems have the exceptions that skip eg. fsck if it's known not to exist).

Is there a place to know all mkfs.$FSTYP? The "man 8 mkfs" doesn't give much information.

I'd not like to list the fs which isn't metioned in xfstests and never tried by others. But I'm very glad to add more later :)

I can change above sentence as below:

"Any filesystem can give fstests a try, especially the fs is supported by mkfs -t $FSTYP, mount -t $FSTYP and fsck -t $FSTYP."

Quoted 20 lines
Quoted 7 lines
README +6 -0
+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.

README line 40

Quoted 10 lines
README +10 -0
+L4: Active support from the fs list, has lots of own cases.
+
++------------+-------+---------------------------------------------------------+
+| Filesystem | Level |                       Comment                           |
++------------+-------+---------------------------------------------------------+
+| AFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Bcachefs   |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Btrfs      |  L4   | N/A                                                     |

https://btrfs.readthedocs.io/en/latest/dev/Development-notes.html#fstests-setup

Quoted 2 lines

some additional information about required packages, kernel configs and devices. This could be in fstests/README too.

Sure, I'll add it.

Quoted 8 lines

README line 46

Quoted 7 lines
README +6 -0
++------------+-------+---------------------------------------------------------+
+| Ceph       |  L2   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| CIFS       |  L2-  | https://wiki.samba.org/index.php/Xfstesting-cifs        |
++------------+-------+---------------------------------------------------------+
+| Ext2/3/4   |  L3+  | N/A                                                     |
Quoted 4 lines

I'd suggest to split ext4 from that and give it L4, not sure if ext2 is still being tested maybe it's worth L3. The standalone Ext3 module does not exist and is covered by ext4, so it probably works with fstests but is interesting maybe only for historical reasons.

Actually I hesitated about the level of ext4. I gave L4 to btrfs due to it has 330+ specific test cases in tests/btrfs, besides generic tests. But ExtN has 70 (besides generic), so I set L3+. Anyway, L4 or L3+ are both good to me. If you recommend L4, I can change that.

Quoted 37 lines
Quoted 26 lines
README +25 -0
++------------+-------+---------------------------------------------------------+
+| Exfat      |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| f2fs       |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| FUSE       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| GFS2       |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Glusterfs  |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| JFS        |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| NFS        |  L2+  | https://linux-nfs.org/wiki/index.php/Xfstests           |
++------------+-------+---------------------------------------------------------+
+| ocfs2      |  L2-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| overlay    |  L3   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| pvfs2      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Reiser4    |  L1   | Reiserfs has been removed, only left reiser4            |
++------------+-------+---------------------------------------------------------+
+| tmpfs      |  L3-  | N/A                                                     |
++------------+-------+---------------------------------------------------------+

README line 81

Quoted 10 lines
README +10 -0
+| ubifs      |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| udf        |  L1+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| Virtiofs   |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| XFS        |  L4+  | N/A                                                     |
++------------+-------+---------------------------------------------------------+
+| 9p         |  L1   | N/A                                                     |
++------------+-------+---------------------------------------------------------+
Quoted 7 lines

The table works as the way to present it but with so few links/comments writing it as a simple list could give a better idea what filesystems are in each category. Sorted alphabetically, like:

L4: Btrfs, Ext4, XFS
L3: ...
etc

I wrote many "N/A" due to I don't know what does the specific fs list want to comment. Likes you provide a link for btrfs, I don't know if other fs would like to change their part. So I tried to leave the "whiteboard" to them, hope each fs list can share how do they use fstests, that might be helpful for other users would like to join.

If you think the "level" is more useful, I can list them in "level" order. Currently I list them in name's alphabetical order.

Thanks,
Zorro

Quoted 1 line