Skip to content

Commit

Permalink
Updated docs to reflect make.config.local required vars, and to update
Browse files Browse the repository at this point in the history
README to 5.0.

Also added ChangeLog file and removed programmers guide misnamed as install
guide.
  • Loading branch information
jodom committed Jun 23, 2006
1 parent 4a39c29 commit 3a92209
Show file tree
Hide file tree
Showing 2 changed files with 41 additions and 18 deletions.
22 changes: 22 additions & 0 deletions ChangeLog
@@ -0,0 +1,22 @@
5.0
Support for multithreaded executables
Lazy parsing of binaries to speed up startup time
Optimized liveness analysis spills only necessary registers
Minitramp inlining
Preliminary transaction support
64-bit support for x86_64 binaries
Support newer Windows debug formats
gcc 4.x support
Binary distribution in RPM, deb, and msi formats

4.2.1
Added support for GNU Fortran on x86 Linux
Added support for building DyninstAPI library with xlC on AIX

4.2
Added asynchronous event handler
Added ability to parse stripped PowerPC binaries
Improved startup speed via incremental parsing
Easier installation and build process
Smarter register allocation on AIX
[BETA] Preliminary 32-bit functionality for x86_64/Linux platform
37 changes: 19 additions & 18 deletions dyninstAPI/README
@@ -1,7 +1,8 @@

This is the version 4.2.1 release of the Dyninst API. Currently, the API
This is the version 5.0 release of the Dyninst API. Currently, the API
library is available for the Sparc/Solaris, POWER/AIX, x86/Linux,
x86/Windows NT, MIPS/Irix, Alpha/Tru64 Unix, and ia64/Linux platforms.
x86/Windows XP/2000/2003, Alpha/Tru64 Unix, ia64/Linux, and x86_64/Linux
platforms.

Documentation for the API can be found at:

Expand All @@ -21,32 +22,30 @@ one of the following values depending upon what operating system you are
running on:

alpha-dec-osf5.1 Tru64 Unix on the Alpha processor
i386-unknown-linux2.4 Linux 2.4 on an Intel x86 processor
i386-unknown-nt4.0 Windows NT/2000 on an Intel x86 processor
ia64-unknown-linux2.4 Linux 2.4 on an IA-64 processor
mips-sgi-irix6.5 Irix 6.5
i386-unknown-linux2.4 Linux 2.4/2.6 on an Intel x86 processor
i386-unknown-nt4.0 Windows XP/2000/2003 on an Intel x86 processor
ia64-unknown-linux2.4 Linux 2.4/2.6 on an IA-64 processor
rs6000-ibm-aix5.1 AIX Version 5.1
sparc-sun-solaris2.8 Solaris 2.8 on a SPARC processor
sparc-sun-solaris2.9 Solaris 2.9 on a SPARC processor
x86_64-unknown-linux2.4 Linux 2.4/2.6 on an AMD-64 processor

DYNINST_ROOT should be set to the pathname of the top of the library
directory tree (dyninstAPI-v4.2.1).
directory tree (dyninstAPI-v5.0).

DYNINSTAPI_RT_LIB should be set to the full pathname of the file
libdyninstAPI_RT.so.1 (on Windows NT, libdyninstAPI_RT.dll). If you have
libdyninstAPI_RT.so.1 (on Windows, libdyninstAPI_RT.dll). If you have
correctly set the DYNINST_ROOT and PLATFORM environment variables, then the
proper pathname is:

$DYNINST_ROOT/$PLATFORM/lib/libdyninstAPI_RT.so.1

On Windows NT, you may instead simply put the directory
%DYNINST_ROOT%/%PLATFORM%/lib in your path.
$DYNINST_ROOT/$PLATFORM/lib/libdyninstAPI_RT.so.1 (UNIX)
%DYNINST_ROOT%/i386-unknown-nt4.0/lib/libdyninstAPI_RT.dll (Windows)

On Unix-based systems, you will also need to add $DYNINST_ROOT/$PLATFORM/lib
to your LD_LIBRARY_PATH environment variable (LIBPATH on AIX,
LD_LIBRARY64_PATH on Irix). On Windows NT, you will instead need to add
%DYNINST_ROOT%/%PLATFORM%/lib to your PATH environment variable. This is so
that mutator applications can be linked dynamically with the Dyninst library.
LD_LIBRARY64_PATH on Irix). On Windows, you will instead need to add
%DYNINST_ROOT%/i386-unknown-nt4.0/lib to your PATH environment variable.
This is so that mutator applications can be linked dynamically with the
Dyninst library.

Notes on Using Dyninst with Linux
---------------------------------
Expand All @@ -56,7 +55,9 @@ in most distributions. The first is libelf, which is included with most
distributions and can be installed using the distribution's package manager.
The second is libdwarf. You can get the latest source code distribution
of libdwarf from http://reality.sgiweb.org/davea/. RPM files for libdwarf
are also available from various sites.
are also available from various sites. Lastly, for IA-64, libunwind must
be installed, which can be found at
http://www.hpl.hp.com/research/linux/libunwind/.

Building the Dyninst API from source
------------------------------------
Expand All @@ -80,7 +81,7 @@ the same copyright. A copy of the Paradyn copyright appears at the end of
this file.

The Dyninst API Team
4/12/2005
6/23/2006

----------------------- Start of Paradyn Copyright --------------------------
Copyright (c) 1996 Barton P. Miller
Expand Down

0 comments on commit 3a92209

Please sign in to comment.