about summary refs log tree commit diff
path: root/testcases/README.testcases
diff options
context:
space:
mode:
Diffstat (limited to 'testcases/README.testcases')
-rw-r--r--testcases/README.testcases19
1 files changed, 19 insertions, 0 deletions
diff --git a/testcases/README.testcases b/testcases/README.testcases
new file mode 100644
index 00000000..30110ba1
--- /dev/null
+++ b/testcases/README.testcases
@@ -0,0 +1,19 @@
+=======================
+AFL starting test cases
+=======================
+
+  (See ../docs/README for the general instruction manual.)
+
+The archives/, images/, multimedia/, and others/ subdirectories contain small,
+standalone files that can be used to seed afl-fuzz when testing parsers for a
+variety of common data formats.
+
+There is probably not much to be said about these files, except that they were
+optimized for size and stripped of any non-essential fluff. Some directories
+contain several examples that exercise various features of the underlying format.
+For example, there is a PNG file with and without a color profile.
+
+Additional test cases are always welcome.
+
+In addition to well-chosen starting files, many fuzzing jobs benefit from a
+small and concise dictionary. See ../dictionaries/README.dictionaries for more.