Parameterize LIBRARY_DEST, PROGRAM_DEST, etc.
[dyninst.git] / dyninstAPI / README
1
2 This directory contains the Dyninst API library.  To make the library, type
3 "make install" in the subdirectory of this directory that is named after the
4 platform that on which you are building the library.  The library also depends
5 on code in the core/util and core/dyninstAPI_RT directories, so you will also
6 need to go into the appropriate platform subdirectories of these directories
7 and type "make install."  If you have built Paradyn, then the util library
8 will have already been built.
9
10 On Windows NT, before running make in the core/util/i386-unknown-nt4.0
11 directory, you will need to obtain and install ONC RPC for Windows NT.   See
12 the page http://set.gmd.de/~mfg/oncrpc.html for information about this
13 package.  The makefiles expect it to be installed in the directory C:\SUNRPC.
14
15 On platforms on which the API dynamically loads a run-time library into an
16 application's address space (Sparc Solaris and Windows NT), you must set
17 certain values in the environment so that it can locate the run-time library.
18 On the Sparc Solaris platform, you must set the DYNINSTAPI_RT_LIB environment
19 variable to the full pathname of the file libdyninstAPI_RT.so.1.  If you have
20 correctly set the PARADYN_ROOT and PLATFORM environment variables, then the
21 proper pathname is:
22
23     $PARADYN_ROOT/lib/$PLATFORM/libdyninstAPI_RT.so.1
24
25 On Windows NT, you should put the directory %PARADYN_ROOT%/lib/%PLATFORM%
26 in your path.
27
28 After the dyninstAPI_RT, util, and dyninstAPI libraries have been built and
29 installed, you can test them using the programs in core/dyninstAPI/tests.  See
30 the README file in that directory for information about the test programs.