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/libtokencap/README.md') 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 From d2700c7525254e9400227afe2010d366bea2aabf Mon Sep 17 00:00:00 2001 From: Alexander Shvedov <60114847+a-shvedov@users.noreply.github.com> Date: Sat, 1 Jun 2024 13:03:22 +0300 Subject: Update README.md --- utils/libtokencap/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'utils/libtokencap/README.md') diff --git a/utils/libtokencap/README.md b/utils/libtokencap/README.md index 0e8b7ce1..d1c1b8b3 100644 --- a/utils/libtokencap/README.md +++ b/utils/libtokencap/README.md @@ -69,13 +69,13 @@ 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 +Also, the following example (generate_libtoken_dict.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 +./generate_libtoken_dict.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 ; -- cgit 1.4.1 From bc2ccf464ff966adb2cbb17c0ff9957cf35ab513 Mon Sep 17 00:00:00 2001 From: Alexander Shvedov <60114847+a-shvedov@users.noreply.github.com> Date: Mon, 3 Jun 2024 19:14:04 +0300 Subject: Update README.md --- utils/libtokencap/README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'utils/libtokencap/README.md') diff --git a/utils/libtokencap/README.md b/utils/libtokencap/README.md index d1c1b8b3..29225835 100644 --- a/utils/libtokencap/README.md +++ b/utils/libtokencap/README.md @@ -75,15 +75,15 @@ and then generate a dictionary file from those tokens. #### usage: ```bash -./generate_libtoken_dict.sh -p /path/to/libtokencap.so -b /path/to/target/program -o /path/to/target/output -t 5 +./generate_libtoken_dict.sh -p /path/to/libtokencap.so -b /path/to/target/program -o /path/to/target/output -t 5 -- [-program_args] ``` #### description opts: - ```-o``` : Path to target output directory ; - ```-b``` : Path to target program binary ; - ```-p``` : Path to LD_PRELOAD library ; -- ```-t``` : Timeout in seconds +- ```-t``` : Timeout in seconds ; +- ```-- [-program_args]```: Any additional arguments required by the target binary can be specified after ```--```. #### 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. +A sorted and unique token dictionary file with the extension ``*.dict`` +is created in the same directory as the target output containing tokens captured during the execution of the target binary. -- cgit 1.4.1