diff options
Diffstat (limited to 'docs/custom_mutator.txt')
| -rw-r--r-- | docs/custom_mutator.txt | 11 |
1 files changed, 8 insertions, 3 deletions
diff --git a/docs/custom_mutator.txt b/docs/custom_mutator.txt index 3b1b93b9..30e6b897 100644 --- a/docs/custom_mutator.txt +++ b/docs/custom_mutator.txt @@ -18,8 +18,13 @@ environment variable. The library must export the afl_custom_mutator() function must be compiled as a shared object. For example: $CC -shared -Wall -O3 <lib-name>.c -o <lib-name>.so -AFL will call the afl_custom_mutator() function every time it needs to mutate -a test case. For some cases, the format of the mutated data returned from +Note: unless AFL_CUSTOM_MUTATOR_ONLY is set, its state mutator like any others, +so it will be used for some test cases, and other mutators for others. + +Only if AFL_CUSTOM_MUTATOR_ONLY is set the afl_custom_mutator() function will +be called every time it needs to mutate test case! + +For some cases, the format of the mutated data returned from the custom mutator is not suitable to directly execute the target with this input. For example, when using libprotobuf-mutator, the data returned is in a protobuf format which corresponds to a given grammar. In order to execute the target, @@ -31,4 +36,4 @@ is not needed. 2) Example ---------- -A simple example is provided in ../custom_mutators/ \ No newline at end of file +A simple example is provided in ../custom_mutators/ |