Skip to content

INSTALL.md

Latest commit

 

History

History
57 lines (39 loc) · 1.84 KB

INSTALL.md

File metadata and controls

57 lines (39 loc) · 1.84 KB

servertracer submodule

Linux

  1. Export the following variable in your .bashrc file:
export PIN_ROOT="/absolute/path/to/pin-3.25"

  1. Run make in synoptic/servertracer/ folder. It will create the server_tracer.so pintool under obj-intel64 folder (or obj-ia32 in 32-bits systems)

  2. You can now run the pintool with:

$ $PIN_ROOT/pin -follow_execv -t /absolute/path/to/synoptic/servertracer/obj-intel64/server_tracer.so [options] -- server-executable [args]

Windows

  1. Copy servertracer folder to %PIN_ROOT%\source\tools
  2. Open server_tracer.vcxproj of the copied folder with Vistual Studio
  3. Select Release x86/x64 option and build the Pintool with Build > Build Solution. This will create the Pintool DLL in the corresponding folder (x64/x86 under Release folder)
  4. Run Pintool with:
> %PIN_ROOT%\pin.exe -follow_execv -t %PIN_ROOT%\source\tools\servertracer\x64\Release\server_tracer.dll [options] -- server-executable [args]

tracemodeler submodule

You only need to install the requirements.txt file:

$ python -m pip install -r requirements.txt

Optionally, you can install dependencies in a virtual environment:

$ python -m venv virtualenv
$ source virtualenv/bin/activate
(virtualenv) $ python -m pip install -r requirements.txt

Also, there are dependencies that need to be installed on your system because Python libraries rely on these system wide binaries. So, you will need to install them with your system distribution packages:

$ sudo apt install graphviz

You will also need to install radare2 5.8.4:

$ curl -Ls https://github.com/radareorg/radare2/releases/download/5.8.4/radare2-5.8.4.tar.xz | tar xJv
$ radare2-5.8.4/sys/install.sh