diff options
-rw-r--r-- | TAO/ChangeLog-98c | 5 | ||||
-rw-r--r-- | TAO/performance-tests/Cubit/TAO/MT_Cubit/README | 104 | ||||
-rw-r--r-- | TAO/tests/Cubit/TAO/MT_Cubit/README | 104 |
3 files changed, 159 insertions, 54 deletions
diff --git a/TAO/ChangeLog-98c b/TAO/ChangeLog-98c index ac75514e1c6..8db18e688cc 100644 --- a/TAO/ChangeLog-98c +++ b/TAO/ChangeLog-98c @@ -1,3 +1,8 @@ +Wed Jun 17 17:07:12 1998 Sergio Flores <sergio@polka.cs.wustl.edu> + + * tests/Cubit/TAO/MT_Cubit/README: Updated the options and + explanation of the options. + Wed Jun 17 16:58:26 1998 Michael Kircher <mk1@cs.wustl.edu> * orbsvcs/tests/start_services: Moved this file form diff --git a/TAO/performance-tests/Cubit/TAO/MT_Cubit/README b/TAO/performance-tests/Cubit/TAO/MT_Cubit/README index a31165c83f2..b19e1f43a23 100644 --- a/TAO/performance-tests/Cubit/TAO/MT_Cubit/README +++ b/TAO/performance-tests/Cubit/TAO/MT_Cubit/README @@ -12,57 +12,103 @@ VxWorks-specific instructions for building the client. You can either run the server in the background in the same window as the client or open a separate window for the client and server. -server: + +Options ------- +Options are case sensitive, e.g., "-U" has a different meaning than "-u". + + +(1) server: + +./server [-p <port_num>] /* starting port */ + [-h <my_hostname>] /* IP address to use */ + [-t <number_of_servants>] /* # of servant threads to create */ + [-s ] /* Do NOT use the naming service */ + [-f <ior_file> ] /* specify a file to output all ior's */ + [-m ] /* Use multiple priorities for threads */ + [-U ] /* Run the server utilization test */ + /* use the same option on the client */ + [-r ] /* Run the thread-per-rate test */ + +[-p <port_num>] is the port number at which the server will start the + first (and highest priority) servant. Successive servants will be + created starting at (port_num+1). The -t parameter specifies the total + number of servants. + + Default Value: ACE_DEFAULT_SERVER_PORT /* see $ACE/ace/OS.h for actual number value */ + +[-h <my_hostname>] indicates the IP address the ORB should bind to. + This is useful when a machine has more than one network interface. + + Default Value: Whatever ACE_OS::hostname () returns, which depends on the platform. + +[-t <number_of_servants>] tells the server how many servants to create. + + Default Value: 2 + +[-s ] Disables the use of the naming service to register the servants. + + Default Value: Use naming service enabled. -./server -p <port_num> -h <my_hostname> -t <number_of_servants> +[-f <ior_file> ] Use to specify a file to write all the iors from the + different servants out to disk. -port_num is the port number at which the server will start the first -(and highest priority) servant. Successive servants (with successively -lower priorities) will be created starting at (port_num+1). The -n -parameter specifies the total number of servants. + Default Value: nil, which means not to write the iors to disk. + +[-m ] For the 1 to n low priority servants, this parameter indicates + the use of a range of priorities for the threads. + + Default Value: Disabled. One priority will be used for the + low priority threads. + +[-U ] Run the server utilization test. This option overrides the "-t" + option. This option sets the number threads to one. NOTE: to use + this option successfully, you should also use "-U" on the client + side. + + Default Value: Disabled. To enable, specify "-U" on the + command line. The server will print the IOR of the servants, but it is not required by the client. -client: -------- + + +(2) client: ./client [-ORBobjrefstyle url] - [-p <port_num>] - [-h <server_hostname>] [-d <datatype>] [-n <num_calls>] [-t <num_of_clients>] - [-r] + [-f <ior_file>] + [-r] // use thread-per-rate test. + [-u] // run the client utilization test + [-U] // run the servant utilization test + [-1] // use one to n test. + [-o] // makes client use oneway calls instead + [-x] // makes a call to servant to shutdown + [-g] // choose the granularity of timing calls + [-c] // obtain number of context switches. + [-s] // makes client *NOT* use the name service + [-m] // use multiple priorities for the low priority client. [-ORBobjrefstyle url] Makes the IOR appear in URL format instead of that ugly number sequence format. -<port_num> is the port number of the highest priority servant and - should be the same as the port_num supplied to the server, as - described earlier. The lower priority servant is assumed to be at - (port_num+1). - -<server_hostname> is the hostname of the server. - - Based on the server_hostname and the port_num, the client - automatically constructs the IOR's for the servants - -<datatype> is one of the following: +[-d <datatype>] <datatype> is one of the following: 0 Octet 1 Short 2 Long 3 Struct of the above 3 types -<num_calls> is the number of CORBA twoway calls to be made +[-n <num_calls>] is the number of CORBA twoway calls to be made -<num_of_clients> is the total number of concurrent clients to be +[-t <num_of_clients>] is the total number of concurrent clients to be created. The clients will have successively decreasing - priorities. + priorities if "-m" is specified. -[-r] this option can be used to turn on the thread-per-rate tests. +[-r] turn on the thread-per-rate tests. [-o] enables oneway calls instead of two-way calls. The oneway call is a noop call (for now). @@ -70,10 +116,14 @@ client: [-x] makes the client call the shutdown() method on the servant which invokes the shutdown() method on the ORB and causes it to exit. + +VXWORKS specifics +----------------- + To build the client for VxWorks, for running the server and client on a single target: - % make BIN=client ACELIB= LDLIBS="$ACE_ROOT/ace/.obj/High_Res_Timer.o $ACE_ROOT/ace/.obj/gethrtime.o" + % make BIN=client ACELIB= LDLIBS="$ACE_ROOT/ace/.obj/High_Res_Timer.o $ACE_ROOT/ace/.obj/gethrtime.o $ACE/ace/.obj/Stats.o $ACE/ace/.obj/Log_Msg.o" To run the server and client on a single target: diff --git a/TAO/tests/Cubit/TAO/MT_Cubit/README b/TAO/tests/Cubit/TAO/MT_Cubit/README index a31165c83f2..b19e1f43a23 100644 --- a/TAO/tests/Cubit/TAO/MT_Cubit/README +++ b/TAO/tests/Cubit/TAO/MT_Cubit/README @@ -12,57 +12,103 @@ VxWorks-specific instructions for building the client. You can either run the server in the background in the same window as the client or open a separate window for the client and server. -server: + +Options ------- +Options are case sensitive, e.g., "-U" has a different meaning than "-u". + + +(1) server: + +./server [-p <port_num>] /* starting port */ + [-h <my_hostname>] /* IP address to use */ + [-t <number_of_servants>] /* # of servant threads to create */ + [-s ] /* Do NOT use the naming service */ + [-f <ior_file> ] /* specify a file to output all ior's */ + [-m ] /* Use multiple priorities for threads */ + [-U ] /* Run the server utilization test */ + /* use the same option on the client */ + [-r ] /* Run the thread-per-rate test */ + +[-p <port_num>] is the port number at which the server will start the + first (and highest priority) servant. Successive servants will be + created starting at (port_num+1). The -t parameter specifies the total + number of servants. + + Default Value: ACE_DEFAULT_SERVER_PORT /* see $ACE/ace/OS.h for actual number value */ + +[-h <my_hostname>] indicates the IP address the ORB should bind to. + This is useful when a machine has more than one network interface. + + Default Value: Whatever ACE_OS::hostname () returns, which depends on the platform. + +[-t <number_of_servants>] tells the server how many servants to create. + + Default Value: 2 + +[-s ] Disables the use of the naming service to register the servants. + + Default Value: Use naming service enabled. -./server -p <port_num> -h <my_hostname> -t <number_of_servants> +[-f <ior_file> ] Use to specify a file to write all the iors from the + different servants out to disk. -port_num is the port number at which the server will start the first -(and highest priority) servant. Successive servants (with successively -lower priorities) will be created starting at (port_num+1). The -n -parameter specifies the total number of servants. + Default Value: nil, which means not to write the iors to disk. + +[-m ] For the 1 to n low priority servants, this parameter indicates + the use of a range of priorities for the threads. + + Default Value: Disabled. One priority will be used for the + low priority threads. + +[-U ] Run the server utilization test. This option overrides the "-t" + option. This option sets the number threads to one. NOTE: to use + this option successfully, you should also use "-U" on the client + side. + + Default Value: Disabled. To enable, specify "-U" on the + command line. The server will print the IOR of the servants, but it is not required by the client. -client: -------- + + +(2) client: ./client [-ORBobjrefstyle url] - [-p <port_num>] - [-h <server_hostname>] [-d <datatype>] [-n <num_calls>] [-t <num_of_clients>] - [-r] + [-f <ior_file>] + [-r] // use thread-per-rate test. + [-u] // run the client utilization test + [-U] // run the servant utilization test + [-1] // use one to n test. + [-o] // makes client use oneway calls instead + [-x] // makes a call to servant to shutdown + [-g] // choose the granularity of timing calls + [-c] // obtain number of context switches. + [-s] // makes client *NOT* use the name service + [-m] // use multiple priorities for the low priority client. [-ORBobjrefstyle url] Makes the IOR appear in URL format instead of that ugly number sequence format. -<port_num> is the port number of the highest priority servant and - should be the same as the port_num supplied to the server, as - described earlier. The lower priority servant is assumed to be at - (port_num+1). - -<server_hostname> is the hostname of the server. - - Based on the server_hostname and the port_num, the client - automatically constructs the IOR's for the servants - -<datatype> is one of the following: +[-d <datatype>] <datatype> is one of the following: 0 Octet 1 Short 2 Long 3 Struct of the above 3 types -<num_calls> is the number of CORBA twoway calls to be made +[-n <num_calls>] is the number of CORBA twoway calls to be made -<num_of_clients> is the total number of concurrent clients to be +[-t <num_of_clients>] is the total number of concurrent clients to be created. The clients will have successively decreasing - priorities. + priorities if "-m" is specified. -[-r] this option can be used to turn on the thread-per-rate tests. +[-r] turn on the thread-per-rate tests. [-o] enables oneway calls instead of two-way calls. The oneway call is a noop call (for now). @@ -70,10 +116,14 @@ client: [-x] makes the client call the shutdown() method on the servant which invokes the shutdown() method on the ORB and causes it to exit. + +VXWORKS specifics +----------------- + To build the client for VxWorks, for running the server and client on a single target: - % make BIN=client ACELIB= LDLIBS="$ACE_ROOT/ace/.obj/High_Res_Timer.o $ACE_ROOT/ace/.obj/gethrtime.o" + % make BIN=client ACELIB= LDLIBS="$ACE_ROOT/ace/.obj/High_Res_Timer.o $ACE_ROOT/ace/.obj/gethrtime.o $ACE/ace/.obj/Stats.o $ACE/ace/.obj/Log_Msg.o" To run the server and client on a single target: |