1 files changed, 82 insertions, 0 deletions
diff --git a/ACE/tests/README b/ACE/tests/README
new file mode 100644
index 00000000000..17476a3ae5e
--- /dev/null
+++ b/ACE/tests/README
@@ -0,0 +1,82 @@
+$Id$
+
+This directory contains a battery of tests that exercise many
+capabilities of ACE on the numerous platforms upon which it runs.  In
+addition to providing an automated regression testing facility, these
+tests also illustrate how to program many of the ACE features.  The
+tests can be executed in a single pass via the perl script
+run_test.pl.
+
+By default, all the output from the tests will be stored in separate
+files in the ./log/ (or .\log\) directory.  However, you can override
+this by setting the ACE_TEST_DIR environment variable to another
+prefix.
+
+________________________________________
+
+Please follow these directions when adding a new test to
+$ACE_ROOT/tests:
+
+1.  Use appropriate ACE_START_TEST and ACE_END_TEST macros in main ()
+
+2.  Add new project entry to the tests.mpc file.
+
+3.  Add test to Makefile. *
+
+4.  Add a new MS project file, e.g., <test>.dsp, then add and entry for 
+    it to the tests.dsw file. *
+
+5.  Add test to run_test.lst.
+
+* Steps 3 and 4 will go away once the mpc architecture is fully integrated,
+  since the Makefile and project files can be created on-the-fly by mpc.
+________________________________________
+
+
+The tests have been run on a wide range of platforms (e.g., UNIX,
+pSOS, VxWorks, LynxOS, Windows NT/2000/95/98/etc.) and they all work
+with the following exceptions:
+
+1. UPIPE_Test and SPIPE_Test on Windows 95: these tests don't run on
+   Windows 95 since Windows 95 does not support the server side
+   functionality of accepting connections from clients using named pipes.
+
+2. Proactor_Test (to be added) on Windows 95: this test does not run on
+   Windows 95 since Windows 95 does not support I/O completion ports.
+
+3. Of the tests (believed) relevant to the single threaded port to pSOSim,
+   Sigset_Ops_Test, Sock_Connector_Test, Priority_Reactor_Test,
+   Process_Strategy_Test, and Service_Config_Test are still failing.
+   These are being debugged and will either be corrected or, if there
+   are unsupported features in these tests, removed from the test suite for
+   pSOSim.
+
+4. The set of tests for pSOSim will be expanded to include those that require
+   multiple threads, with the release of the multi-threaded port to pSOSim.
+
+Notes:
+
+1. Each test creates a log file and writes it to the ./log/
+   directory. The default log directory can be changed in the test_config.h
+   file.
+
+2. Each log file contains a time stamp of when the test began and also
+   a time stamp indicating when the test ended. If the ending time stamp
+   is missing, you can assume that the test did not succeed.
+
+3. None of the tests require any command line parameters. This is in
+   accordance with the keeping the test-suite a "one-button" test. If
+   any of the tests require any variable parameters these are
+   specified in test_config.h.
+
+4. Time_Service_Test executes the Time Server and Clerk components as
+   two processes and so the executable "main" need to be present in
+   the netsvcs/servers directory.  Be sure you build
+   $ACE_ROOT/netsvcs/lib/ and $ACE_ROOT/netsvcs/servers before running
+   this test.  These components rely on config files. Two sample
+   config files are also present in the test-suite, namely
+   UNIXserver.conf and UNIXclerk.conf (and for Win32, Win32server.conf
+   and Win32clerk.conf).
+
+If you have any questions/suggestions, please send email to
+ace-users@cs.wustl.edu.