TAO/tests/Param_Test/README

   1
   2
   3 This directory contains an application that tests all the parameter
   4 passing conventions in CORBA for a number of OMG IDL data types.
   5
   6 Type "make" to make the application. The server executable is called
   7 "server" and the client executable is called "client".
   8
   9 You should have the TAO IDL compiler and the TAO library installed
  10 before using this application.
  11
  12 The -GA options has been added the IDL compiler command line for this
  13 test. This option moves the generation of implementations for type
  14 codes and Any insertion/extraction operators to a separate file with
  15 the extension *A.cpp. Adding this option tests that it is handled
  16 correctly for all the various IDL types used in this test.
  17
  18 To run the server, type
  19
  20    server [arguments to ORB_init] [-d] [-o <ior_output_file>]
  21
  22           arguments to ORB_init start with the letters -ORB. Please
  23           see TAO documentattion on all the supported arguments
  24
  25           -d for debugging.
  26           -o <ior_output_file> for outputting the servant IOR to a file.
  27
  28 To run the client, type
  29
  30    client [arguments to ORB_init] [options for this application]
  31
  32    Supported options are:
  33
  34    [-d]                                 debugging
  35    [-n loopcount]                       number of times to run the test
  36    [-f servant-IOR-file]                reads the servant-IOR from the
  37                                         specified file.
  38    [-k Param_Test-obj-ref-key]          object key of Param_Test object
  39    [-i invocation (sii/dii)]            default is static invocation
  40                                         interface. To use DII, type
  41                                         -i dii
  42    [-t data type]
  43        Data types supported in this version are:
  44
  45        short                for shorts
  46        ulonglong            for unsigned long long
  47        ubstring             for unbounded string
  48        ubwstring            for unbounded wide string
  49        bdstring             for bounded string
  50        bswstring            for bounded wide string
  51        fixed_struct         for fixed sized structs
  52        ub_strseq            for sequences of strings
  53        ub_wstrseq           for sequences of wide strings
  54        bd_strseq            for bounded sequences of strings
  55        bd_wstrseq           for bounded sequences of wide strings
  56        var_struct           for variable structs
  57        nested_struct        for nested structs
  58        objref_struct        for object references inside structures
  59        ub_struct_seq        for sequences of structs
  60        bd_struct_seq        for bounded sequences of structs
  61        any                  for Any
  62        objref               for object references
  63        objref_sequence      for sequences object references
  64        any_sequence         for sequences of Any
  65        ub_short_sequence    for sequences of shorts
  66        ub_long_sequence     for sequences of shorts
  67        bd_short_sequence    for bounded sequences of shorts
  68        bd_long_sequence     for bounded sequences of shorts
  69        fixed_array          for arrays of fixed sized types (longs)
  70        var_array            for arrays of var sized types (strings)
  71        typecode             for typecode
  72        exception            for exceptions
  73        multdim_array        for multi dimensional arrays
  74
  75
  76         There are 2 options of giving the Param_obj-ref-key i.e IOR to
  77 the client:
  78
  79         1. Using the -f option to read the IOR from a file.
  80
  81         2. Using the -k option to read the IOR from the
  82            command line.
  83
  84 run_test.pl:
  85 -----------
  86         There is a perl script in this directory named run_test.pl to
  87         test all the types. It starts the server first and then runs
  88         the client with the different data type parameters. The
  89         arguments it takes are:
  90
  91         -n num              -- runs the client num times (default is 5)
  92         -d                  -- runs each in debug mode
  93         -h                  -- prints this information
  94         -t type             -- runs only one type of param test
  95         -i (dii|sii)        -- Changes the type of invocation (default is sii)