Dyninst
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).
Documentation
Each component has a manual, written in LaTeX and built to PDF by the CMake
build. The PDFs as released for 13.0.0 are in
docs/v13.0.0_manuals; they are a snapshot, so build
from source for anything newer.
See docs/README.md for the directory layout, how to build
the manuals, and how to add one.
Build DyninstAPI and its subcomponents
Docker Containers
Containers are provided that can be used for Dyninst development (e.g., make changes to Dyninst and quickly rebuild it)
or for development of your own tools (e.g., have a container ready to go with Dyninst). Links will be added
here when the containers are pushed to the Dyninst associated package registries. Instructions for usage
and building locally are provided in the docker directory.
Install with Spack
spack install dyninst
Build from source
-
Configure Dyninst with CMake
cmake /path/to/dyninst/source -DCMAKE_INSTALL_PREFIX=/path/to/installation
-
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.
Contacting the Dyninst Project
Below are the mechanisms that are available for you to contact us about any
concerns and to keep in touch with announcements related to Dyninst.
| Contact | Description |
|---|
| GitHub issues | Dyninst's issue tracker for problems with building or the functioning of the Dyninst libraries including bugs or new feature requests. |
| Dyninst Announcements | Mailing list of announcements related to Dyninst. |
| [email protected] | Email address to privately contact the Dyninst Team. |
