diff options
Diffstat (limited to 'TAO/tests/Param_Test/README')
| -rw-r--r-- | TAO/tests/Param_Test/README | 109 |
1 files changed, 109 insertions, 0 deletions
diff --git a/TAO/tests/Param_Test/README b/TAO/tests/Param_Test/README new file mode 100644 index 00000000000..3bd468d2ff3 --- /dev/null +++ b/TAO/tests/Param_Test/README @@ -0,0 +1,109 @@ +// $Id$ + +// ============================================================================ +// +// = LIBRARY +// TAO/tests/Param_Test +// +// = FILENAME +// README +// +// = AUTHOR +// Aniruddha Gokhale +// +// ============================================================================ + +This directory contains an application that tests all the parameter +passing conventions in CORBA for a number of OMG IDL data types. + +Type "make" to make the application. The server executable is called +"server" and the client executable is called "client". + +You should have the TAO IDL compiler and the TAO library installed +before using this application. + +The -GA options has been added the IDL compiler command line for this +test. This option moves the generation of implementations for type +codes and Any insertion/extraction operators to a separate file with +the extension *A.cpp. Adding this option tests that it is handled +correctly for all the various IDL types used in this test. + +To run the server, type + + server [arguments to ORB_init] [-d] [-o <ior_output_file>] + + arguments to ORB_init start with the letters -ORB. Please + see TAO documentattion on all the supported arguments + + -d for debugging. + -o <ior_output_file> for outputting the servant IOR to a file. + +To run the client, type + + client [arguments to ORB_init] [options for this application] + + Supported options are: + + [-d] debugging + [-n loopcount] number of times to run the test + [-f servant-IOR-file] reads the servant-IOR from the + specified file. + [-k Param_Test-obj-ref-key] object key of Param_Test object + [-i invocation (sii/dii)] default is static invocation + interface. To use DII, type + -i dii + [-t data type] + Data types supported in this version are: + + short for shorts + ulonglong for unsigned long long + ubstring for unbounded string + ubwstring for unbounded wide string + bdstring for bounded string + bswstring for bounded wide string + fixed_struct for fixed sized structs + ub_strseq for sequences of strings + ub_wstrseq for sequences of wide strings + bd_strseq for bounded sequences of strings + bd_wstrseq for bounded sequences of wide strings + var_struct for variable structs + nested_struct for nested structs + objref_struct for object references inside structures + ub_struct_seq for sequences of structs + bd_struct_seq for bounded sequences of structs + any for Any + objref for object references + objref_sequence for sequences object references + any_sequence for sequences of Any + ub_short_sequence for sequences of shorts + ub_long_sequence for sequences of shorts + bd_short_sequence for bounded sequences of shorts + bd_long_sequence for bounded sequences of shorts + fixed_array for arrays of fixed sized types (longs) + var_array for arrays of var sized types (strings) + typecode for typecode + exception for exceptions + multdim_array for multi dimensional arrays + + + There are 2 options of giving the Param_obj-ref-key i.e IOR to +the client: + + 1. Using the -f option to read the IOR from a file. + + 2. Using the -k option to read the IOR from the + command line. + +run_test.pl: +----------- + There is a perl script in this directory named run_test.pl to + test all the types. It starts the server first and then runs + the client with the different data type parameters. The + arguments it takes are: + + -n num -- runs the client num times (default is 5) + -d -- runs each in debug mode + -onewin -- keeps all tests in one window on NT + -h -- prints this information + -t type -- runs only one type of param test + -i (dii|sii) -- Changes the type of invocation (default is sii) |