Skip to content

Latest commit

 

History

History
68 lines (47 loc) · 3.16 KB

README.md

File metadata and controls

68 lines (47 loc) · 3.16 KB
Raw

strace2ds-library - a bridge between strace and DataSeries trace format

This library connects the strace code (written in C) to the DataSeries API (written in C++). It acts as a glue so that C++ functions are made callable from C code. Our fork of strace, reanimator-strace, takes advantage of this library to output traces in the DataSeries format.

Dependencies

Currently, only Ubuntu 16 and 18 are officially supported.

  • Lintel - general utility library for DataSeries
  • DataSeries - data format for structured serial data
  • tcmalloc - high-performance, multi-threaded malloc() implementation
  • libtool
  • libboost-dev (v1.58 only)
  • libboost-thread-dev (v1.58 only)
  • libboost-program-options-dev (v1.58 only)
  • build-essential
  • libxml2-dev
  • zlib1g-dev

Build Instructions

Install the following required programs and libraries. On Ubuntu 16 and 18, all the above requirements are available through the APT package manager.:

git cmake perl autoconf automake gcc g++ libtool libboost-dev libboost-thread-dev libboost-program-options-dev build-essential libxml2-dev zlib1g-dev

Automated Build

After installing the required programs and libraries, run build-reanimator-library.sh to automatically build strace2ds. All arguments are optional:

Argument Description
--install Install libraries and binaries under /usr/local
--install-dir DIR Install libraries and binaries to DIR (ignored if --install)
--config-args ARGS Append ARGS to every ./configure command
-h, --help Display a help message

Manual Build

Manually building strace2ds closely resembles the steps taken in build-reanimator-library.sh.

  1. Install Lintel by running cmake . && make && make install at the root of the Lintel repository.

  2. Install DataSeries by running cmake . && make && make install at the root of the DataSeries repository.

  3. Install tcmalloc from the gperftools repository. See the gperftools INSTALL file for detailed instructions.

  4. Navigate to the tables/ subdirectory and run perl gen-xml-enums.pl to update the .xml files.

  5. Create a subdirectory named build in the strace2ds-library directory and navigate to it. Run cp -r ../xml ./ to copy the xml folder into the build directory.

  6. cd into your build directory and run cmake -DCMAKE_INSTALL_PREFIX:PATH=<Install Here> ../. Specifying a custom install directory for make install via -DCMAKE_INSTALL_PREFIX:PATH=<Install Here> is optional.

  7. Run make and make install to build and install strace2ds.