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, and
   4 rs6000-ibm-aix4.1 platforms.
   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.