]> www.infradead.org Git - users/hch/fsqual.git/commitdiff
Add README
authorAvi Kivity <avi@scylladb.com>
Tue, 9 Feb 2016 15:40:10 +0000 (17:40 +0200)
committerAvi Kivity <avi@scylladb.com>
Tue, 9 Feb 2016 15:40:10 +0000 (17:40 +0200)
README.md [new file with mode: 0644]

diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..399113f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# fsqual - file system qualification tool for asynchonus I/O
+
+## About
+
+Linux AIO is notoriously bad; but it is hard to understand what the weaknesses of a filesystem implementation in a particular kernel version are. The `fsqual` tool provides a way to qualify a filesystem's aio implementation.
+
+See this [blog post](http://www.scylladb.com/2016/02/09/qualifying-filesystems/) for more information.
+
+Currently tested attributes are:
+ * Asycnhronous appending write
+
+## Building
+
+Install the following packages:
+ * `libaio-devel` (`libaio-dev1 on Debian and derivatives)
+ * `gcc-c++` (`g++` on Debian and derivatives)
+ * `make`
+
+## Running
+
+Change to a directory under the mountpoint to be tested, and run `fsqual`.
+