Star on GitHubStar1.1k stars

Tool

Dyninst

Binary instrumentation, analysis and modification libraries from the Paradyn project. DyninstAPI inserts and changes instrumentation in a running program, or rewrites an executable or library on disk and writes the patched copy back, through one machine-independent interface that also supports static and dynamic analysis. Separately documented components handle symbol tables, line numbers and types (SymtabAPI), instruction decoding and disassembly (InstructionAPI), parsing into blocks, functions and loops (ParseAPI), dataflow analyses such as slicing (DataFlowAPI), process control, stack walking and patching.

Targets
Binary
Category
Debugging and dynamic analysis
Relationship
Foundation tool
Sources reviewed

Requirements & limits

  • The CMake platform check accepts Linux, FreeBSD and Windows hosts on x86-64, 32-bit x86, AArch64, ppc64le and riscv64, plus AMD GPU code-generation targets; InstructionAPI documents x86, x86-64, ARMv8-64 and 32/64-bit PowerPC decoding. The README calls AArch64 dynamic instrumentation experimental and incomplete, and its known issues include no Windows 64-bit or Windows rewriter mode, uncaught exceptions in relocated code, a fragile Windows stack walker and a crash when parsing a binary with no functions.
  • Latest release at review: v13.0.0, published 2024-03-21. The reviewed master commit still declares version 13.0.0 and is 590 commits ahead of that tag; the README says the bundled v13.0.0 PDF manuals are a snapshot, so current behavior needs manuals built from source with pdflatex.
  • Install with Spack or build from source with CMake 3.14+ (3.19.0 is rejected), a C11/C++11 toolchain (GCC 6+), Boost 1.71+, TBB 2019.9+ and, on Unix, elfutils 0.186+; Docker containers for development are described in the docker directory. Users supply their own executables, libraries or running processes to analyze or instrument.
  • LGPL-2.1 (LICENSE.md). COPYRIGHT credits Barton P. Miller with contributions from LLNS, Red Hat and Bull SAS, and DataFlowAPI incorporates Rose Compiler Project code under its own copyright notice.

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

  1. README.md GitHub · dyninst/dyninst · Revision 0c08389
  2. README.md#L47-L63 GitHub · dyninst/dyninst · Revision 0c08389
  3. docs/README.md GitHub · dyninst/dyninst · Revision 0c08389
  4. docs/dyninstAPI/manual-latex/Introduction.tex GitHub · dyninst/dyninst · Revision 0c08389
  5. docs/parseAPI/manual-latex/1-Intro.tex GitHub · dyninst/dyninst · Revision 0c08389
  6. docs/instructionAPI/manual-latex/1-Intro.tex GitHub · dyninst/dyninst · Revision 0c08389
  7. docs/dataflowAPI/manual-latex/Intro.tex GitHub · dyninst/dyninst · Revision 0c08389
  8. cmake/DyninstPlatform.cmake GitHub · dyninst/dyninst · Revision 0c08389
  9. CMakeLists.txt GitHub · dyninst/dyninst · Revision 0c08389
  10. cmake/DyninstLanguageStandards.cmake GitHub · dyninst/dyninst · Revision 0c08389
  11. cmake/tpls GitHub · dyninst/dyninst · Revision 0c08389
  12. LICENSE.md GitHub · dyninst/dyninst · Revision 0c08389
  13. COPYRIGHT GitHub · dyninst/dyninst · Revision 0c08389
  14. https://github.com/dyninst/dyninst/releases/tag/v13.0.0

More in Native binaries

All 269 entries in Native binaries

↑↓ move↵ open⌘↵ new tab