about summary refs log tree commit diff
path: root/docs/custom_mutator.txt
diff options
context:
space:
mode:
authorvan Hauser <vh@thc.org>2019-09-16 16:17:16 +0200
committervan Hauser <vh@thc.org>2019-09-16 16:17:16 +0200
commit428b88a82a6dd01db8a50e618fe2021bc8215229 (patch)
tree6b2086be2281bde4a0e1abb51b7d0cfebd6436f0 /docs/custom_mutator.txt
parent46ac5590037af101cd17fcdc9b488cfc483523b0 (diff)
downloadafl++-428b88a82a6dd01db8a50e618fe2021bc8215229.tar.gz
added afl_custom_mutator_only
Diffstat (limited to 'docs/custom_mutator.txt')
-rw-r--r--docs/custom_mutator.txt11
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/