1 files changed, 75 insertions, 0 deletions
diff --git a/ACE/examples/Reactor/Proactor/README b/ACE/examples/Reactor/Proactor/README
new file mode 100644
index 00000000000..29f2a0b1832
--- /dev/null
+++ b/ACE/examples/Reactor/Proactor/README
@@ -0,0 +1,75 @@
+$Id$
+
+This README file lists all the example applications for the Proactor framework. 
+
+Test/Example Applications for Proactor:
+=========================================
+
+The following tests are available.
+        
+o $ACE_ROOT/tests/Aio_Platform_Test.cpp : Tests basic limits
+        pertaining to the  POSIX features 
+
+o $ACE_ROOT/examples/Reactor/Proactor/test_aiocb.cpp    : 
+        This is a C++ program for testing the AIOCB (AIO Control
+        Blocks) based completion approach which uses <aio_suspend> for
+        completion querying. 
+
+o $ACE_ROOT/examples/Reactor/Proactor/test_aiosig.cpp   : This is a
+        C++ program for testing the Signal based completion approach
+        that uses <sigtimedwait> for completion querying. 
+
+o $ACE_ROOT/examples/Reactor/Proactor/test_aiocb_ace.cpp: Portable
+        version of test_aiocb.cpp. (Same as test_aiocb.cpp, but uses
+        ACE_DEBUGs instead of printf's and ACE_Message_Blocks instead
+        of char*'s. 
+
+o $ACE_ROOT/examples/Reactor/Proactor/test_aiosig_ace.cpp: Portable
+        version of test_aiosig.cpp. (Same as test_aiosig.cpp, but uses
+        ACE_DEBUGs instead of printf's and ACE_Message_Blocks instead
+        of char*'s. 
+
+o test_proactor.cpp (with ACE_POSIX_AIOCB_Proactor)     : Test for
+        ACE_Proactor which uses AIOCB (AIO Control Blocks) based
+        completions strategy Proactor. (#define
+        ACE_POSIX_AIOCB_PROACTOR in the config file, but this is the
+        default option)
+
+o test_proactor.cpp (with ACE_POSIX_SIG_Proactor)     : Test for
+        ACE_Proactor which uses real time signal based completion
+        strategy proactor. (#define ACE_POSIX_SIG_PROACTOR in the
+        config file)
+
+o test_multiple_loops.cpp       : This example application shows how
+        to write programs that combine the Proactor and Reactor event
+        loops. This is possible only on WIN32 platform.
+       
+o test_timeout.cpp      : Multithreaded application testing the Timers
+        mechanism of the Proactor.
+
+o test_timeout_st.cpp   : Single-threaded version of test_timeout.cpp.
+
+o post_completions.cpp  : Tests the completion posting mechanism of
+        the Proactor.  
+
+o test_end_event_loop.cpp : Tests the event loop mechanism of the
+        Proactor. 
+        
+o test_cancel.cpp         : Tests <cancel> interface of the
+        Asynch_Operation class.
+        
+Behavior of POSIX AIO of various platforms:
+==========================================
+
+Sun 5.6 :       POSIX4 Real-Time signals implementation is broken in
+                this platform. 
+                Only POSIX AIOCB Proactor works in this platform.
+                Therefore, it is not possible to use multiple threads
+                with in the framework.
+
+Sun 5.7 :       AIOCB and SIG Proactors work fine.
+
+LynxOS 3.0.0 :  <pthread_sigmask> is not available in this
+                platform. So, only AIOCB Proactor works here. 
+
+