derek.holloway
7502bf64a4
CodeQL / Analyze (actions) (push) Canceled after 0s
CodeQL / Analyze (python) (push) Canceled after 0s
pre-commit / pre-commit (push) Canceled after 0s
Multi-Arch CI / setup (push) Canceled after 0s
Publish build_manylinux_x86_64 images / publish_build_manylinux_x86_64 (push) Canceled after 0s
Setup (Multi-Arch) / setup (push) Canceled after 0s
Multi-Arch CI / Linux::${{ fromJSON(needs.setup.outputs.linux_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubi10 image / publish_no_rocm_image_ubi10 (push) Canceled after 0s
Multi-Arch CI / Windows::${{ fromJSON(needs.setup.outputs.windows_build_config || '{}').build_variant_label || 'skip' }} (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Multi-Arch CI / Manifest Diff (push) Canceled after 0s
TheRock Manifest Diff Report / Generate Manifest Diff Report (push) Canceled after 0s
Multi-Arch CI / CI Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_ocl_rt images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04_rocgdb images / publish_no_rocm_image_ubuntu24_04_rocgdb (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_ocl_rt (push) Canceled after 0s
Publish TheRock Docker image / build-and-push-image (push) Canceled after 0s
Unit Tests / Unit Tests :: ubuntu-24.04 (push) Canceled after 0s
Unit Tests / Unit Tests :: windows-2022 (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_media (push) Canceled after 0s
Unit Tests / Unit Tests Summary (push) Canceled after 0s
Publish no_rocm_image_ubuntu24_04 images / publish_no_rocm_image_ubuntu24_04_openmpi (push) Canceled after 0s
52 lines
1.9 KiB
Markdown
52 lines
1.9 KiB
Markdown
# 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)](https://github.com/dyninst/dyninst/wiki/DyninstAPI-ARMv8-status).
|
|
|
|
## 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](docker) directory.
|
|
|
|
|
|
### 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```
|
|
|
|
2. Build and install Dyninst in parallel
|
|
|
|
```make install -jN```
|
|
|
|
If this does not work for you, please refer to the [Wiki](https://github.com/dyninst/dyninst/wiki) for detailed instructions. If you encounter any errors, see the [Building Dyninst](https://github.com/dyninst/dyninst/wiki/Building-Dyninst) or leave a [GitHub issue](https://github.com/dyninst/dyninst/issues).
|
|
|
|
## 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.
|