path: root/tests/
diff options
authorDavid Sterba <>2017-08-29 17:07:15 +0200
committerDavid Sterba <>2017-09-08 16:15:05 +0200
commitc4dd5fef8a97543630fe945e5d5a365e40cb17f0 (patch)
treefce8b167c6cf19b1f2b470a8cff37adadcef949d /tests/
parent7da5841e3fb90909d55ac6d4ecf0db80cca1da6a (diff)
btrfs-progs: tests: update README
Wording, runtime dependencies. Signed-off-by: David Sterba <>
Diffstat (limited to 'tests/')
1 files changed, 11 insertions, 4 deletions
diff --git a/tests/ b/tests/
index a8d3a2ba..04d2ce2a 100644
--- a/tests/
+++ b/tests/
@@ -30,7 +30,7 @@ category, eg. `fsck-tests-results.txt`.
## Selective testing
-The test are prefixed by a number for ordering and uniqueness. To run a
+The tests are prefixed by a number for ordering and uniqueness. To run a
particular test use:
@@ -76,8 +76,7 @@ will run the first test in fsck-tests subdirectory.
* anything that does not fit to the above, the test driver script will only
execute `./` in the test directory
+*tests/common, tests/common.convert:*
* script with shell helpers, separated by functionality
@@ -146,6 +145,13 @@ the loop devices as they are managed on a per-test basis.
There's a script `` that will run shell commands in a loop and
logs the output with the testing environment set up.
+### Runtime dependencies
+The tests use some common system utilities like `find`, `rm`, `dd`. Additionally,
+specific tests need the following packages installed: `acl`, `attr`,
+`e2fsprogs`, `reiserfsprogs`
## New test
1. Pick the category for the new test or fallback to `misc-tests` if not sure. For
@@ -162,7 +168,7 @@ begining of ``. You don't need to add the file to git yet.
4. Write the test commands, comment anything that's not obvious.
-5. Test your test. Use the `TEST` variable to jump right to your test:
+5. **Test your test.** Use the `TEST` variable to jump right to your test:
$ make TEST=012\* tests-misc # from top directory
$ TEST=012\* ./ # from tests/
@@ -172,6 +178,7 @@ $ TEST=012\* ./ # from tests/
fixed the bug (or both). Subject line of the shall mention the name of the
new directory for ease of search, eg. `btrfs-progs: tests: add 012-subvolume-sync-must-wait`
### Crafted/fuzzed images
Images that are create by fuzzing or specially crafted to trigger some error