about summary refs log tree commit diff
diff options
context:
space:
mode:
authorAlexander Shvedov <60114847+a-shvedov@users.noreply.github.com>2024-06-01 02:06:20 +0300
committerGitHub <noreply@github.com>2024-06-01 02:06:20 +0300
commit4cf358b58920ea843a9e7e38309fe7df37fcb81f (patch)
tree1fb52e3d1bdfe98ece8651425cd8cf6c9f4e4b54
parent5e708b23c60e0d95f1d12897e5a47a08b1ade1c0 (diff)
downloadafl++-4cf358b58920ea843a9e7e38309fe7df37fcb81f.tar.gz
Update README.md
-rw-r--r--utils/libtokencap/README.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/utils/libtokencap/README.md b/utils/libtokencap/README.md
index 8705452c..0e8b7ce1 100644
--- a/utils/libtokencap/README.md
+++ b/utils/libtokencap/README.md
@@ -69,3 +69,21 @@ need to be changed for other OSes.
 
 Current supported OSes are: Linux, Darwin, FreeBSD (thanks to @devnexen)
 
+Also, the following example (make_dict_v2.sh) shows how to use a script to capture tokens from the 
+files in the target output directory, 
+and then generate a dictionary file from those tokens.
+
+#### usage:
+```bash
+./make_dict_v2.sh -p /path/to/libtokencap.so -b /path/to/target/program -o /path/to/target/output -t 5
+```
+#### description opts:
+- ```-o``` : Path to target output directory ;
+- ```-b``` : Path to target program binary ;
+- ```-p``` : Path to LD_PRELOAD library ;
+- ```-t``` : Timeout in seconds
+ 
+#### output:
+The script generates a temporary token file (```temp_output.txt```) in the current working directory, 
+containing tokens captured during the execution of the target binary.
+A sorted and unique token dictionary file is created in the same directory as the target output, with a ```*.dict``` extension.