Skip to content
forked from dyninst/dyninst

DyninstAPI: Tools for binary instrumentation, analysis, and modification.

License

Notifications You must be signed in to change notification settings

blue42u/dyninst

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Dyninst

Branch states

Branch Status Notes
master stable See below
aarch32 experimental Contact Ray Chen (rchen at cs dot umd dot edu)

Notes

  • Known issues should have open issues associated with them.
  • ARMv8 (64 bit) support for dynamic instrumentation is experimental and incomplete. For more details about current supported functionality refer to Dyninst Support for the ARMv8 (64 bit).

Build DyninstAPI and its subcomponents

Install with Spack

spack install dyninst

Build from source

  1. Configure Dyninst with CMake

    cmake /path/to/dyninst/source -DCMAKE_INSTALL_PREFIX=/path/to/installation

    NOTE: If Dyninst builds TBB from source, see the wiki for instructions on ensuring correct usage.

  2. Build and install Dyninst in parallel

    make install -jN

If this does not work for you, please refer to the Wiki for detailed instructions. If you encounter any errors, see the Building Dyninst or leave a GitHub issue.

Known Issues

  • Windows 64-bit mode is not yet supported

  • Windows rewriter mode is not yet supported

  • Exceptions in relocated code will not be caught

  • Linux rewriter mode for 32-bit, statically linked binaries does not support binaries with .plt, .rel, or .rela sections.

  • Callbacks at thread or process exit that stop the process will deadlock when a SIGSEGV occurs on a thread other than the main thread of a process

  • Stackwalker is fragile on Windows

  • Parsing a binary with no functions (typically a single object file) will crash at CodeObject destruction time.

About

DyninstAPI: Tools for binary instrumentation, analysis, and modification.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C 63.5%
  • C++ 26.9%
  • Assembly 3.7%
  • TeX 2.9%
  • CMake 2.2%
  • Python 0.2%
  • Other 0.6%