From 4cf358b58920ea843a9e7e38309fe7df37fcb81f Mon Sep 17 00:00:00 2001 From: Alexander Shvedov <60114847+a-shvedov@users.noreply.github.com> Date: Sat, 1 Jun 2024 02:06:20 +0300 Subject: Update README.md --- utils/libtokencap/README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) (limited to 'utils') 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. -- cgit 1.4.1