isLeaf() --> hasNoStackFrame() for instPoint and pd_Function
[dyninst.git] / dyninstAPI / tests / README
1
2 This directory contains tests for the dyninstAPI library.  The library
3 currently runs on the sparc-sun-solaris2.4, sparc-sun-sunos4.1.3,
4 rs6000-ibm-aix4.1 platforms, and i386-unknown-solaris2.5 platofrms.
5
6 Before you can build the test programs, you will need do a "make install"
7 in the following directories (relative to the top of the paradyn source
8 tree):
9
10     core/util/$PLATFORM
11     core/dyninstAPI_RT/$PLATFORM
12     core/dyninstAPI/$PLATFORM
13
14 If you've made paradyn, then you'll already have the util library
15 installed.
16
17 Once you've made the above libraries, you can go into the $PLATFORM
18 subdirectory of the directory containing this README file and run make
19 there.
20
21 To run the tests, type "test1" in the directory in which they were made.
22 The test1 program starts test1.mutatee (which must be in the current
23 working directory when you run test1).  Test1 instruments test1.mutatee
24 and then lets it run to check that the results of the instrumentation were
25 as expected.
26
27 You should see a series of messages saying that tests 1-16 were passed.
28 If any messages saying "**Failed** test #n" appear then there is a problem
29 in the dyninstAPI library.
30
31 It is normal to see the messages "WARNING: register _n_ is still in use" and
32 "attempt to ptrace exited process," as well as the message "Process _n_
33 has terminated" when test1.mutatee exits.