Repository files navigation

blktests is a test framework for the Linux kernel block layer and storagestack. It is inspired by thexfstestsfilesystem 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 namedconfig:

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 theTEST_DEVSarray containing data that you want to keep.

Seehere for more detailed information onconfiguration and running tests.

The./new script creates a new test from a template. The generated templatecontains more detailed documentation.

Pull requests on GitHub and patches tolinux-block@vger.kernel.org are bothaccepted. Seehere for more information on contributing.