blktests is a test framework for the Linux kernel block layer and storage stack. It is inspired by the xfstests filesystem testing framework.
The dependencies are minimal, but make sure you have them installed:
- bash 4
- GNU coreutils
- GNU awk
- util-linux
- fio
- gcc
- make
Some tests require the following:
- e2fsprogs and xfsprogs
- multipath-tools (Debian, openSUSE) or device-mapper-multipath (Fedora)
- dmsetup (Debian) or device-mapper (Fedora, openSUSE, Arch Linux)
Add the list of block devices you want to test on in a file named config:
TEST_DEVS=(/dev/nvme0n1 /dev/sdb)And as root, run the default set of tests with ./check.
Note that these tests are destructive, so don't add anything to the TEST_DEVS
array containing data that you want to keep.
See here for more detailed information on configuration and running tests.
The ./new script creates a new test from a template. The generated template
contains more detailed documentation.
Pull requests on GitHub and patches to linux-block@vger.kernel.org are both accepted. See here for more information on contributing.