summaryrefslogtreecommitdiff
path: root/TAO/tests/Stack_Recursion/README
diff options
context:
space:
mode:
Diffstat (limited to 'TAO/tests/Stack_Recursion/README')
-rw-r--r--TAO/tests/Stack_Recursion/README38
1 files changed, 38 insertions, 0 deletions
diff --git a/TAO/tests/Stack_Recursion/README b/TAO/tests/Stack_Recursion/README
index cc202fc7c40..419e6cf040f 100644
--- a/TAO/tests/Stack_Recursion/README
+++ b/TAO/tests/Stack_Recursion/README
@@ -2,6 +2,44 @@
@page Stack_Recursion Test README File
+
+Begin Comment added August 14, 2007 <wilsond@ociweb.com>
+The original README starts below.
+
+The name of this test is misleading. See the bugzilla entry below for a
+historical justification of the name.
+
+It is a test of the throughput for replies to a clients CORBA requests.
+
+The client starts 8 tasks (aka threads.) Each task calls the ping method
+100 times. Ping is a nop method on the server. Presumably sending these
+pings opens one or more connections to the server. The actual number of
+connections varies from test run to test run.
+
+After that the client calls the get_data method 1000 times. Each call
+returns a sequence of octets containing 1048576 bytes (1Mb). The test
+succeeds if these replys are received by the client in 960 seconds
+(16 minutes).
+
+A successful test executes 8800 CORBA calls in 16 minutes (550 calls a
+minute = 9+ calls/second) and returns 8000 megabytes (500 megabytes/minute
+= 8.3 megabytes/second) via a local host connection.
+
+A typical failure for this test is a client timeout at the end of 16 minutes.
+This can happen if the test system is too slow or heavily loaded to handle
+this much data (including the necessary mallocs & frees (16M per call), or
+if there is a significant bottleneck or hang in the ORB. Because the test
+is sensitive to other loads on the test system, the results will be intermittent.
+
+8 tasks is hardcoded in client.cpp
+100 pings is hardcoded in Client_Task.cpp
+1000 calls to get_data is hardcoded in client.cpp
+1Mb per get_data call is hardcoded in client.cpp.
+960 seconds is hard coded in run_test.pl
+
+End Comment added August 14, 2007 <wilsond@ociweb.com>
+
+
A stress test for the stack recursion outlined in the bugzilla
under id 1125. Here is the link for the bug