|LER0ever fa42a502f1 Merge branch 'master' of https://github.com/dyninst/dyninst||1 month ago|
|cmake||3 months ago|
|common||2 months ago|
|dataflowAPI||3 months ago|
|dwarf||4 months ago|
|dynC_API||1 year ago|
|dyninstAPI||1 month ago|
|dyninstAPI_RT||3 months ago|
|elf||5 months ago|
|examples||2 months ago|
|external||1 year ago|
|instructionAPI||3 months ago|
|parseAPI||3 months ago|
|parseThat||2 months ago|
|patchAPI||5 months ago|
|proccontrol||2 months ago|
|scripts||3 years ago|
|stackwalk||3 months ago|
|symlite||2 years ago|
|symtabAPI||1 month ago|
|syscalls||3 years ago|
|valueAdded||5 years ago|
|.github_changelog_generator||3 months ago|
|.gitignore||2 months ago|
|.gitmodules||1 year ago|
|.syntastic_cpp_config||3 years ago|
|.travis.yml||2 years ago|
|CHANGELOG.md||3 months ago|
|CMakeLists.txt||2 months ago|
|COPYRIGHT||6 years ago|
|DyninstConfigVersion.cmake||5 years ago|
|LICENSE.md||1 year ago|
|README.md||3 months ago|
|appveyor.yml||1 year ago|
|aarch32||experimental||Contact Ray Chen (rchen at cs dot umd dot edu)|
spack install dyninst
make install -jN
If this short version does not work for you, please refer to the long version and the FAQs below.
Dyninst is built via CMake. We require CMake 3.0.0 as a minimum on all systems. CMake will automatically search for dependencies and download them when not found. The main dependencies of Dyninst include:
elfutils, 0.173 minimum, https://sourceware.org/elfutils/
Boost, 1.61.0 or later recommended, https://www.boost.org/
The Intel Thread Building Blocks (TBB), 2018 U6 or later recommended, https://www.threadingbuildingblocks.org/
OpenMP, optional for parallel code parsing. Note that Dyninst will not automatically download or install OpenMP
We recommend performing an interactive configuration with “ccmake /path/to/dyninst/source” first, in order to see which options are relevant for your system. You may also perform a batch configuration with “cmake /path/to/dyninst/source”. Options are passed to CMake with -DVAR=VALUE. Common options include:
PATH_BOOST: base directory of your boost installation
LIBELF_INCLUDE_DIR: the location of elf.h and libelf.h
LIBELF_LIBRARIES: full path of libelf.so
LIBDWARF_INCLUDE_DIR: location of libdw.h
LIBDWARF_LIBRARIES: full path of libdw.so
TBB_INCLUDE_DIRS: the direcory of the include files of TBB
TBB_tbb_LIBRARY_DEBUG: full path of libtbb_debug.so
TBB_tbb_LIBRARY_RELEASE: full path of libtbb.so
CMAKE_BUILD_TYPE: may be set to Debug, Release, or RelWithDebInfo for unoptimized, optimized, and optimized with debug information builds respectively. Note that RelWithDebInfo is the default.
CMAKE_INSTALL_PREFIX: like PREFIX for autotools-based systems. Where to install things.
USE_OpenMP: whether or not use OpenMP for parallel parsing. Default to be
ENABLE_STATIC_LIBS: also build dyninst in static libraries. Default to be
NO. Set to
YES to build static libraries.
CMake’s default generator on Linux is normally “Unix Makefiles”, and on Windows, it will normally produce project files for the most recent version of Visual Studio on your system. Other generators should work but are not tested. After the CMake step concludes, you will have appropriate Makefiles or equivalent and can build Dyninst.
If you are cross-compiling Dyninst, including builds for various Cray and Intel MIC systems, you will either need a toolchain file that specifies how to properly cross-compile, or you will need to manually define the appropriate compiler, library locations, include locations, and the CROSS_COMPILING flag so that the build system will properly evaluate what can be built and linked in your environment.
CMake allows Dyninst to be built out-of-source; simply invoke CMake in your desired build location. In-source builds are still fully supported as well. Each component of Dyninst may be built independently: cd $component; make. Standard make options will work; we fully support parallel compilation for make -jN. Setting VERBOSE=1 will replace the beautified CMake output with raw commands and their output, which can be useful for troubleshooting.
On Windows, you will need the Debug Information Access (DIA) SDK, which should be available with an MSDN subscription, in order to build Dyninst; you will not need libelf, libdwarf, binutils, or the GCC demangler. Dyninst is still built via CMake, and the NMake and Visual Studio project file generators should both work. We have not tested building Dyninst on Windows with gcc, and we do not expect this to work presently.
If you wish to import
Dyninst into your own CMake projects, the export information is in
CMAKE_INSTALL_PREFIX/INSTALL_CMAKE_DIR. PDF documentation is included
and installed to
CMAKE_INSTALL_PREFIX/INSTALL_DOC_DIR. If you update
the LaTeX source documents for any manuals, “make doc” will rebuild
them. Components may be built and installed individually: “make
$COMPONENT” and “make $COMPONENT-install” respectively; this will
appropriately respect inter-component dependencies.
"/lib64/libdw.so.1: version `ELFUTILS_0.173' not found
error: 'dwarf_next_lines' was not declared in this scope
A: Dyninst now depends on elfutils-0.173 or later. If you are seeing above errors, it means the elfutils installed on your system is older than 0.173. We recommend that you set
LIBDWARF_LIBRARIES to empty, which will trigger the CMake to automatically download the correct version of elfutils. Or you can upgrade your elfutils with your system package manager.
A: After installation, Dyninst should copy all dependencies to the install location. In case where the dependencies are not copied, they can be found in the directory where you build Dyninst. For example, suppose you configure and build Dyninst at:
Then elfutils, TBB, boost can be found at
A: Boost’s library naming convention is a little confusing. You probably have the non-multi-threading version installed. So your boost libraries will look like “libboost_system.so”. Dyninst links against the multi-threading version of boost, so it will needs “libboost_system-mt.so”. Note the “-mt” in the library name. There are two ways to work around:
PATH_BOOST to empy which will trigger Dyninst to automaticall build Boost
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.