Dyninst API

The normal cycle of developing a program is to edit source code, compile it, and then execute the resulting binary. However, sometimes this cycle can be too restrictive. We may wish to change the program while it is executing, and not have to re-compile, re-link, or even re-execute the program to change the binary. At first, this may seem like a bizarre goal, however there are several practical reasons why we may wish to have such a system. For example, if we are measuring the performance of a program and discover a performance problem, it might be necessary to insert additional instrumentation into the program to understand the problem. Another application is performance steering; for large simulations, computational scientists often find it advantageous to be able to make modifications to the code and data while the simulation is executing. Applications that can make use of this dynamic code adaptation system include:

  • Performance Measurement Tools
  • Correctness Debuggers (efficient data breakpoints)
  • Execution drive simulations
  • Computational Steering

We have created an Application Program Interface (API) to permit the insertion of code into a running program. The goal of this API is to provide a machine independent interface to permit the creation of tools and applications that use runtime code patching. This API is based on the idea of Dynamic Instrumentation described in [1, 2] and used in the example here. A variety of tools have been built using Dyninst.

View details of the Dyninst project's status, view tools that use Dyninst, and view papers (not by Dyninst developers) that use Dyninst in their work.

Dyninst can be downloaded here