https://github.com/invictus1306/functrace
A function tracer
https://github.com/invictus1306/functrace
Last synced: about 1 year ago
JSON representation
A function tracer
- Host: GitHub
- URL: https://github.com/invictus1306/functrace
- Owner: invictus1306
- License: mit
- Created: 2018-12-28T17:01:49.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-06-04T19:31:45.000Z (almost 7 years ago)
- Last Synced: 2025-03-26T21:12:20.949Z (about 1 year ago)
- Language: C++
- Size: 7.94 MB
- Stars: 91
- Watchers: 7
- Forks: 22
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-csirt - functrace
README
# functrace - A function tracer
*functrace* is a tool that helps to analyze a binary file with dynamic instrumentation using *DynamoRIO* ().
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*() coverage script (based on the functrace report file)
## Setup
```shell
$ 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
```
OR
```shell
$ wget https://github.com/DynamoRIO/dynamorio/releases/download/cronbuild-7.91.18047/DynamoRIO-x86_64-Linux-7.91.18047-0.tar.gz
$ tar xvzf DynamoRIO-x86_64-Linux-7.91.18047-0.tar.gz
```
You can also clone and compile directly DynamoRIO
```shell
$ git clone https://github.com/invictus1306/functrace
$ mkdir -p functrace/build
$ cd functrace/build
$ cmake .. -DDynamoRIO_DIR=/full_DR_path/cmake/
$ make -j4
```
## Simple DEMO
## Using functrace
```shell
$ drrun -c libfunctrace.so -report_file report -- target_program [args]
```
### Options
The following *[functrace]*(https://github.com/invictus1306/functrace) options are supported:
```latex
-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
```
### Simple usage
#### Option *-verbose*
```shell
$ drrun -c libfunctrace.so -report_file report -verbose -- target_program [args]
```
#### Option *-disassemby*
```shell
$ drrun -c libfunctrace.so -report_file report -disassembly -- target_program [args]
```
#### Option *-disas_func*
```shell
$ drrun -c libfunctrace.so -report_file report -disas_func name_function -- target_program [args]
```
#### Option *-wrap_function* and *-wrap_function_args*
```shell
$ drrun -c libfunctrace.so -report_file report -wrap_function name_function -wrap_function_args num_args -- target_program [args]
```
#### Option *-cbr*
```shell
$ drrun -c libfunctrace.so -report_file report -cbr -- target_program [args]
```
### CVE-2018-4013 - Vulnerability Analysis
A vulnerability on the [LIVE555 RTSP](http://www.live555.com/) server library. This is the [description](https://www.cvedetails.com/cve/CVE-2018-4013/).
## Working enviroment
Tested on Ubuntu 16.04.5 LTS 64 bit
## Future features
* Ghidra plugin
* Visual setup interface
* Store and compare different coverage analysis
* Run DR directy from ghidra
* Add more functionality to functrace
* Support for Android