Skip to content

Commit

Permalink
More clearly document that only a single fuzz test is fuzzed per run
Browse files Browse the repository at this point in the history
Work towards #599
  • Loading branch information
fmeum committed Oct 17, 2023
1 parent e3412fd commit 7e2b64e
Show file tree
Hide file tree
Showing 2 changed files with 3 additions and 2 deletions.
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,7 @@ The following steps assume that JUnit 5.9.0 or higher is set up for your project
3. Assuming your test class is called `com.example.MyFuzzTests`, create the *inputs directory* `src/test/resources/com/example/MyFuzzTestsInputs`.
4. Run a fuzz test with the environment variable `JAZZER_FUZZ` set to `1` to let the fuzzer rapidly try new sets of arguments.
If the fuzzer finds arguments that make your fuzz test fail or even trigger a security issue, it will store them in the inputs directory.
In this mode, only a single fuzz test is executed per test run (see [#599](https://github.com/CodeIntelligenceTesting/jazzer/issues/599) for details).
5. Run the fuzz test without `JAZZER_FUZZ` set to execute it only on the inputs in the inputs directory.
This mode, which behaves just like a traditional unit test, ensures that issues previously found by the fuzzer remain fixed and can also be used to debug the fuzz test on individual inputs.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -74,8 +74,8 @@
* <p>When no issue has been found after the configured {@link FuzzTest#maxDuration()}, the test
* passes.
*
* <p>Only a single fuzz test per test run will be executed in fuzzing mode. All other fuzz tests
* will be skipped.
* <p><b>In fuzzing mode, only a single fuzz test per test run will be executed.</b> All other fuzz
* tests will be skipped.
*
* <h3>Regression testing</h3>
*
Expand Down

0 comments on commit 7e2b64e

Please sign in to comment.