diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/ChangeLog | 1 | ||||
| -rw-r--r-- | docs/python_mutators.txt | 20 | ||||
| -rw-r--r-- | docs/technical_details.txt | 2 |
3 files changed, 14 insertions, 9 deletions
diff --git a/docs/ChangeLog b/docs/ChangeLog index f42d380f..52821d67 100644 --- a/docs/ChangeLog +++ b/docs/ChangeLog @@ -24,6 +24,7 @@ Version ++2.58d (dev): - added Radamsa and an optional radamsa stage (-R) - CPU affinity support for DragonFly - added -u command line option to not unlink the fuzz input file + - Python3 support - llvm_mode: - float splitting is now configured via AFL_LLVM_LAF_SPLIT_FLOATS - support for llvm 10 included now (thanks to devnexen) diff --git a/docs/python_mutators.txt b/docs/python_mutators.txt index 0d4eef1e..e20a6f58 100644 --- a/docs/python_mutators.txt +++ b/docs/python_mutators.txt @@ -9,8 +9,9 @@ Adding custom mutators to AFL using Python modules Implemented by Christian Holler (:decoder) <choller@mozilla.com>. - NOTE: This is for Python 2.7 ! - Anyone who wants to add Python 3.7 support is happily welcome :) + NOTE: Python 3.7 and 2.7 are supported so far (3.8 upcomming). + Depending on with which version afl-fuzz was compiled, you must use + python2 or python3 syntax in your scripts! For an example and a template see ../python_mutators/ @@ -56,16 +57,19 @@ further information about this feature. 3) How to compile AFLFuzz with Python support --------------------------------------------- -You must install the python 2.7 development package of your Linux distribution -before this will work. On Debian/Ubuntu/Kali this can be done with: +You must install the python 3.7 or 2.7 development package of your Linux +distribution before this will work. On Debian/Ubuntu/Kali this can be done +with either: + apt install python3.7-dev +pr apt install python2.7-dev A prerequisite for using this mode is to compile AFLFuzz with Python support. -The afl Makefile performs some magic and detects Python 2.7 if it is in the -default path and compiles afl-fuzz with the feature if available (which is -/usr/include/python2.7 for the Python.h include and /usr/lib/x86_64-linux-gnu -for the libpython2.7.a library) +The afl Makefile performs some magic and detects Python 3.7 and 2.7 if it is +in the default path and compiles afl-fuzz with the feature if available (which +is /usr/include/python2.7 for the Python.h include and +/usr/lib/x86_64-linux-gnu for the libpython2.7.a library) In case your setup is different set the necessary variables like this: PYTHON_INCLUDE=/path/to/python2.7/include LDFLAGS=-L/path/to/python2.7/lib make diff --git a/docs/technical_details.txt b/docs/technical_details.txt index af6131c1..1604c4d0 100644 --- a/docs/technical_details.txt +++ b/docs/technical_details.txt @@ -165,7 +165,7 @@ of new tuples, and the remainder is associated with changes in hit counts. The following table compares the relative ability to discover file syntax and explore program states when using several different approaches to guided -fuzzing. The instrumented target was GNU patch 2.7.3 compiled with -O3 and +fuzzing. The instrumented target was GNU patch 2.7k.3 compiled with -O3 and seeded with a dummy text file; the session consisted of a single pass over the input queue with afl-fuzz: |