Fixing some problems and bringing the NT version up to date - naim
[dyninst.git] / dyninstAPI / tests / README
1
2 This directory contains tests for the dyninstAPI library.
3
4 Before you can build the test programs, you will need do a "make install"
5 in the following directories (relative to the top of the paradyn source
6 tree):
7
8     core/util/$PLATFORM
9     core/dyninstAPI_RT/$PLATFORM
10     core/dyninstAPI/$PLATFORM
11
12 If you've made paradyn, then you'll already have the util library
13 installed.
14
15 Once you've made the above libraries, you can go into the $PLATFORM
16 subdirectory of the directory containing this README file and run make
17 there.
18
19 To run the tests, type "test1" or "test2" in the directory in which they
20 were made.  Each test program starts a mutatee process, test1.mutatee or
21 test2.mutatee, the executable for which must be in the current directory.
22 For both programs, you should see a series of messages saying that each
23 test was passed.
24
25 The programs take two options:
26     -verbose    Print extra output.
27     -attach     Start the mutatee without using the library and then
28                 attach to it.  This option is only supported on Solaris
29                 and Windows NT.
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.
34
35 The test2 program tests to see that various error conditions are caught
36 and reported properly by the library, so it is normal for it to print some
37 warning and error messages.  If all tests pass, it will print a message
38 saying so, so you may assume any error messages printed were expected.