TAO/tests/Alt_Mapping/README

   1 // ============================================================================
   2 // This test covers the use of std::string as an alternate C++  mapping for
   3 // CORBA strings, and the use of std::vector<T> as an alternate C++ mapping
   4 // for sequences of type T. The current version of the test uses a struct
   5 // containing several simple date types - more types of sequences will be
   6 // added in the future.
   7 // ============================================================================
   8
   9 This directory contains an application that tests all the parameter
  10 passing conventions in CORBA for the supported OMG IDL data types.
  11
  12 Type "make" to make the application. The server executable is called
  13 "server" and the client executable is called "client".
  14
  15 You should have the TAO IDL compiler and the TAO library installed
  16 before using this application.
  17
  18 The -GA options has been added the IDL compiler command line for this
  19 test. This option moves the generation of implementations for type
  20 codes and Any insertion/extraction operators to a separate file with
  21 the extension *A.cpp. Adding this option tests that it is handled
  22 correctly for all the various IDL types used in this test.
  23
  24 To run the server, type
  25
  26    server [arguments to ORB_init] [-d] [-o <ior_output_file>]
  27
  28           arguments to ORB_init start with the letters -ORB. Please
  29           see TAO documentattion on all the supported arguments
  30
  31           -d for debugging.
  32           -o <ior_output_file> for outputting the servant IOR to a file.
  33
  34 To run the client, type
  35
  36    client [arguments to ORB_init] [options for this application]
  37
  38    Supported options are:
  39
  40    [-d]                                 debugging
  41    [-n loopcount]                       number of times to run the test
  42    [-f servant-IOR-file]                            reads the servant-IOR from the
  43                                         specified file.
  44    [-k Param_Test-obj-ref-key]          object key of Param_Test object
  45    [-i invocation (sii/dii)]            default is static invocation
  46                                         interface. To use DII, type
  47                                         -i dii
  48    [-t data type]
  49        Data types supported in this version are:
  50
  51        ubstring             for unbounded string
  52        ub_struct_seq        for sequences of structs
  53
  54
  55         There are 2 options of giving the IOR to the client:
  56
  57         1. Using the -f option to read the IOR from a file.
  58
  59         2. Using the -k option to read the IOR from the
  60            command line.
  61
  62 run_test.pl:
  63 -----------
  64         There is a perl script in this directory named run_test.pl to
  65         test all the types. It starts the server first and then runs
  66         the client with the different data type parameters. The
  67         arguments it takes are:
  68
  69               -n num              -- runs the client num times (default is 5)
  70         -d                  -- runs each in debug mode
  71         -h                  -- prints this information
  72         -t type             -- runs only one type of param test
  73         -i (dii|sii)        -- Changes the type of invocation (default is sii)
  74                                (as of 5/3/10 DII is not yet supported)