function tracer: analyze a binary file with dynamic instrumentation

functrace – A function tracer

functrace is a tool that helps to analyze a binary file with dynamic instrumentation using DynamoRIO (http://dynamorio.org/).

These are some implemented features (based on DynamoRIO):

•  disassemble all the executed code
•  disassemble a specific function (dump if these are addresses)
•  get arguments of a specific function (dump if these are addresses)
•  get return value of a specific function (dump if this is an address)
•  monitors application signals
•  generate a report file
•  ghidra(https://ghidra-sre.org/) coverage script (based on the functrace report file)

Install

$ wget https://github.com/DynamoRIO/dynamorio/releases/download/release_7_0_0_rc1/DynamoRIO-Linux-7.0.0-RC1.tar.gz
$ tar xvzf DynamoRIO-Linux-7.0.0-RC1.tar.gz
$ git clone https://github.com/invictus1306/functrace
$ mkdir -p functrace/build
$ cd functrace/build
$ cmake .. -DDynamoRIO_DIR=/full_DR_path/DynamoRIO-Linux-7.0.0-RC1/cmake/
$ make -j4

Use

The following functrace options are supported:

-disassembly -> disassemble all the functions
-disas_func function_name -> disassemble only the function function_name
-wrap_function function_name -> wrap the function function_name
-wrap_function_args num_args -> number of arguments of the wrapped function
-cbr -> remove the bb from the cache (in case of conditional jump)
-report_file file_name -> report file name (required)
-verbose -> verbose

Example

Option -verbose

Option -disassemby

Option -disas_func

Option -wrap_function and -wrap_function_args

Option -cbr