diff options
| author | hexcoder- <heiko@hexco.de> | 2019-09-25 06:04:45 +0200 |
|---|---|---|
| committer | hexcoder- <heiko@hexco.de> | 2019-09-25 06:04:45 +0200 |
| commit | a5acd32f56e4626b3f2fc1dd1216cbce73842bb6 (patch) | |
| tree | e0f118eb7e5d52e1512e5ffbeec5bb8491a7a0ae /dictionaries | |
| parent | a7e45319c3e99bdd24505ffd960bf9c8a0d607d7 (diff) | |
| download | afl++-a5acd32f56e4626b3f2fc1dd1216cbce73842bb6.tar.gz | |
fix links in docs, change dictionaries/README to markdown
Diffstat (limited to 'dictionaries')
| -rw-r--r-- | dictionaries/README.dictionaries | 43 |
1 files changed, 0 insertions, 43 deletions
diff --git a/dictionaries/README.dictionaries b/dictionaries/README.dictionaries deleted file mode 100644 index ea319733..00000000 --- a/dictionaries/README.dictionaries +++ /dev/null @@ -1,43 +0,0 @@ -================ -AFL dictionaries -================ - - (See ../docs/README for the general instruction manual.) - -This subdirectory contains a set of dictionaries that can be used in -conjunction with the -x option to allow the fuzzer to effortlessly explore the -grammar of some of the more verbose data formats or languages. The basic -principle behind the operation of fuzzer dictionaries is outlined in section 9 -of the "main" README for the project. - -Custom dictionaries can be added at will. They should consist of a -reasonably-sized set of rudimentary syntax units that the fuzzer will then try -to clobber together in various ways. Snippets between 2 and 16 bytes are usually -the sweet spot. - -Custom dictionaries can be created in two ways: - - - By creating a new directory and placing each token in a separate file, in - which case, there is no need to escape or otherwise format the data. - - - By creating a flat text file where tokens are listed one per line in the - format of name="value". The alphanumeric name is ignored and can be omitted, - although it is a convenient way to document the meaning of a particular - token. The value must appear in quotes, with hex escaping (\xNN) applied to - all non-printable, high-bit, or otherwise problematic characters (\\ and \" - shorthands are recognized, too). - -The fuzzer auto-selects the appropriate mode depending on whether the -x -parameter is a file or a directory. - -In the file mode, every name field can be optionally followed by @<num>, e.g.: - - keyword_foo@1 = "foo" - -Such entries will be loaded only if the requested dictionary level is equal or -higher than this number. The default level is zero; a higher value can be set -by appending @<num> to the dictionary file name, like so: - - -x path/to/dictionary.dct@2 - -Good examples of dictionaries can be found in xml.dict and png.dict. |
