about summary refs log tree commit diff
path: root/README.md
diff options
context:
space:
mode:
authorllzmb <46303940+llzmb@users.noreply.github.com>2021-10-10 16:32:43 +0200
committerGitHub <noreply@github.com>2021-10-10 16:32:43 +0200
commit79d87f8544a0f67537b2169e3f6821f459659f61 (patch)
tree15bfaef53f95696583ea12396a7e8e98b73f77e1 /README.md
parent228f6c5dad1a593b4113006e587e9885459a53c2 (diff)
parentda865cbb9d289d0f782a1c33d85261903c60d624 (diff)
downloadafl++-79d87f8544a0f67537b2169e3f6821f459659f61.tar.gz
Merge branch 'dev' into docs_edit_readme_fix_links
Diffstat (limited to 'README.md')
-rw-r--r--README.md19
1 files changed, 15 insertions, 4 deletions
diff --git a/README.md b/README.md
index 25e47ef2..9fe1da7e 100644
--- a/README.md
+++ b/README.md
@@ -70,13 +70,24 @@ When fuzzing verbose syntax (SQL, HTTP, etc), create a dictionary as described i
 
 3. If the program reads from stdin, run `afl-fuzz` like so:
 
-        ./afl-fuzz -i testcase_dir -o findings_dir -- \
-          /path/to/tested/program [...program's cmdline...]
+```
+   ./afl-fuzz -i seeds_dir -o output_dir -- \
+     /path/to/tested/program [...program's cmdline...]
+```
+
+   To add a dictionary, add `-x /path/to/dictionary.txt` to afl-fuzz.
 
-   If the program takes input from a file, you can put `@@` in the program's command line; AFL will put an auto-generated file name in there for you.
+   If the program takes input from a file, you can put `@@` in the program's
+   command line; AFL will put an auto-generated file name in there for you.
 
 4. Investigate anything shown in red in the fuzzer UI by promptly consulting [docs/status_screen.md](docs/status_screen.md).
 
+5. You will find found crashes and hangs in the subdirectories `crashes/` and
+   `hangs/` in the `-o output_dir` directory. You can replay the crashes by
+   feeding them to the target, e.g.:
+   `cat output_dir/crashes/id:000000,* | /path/to/tested/program [...program's cmdline...]`
+   You can generate cores or use gdb directly to follow up the crashes.
+
 ## Contact
 
 Questions? Concerns? Bug reports?
@@ -179,4 +190,4 @@ If you use AFL++ in scientific work, consider citing [our paper](https://www.use
   }
   ```
 
-</details>
\ No newline at end of file
+</details>