]> www.infradead.org Git - users/hch/fsqual.git/commitdiff
Update README for new tests
authorAvi Kivity <avi@scylladb.com>
Tue, 5 Jan 2021 11:59:10 +0000 (13:59 +0200)
committerAvi Kivity <avi@scylladb.com>
Tue, 5 Jan 2021 11:59:10 +0000 (13:59 +0200)
README.md

index af0dc1c47964d0a2f2c7e9ac1afd704058dff39e..e5bd991674c9052a2d2313bd2be003507370575e 100644 (file)
--- a/README.md
+++ b/README.md
@@ -6,9 +6,12 @@ Linux AIO is notoriously bad; but it is hard to understand what the weaknesses o
 
 See this [blog post](http://www.scylladb.com/2016/02/09/qualifying-filesystems/) for more information.
 
-Currently tested attributes are:
- * Asycnhronous appending write
- * Asycnhronous allocating, but non-appending write
+The test matrix checks the following variations:
+ * Whether the write changes the size of the file or not
+ * Whether the write first touches its offset range, or alternatively overwrites already-written data
+ * Whether the write uses sector granularity (typically 512 bytes) or block granularity (typically 4096 bytes)
+ * Whether the writes happen concurrently, or only one at a time
+ * Whether O_DSYNC is in use (as is typical for commitlogs) or not
 
 ## Building
 
@@ -26,3 +29,4 @@ To build, simply run
 
 Change to a directory under the mountpoint to be tested, and run `fsqual`.
 
+`fsqual` will report, for each test scenario, whether `io_submit` was truly asynchronous. This is done by measuring context switches during the `io_submit` call.