TAO/tests/OBV/TC_Alignment/README

   1 /**
   2
   3
   4
   5 @page OBV/TC_ALignment Test README File
   6
   7         This is a test of the traversal of the typecode tree for valuetypes.
   8 Specifically, elements of the valuetypes typecode that are respresent CORBA
   9 Short values, for example the value modifier, have been known to cause errors
  10 when traversing the typecode tree if the previous quantity inserted (in this
  11 case the repository id) has left the write pointer with an odd offset from
  12 an 8-byte boundary. This problem has been fixed - the test is to ensure that
  13 the problem does not recur as a result of future changes to the TAO TypeCode
  14 class.
  15
  16         Four valuetypes are declared in an IDL file, named in such a way
  17 that their repository IDs (including the terminal null byte) have lengths
  18 of 25, 27, 29, and 31. The test method is called 4 times. In each call,
  19 one of these valuetypes is inserted into an Any and returned to the client,
  20 who extracts it from the Any and checks the state member for the
  21 correct value.
  22
  23         To run the test use the run_test.pl script:
  24
  25 $ ./run_test.pl
  26
  27 The script returns 0 if the test was successful.
  28
  29 The command line option -d turns on debugging information for any
  30 errors that may occur. The script will automatically shut down the
  31 server by means of a client call. If the test is run by hand, this
  32 will not happen automatically - the command line option -x must be
  33 passed to the client.
  34
  35 */