ChangeLogTag: Sun Mar 4 11:06:25 2001 Frank Hunleth <fhunleth@cs.wustl.edu>

4 files changed, 100 insertions, 47 deletions

diff --git a/TAO/ChangeLogs/ChangeLog-02a b/TAO/ChangeLogs/ChangeLog-02a
index ac580d975d1..8cd56f85085 100644
--- a/TAO/ChangeLogs/ChangeLog-02a
+++ b/TAO/ChangeLogs/ChangeLog-02a
@@ -1,3 +1,13 @@
+Sun Mar  4 11:06:25 2001  Frank Hunleth  <fhunleth@cs.wustl.edu>
+
+	* examples/PluggableUDP/README:
+	* examples/PluggableUDP/DIOP/README:
+	  Added infomation about DIOP and PluggableUDP directories.
+
+	* examples/PluggableUDP/tests/README:
+	  Moved some information about the implementation of DIOP into the
+	  ../DIOP/README file.
+
 Sun Mar  4 10:03:59 2001  Frank Hunleth  <fhunleth@cs.wustl.edu>
 
 	* examples/PluggableUDP/tests/server.cpp:
diff --git a/TAO/examples/PluggableUDP/DIOP/README b/TAO/examples/PluggableUDP/DIOP/README
new file mode 100644
index 00000000000..a009ee80cc0
--- /dev/null
+++ b/TAO/examples/PluggableUDP/DIOP/README
@@ -0,0 +1,70 @@
+DIOP - UDP Based Pluggable Protocol
+===================================
+
+This directory contains all of the code needed to use the UDP
+Pluggable Protocol (DIOP).  It should be considered a work in progress
+and will eventually be integrated in with the other standard pluggable
+protocols in tao/Strategies.
+
+Notes on the DIOP implementation:
+
+- The DIOP implemenation uses unconnected UDP sockets.
+
+- The server side implementation bypasses the actual TAO acceptor
+  and opens always a UDP socket on start-up.
+
+- The address of that UDP socket can be configured via
+  e.g. -ORBEndpoint diop://:1303
+
+  If nothing is specified, the implementation will select a port
+  and open a socket on all network interfaces.
+  (This is the default ORB behavior and can be overwritten using
+   the -ORBEndpoint switch)
+
+- Because no connections - no state - exist, all client requests
+  from different clients arrive at the same socket!
+
+- The client side DIOP implementation bypasses the actual
+  TAO connector. It installs a connection handler on the first
+  invocation on a remote CORBA object.
+
+
+DIOP Installation:
+
+- Compile TAO/examples/PluggableUDP/DIOP to create the DIOP library.
+
+- Uncomment the following line in TAO/tao/corbafwd.h:
+
+  #define TAO_TAG_UDP_PROFILE    0x54414f04U /* UDP */
+
+- The application using DIOP should have a svc.conf file with the
+  following entry:
+
+  dynamic DIOP_Factory Service_Object * TAO_DIOP:_make_TAO_DIOP_Protocol_Factory() ""
+  static Resource_Factory "-ORBProtocolFactory DIOP_Factory"
+
+
+Issues:
+
+- Optimization of DIOP_Transport::{send,recv}
+
+- Default port is the same on client and server, therefore
+  the client ports need to be explicitly set by -ORBEndpoint option.
+  Maybe there is a way to find free ports?
+
+- Remove commented out code from DIOP_* files.
+
+
+Appendix:
+
+ The client understands the following options:
+                           -d
+                           -k <ior>
+                           -t <timeout in ms>
+                           -i <iterations>
+
+Comments, Suggestions, or Feedback:
+
+  mailto:Michael.Kircher@mchp.siemens.de or,
+  mailto:John.Mackenzie.extern@icn.siemens.de or,
+  mailto:fhunleth@cs.wustl.edu
diff --git a/TAO/examples/PluggableUDP/README b/TAO/examples/PluggableUDP/README
new file mode 100644
index 00000000000..67801d874a6
--- /dev/null
+++ b/TAO/examples/PluggableUDP/README
@@ -0,0 +1,14 @@
+This directory contains code for a pluggable UDP protocol for TAO.
+The individual directories contain READMEs on how to run the following
+examples:
+
+        . DIOP
+
+          Contains the implementation of the UDP pluggable protocol.
+          Code in this directory should be considered a work in
+          progress and will be added to tao/Strategies in the future.
+
+        . tests
+
+          This directory contains unit tests to exercise the DIOP
+          code.
diff --git a/TAO/examples/PluggableUDP/tests/README b/TAO/examples/PluggableUDP/tests/README
index 888293cf2a4..ec008493401 100644
--- a/TAO/examples/PluggableUDP/tests/README
+++ b/TAO/examples/PluggableUDP/tests/README
@@ -33,52 +33,10 @@ Persistent IOR test:
     this can be achieved by e.g. "-ORBEndpoint diop://:1233"
 
 
-DIOP Implemenation:
+DIOP Installation and Implemenation:
 
-- The DIOP implemenation uses unconnected UDP sockets.
-
-- The server side implementation bypasses the actual TAO acceptor
-  and opens always a UDP socket on start-up.
-
-- The address of that UDP socket can be configured via
-  e.g. -ORBEndpoint diop://:1303
-
-  If nothing is specified, the implementation will select a port
-  and open a socket on all network interfaces.
-  (This is the default ORB behavior and can be overwritten using
-   the -ORBEndpoint switch)
-
-- Because no connections - no state - exist, all client requests
-  from different clients arrive at the same socket!
-
-- The client side DIOP implementation bypasses the actual
-  TAO connector. It installs a connection handler on the first
-  invocation on a remote CORBA object.
-
-
-DIOP Installation:
-
-- Compile TAO/examples/PluggableUDP/DIOP to create the DIOP library.
-
-- Uncomment the following line in TAO/tao/corbafwd.h:
-
-  #define TAO_TAG_UDP_PROFILE    0x54414f04U /* UDP */
-
-- The application using DIOP should have a svc.conf file with the following entry:
-
-  dynamic DIOP_Factory Service_Object * TAO_DIOP:_make_TAO_DIOP_Protocol_Factory() ""
-  static Resource_Factory "-ORBProtocolFactory DIOP_Factory"
-
-
-Issues:
-
-- Optimization of DIOP_Transport::{send,recv}
-
-- Default port is the same on client and server, therefore
-  the client ports need to be explicitly set by -ORBEndpoint option.
-  Maybe there is a way to find free ports?
-
-- Remove commented out code from DIOP_* files.
+  Please see the $TAO_ROOT/examples/PluggableUDP/DIOP/README file for
+  more information.
 
 
 Appendix:
@@ -91,5 +49,6 @@ Appendix:
 
 Comments, Suggestions, or Feedback:
 
-  mailto:Michael.Kircher@mchp.siemens.de  or,
-  mailto:John.Mackenzie.extern@icn.siemens.de
+  mailto:Michael.Kircher@mchp.siemens.de or,
+  mailto:John.Mackenzie.extern@icn.siemens.de or,
+  mailto:fhunleth@cs.wustl.edu