summaryrefslogtreecommitdiff
path: root/TAO/tests/Param_Test/README
diff options
context:
space:
mode:
Diffstat (limited to 'TAO/tests/Param_Test/README')
-rw-r--r--TAO/tests/Param_Test/README109
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)