ChangeLogTag:Thu Sep 4 14:21:33 2003 Gautam H. Thaker <gthaker@atl.lmco.com>

4 files changed, 71 insertions, 37 deletions

diff --git a/ChangeLog b/ChangeLog
index 13671f5ad61..54e2a555d73 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,15 @@
+Thu Sep  4 14:21:33 2003  Gautam H. Thaker  <gthaker@atl.lmco.com>
+
+        * performance-tests/SCTP/README.SCTP: 
+        * performance-tests/SCTP/README.LKSCTP: 
+        * performance-tests/SCTP/README.OpenSS7: 
+
+        Slight update to README files. Made more clear how SCTP 
+        capable kernel and ACE/TAO are built. Due to recent
+        changes in LKSCTP API additional changes will be committed
+        in near future as new Linux kernel with the changes is released.
+
+
 Thu Sep  4 09:56:28 2003  Chad Elliott  <elliott_c@ociweb.com>
 
         * bin/MakeProjectCreator/modules/GNUACEWorkspaceCreator.pm:
diff --git a/performance-tests/SCTP/README.LKSCTP b/performance-tests/SCTP/README.LKSCTP
index bec659352e3..a1c96ff5712 100644
--- a/performance-tests/SCTP/README.LKSCTP
+++ b/performance-tests/SCTP/README.LKSCTP
@@ -6,13 +6,16 @@ Overview
 --------
 
 The LKSCTP project is the Linux Kernel implementation of SCTP.  As of this 
-writing it has been incorporated into the Linux 2.5 development series of
+writing it has been incorporated into the Linux 2.6 test series of
 kernels.   
 
 LKSCTP adheres to the IETF's SCTP Sockets Draft API.  Please refer to that 
 document for API specifics.  
 
-Building ACE with LKSCTP support
+Please be sure to use the latest test kernels.  The API changed at some point
+between Linux 2.5 and Linux 2.6.  
+
+Building ACE/TAO with LKSCTP support
 --------------------------------
 
         - compile kernel with SCTP support
@@ -25,7 +28,7 @@ Building ACE with LKSCTP support
 
         - install header file (sctp.h) into /usr/local/include/sctp.h
 
-        - make ACE with "sctp=lksctp"
+        - make ACE/TAO with "sctp=lksctp"
 
 Caveats
 ---------------------------------
diff --git a/performance-tests/SCTP/README.OpenSS7 b/performance-tests/SCTP/README.OpenSS7
index 33b7f124a5f..5183e872e12 100644
--- a/performance-tests/SCTP/README.OpenSS7
+++ b/performance-tests/SCTP/README.OpenSS7
@@ -20,6 +20,24 @@ total length in bytes of the array.  Also, when accepting connections from a
 peer, you would pass in a pointer to an array of struct sockaddr* and the 
 length of the array in bytes.
 
+
+Building ACE/TAO with support for OpenSS7 SCTP
+==============================================
+
+        - apply OpenSS7's SCTP patch (see OpenSS7's readme for details) 
+
+        - compile kernel with the following kernel variables (.config file)
+                + CONFIG_SCTP=y
+                + CONFIG_SCTP_TCP_COMPATIBLE=y
+                + CONFIG_SCTP_HMAC_SHA1=y
+                + CONFIG_SCTP_HMAC_MD5=y
+                + CONFIG_SCTP_ADLER_32=y
+                + CONFIG_SCTP_CRC_32C=y
+
+        - install header file (sctp.h) into /usr/local/include/sctp.h
+
+        - make ACE/TAO with "sctp=openss7" -- ie. "make sctp=openss7"
+
 Common Calls
 ============
 
diff --git a/performance-tests/SCTP/README.SCTP b/performance-tests/SCTP/README.SCTP
index a72857b6ada..95c3cb0b53a 100644
--- a/performance-tests/SCTP/README.SCTP
+++ b/performance-tests/SCTP/README.SCTP
@@ -1,4 +1,4 @@
-#	$Id$	
+#       $Id$        
 
 This document provides general information about the SCTP protocol.  
 
@@ -11,16 +11,16 @@ transmission of message-oriented applications such as the transportation of
 signaling data for PSTNs (Public Switched Telephone Networks), SCTP can be used
 in any application that uses TCP.  
 
-	Major Features
-	--------------
+        Major Features
+        --------------
 
-	- Direct support for multi-homing
-	- Support for multiple streams per connection (known as associations) 
-	  to reduce "head of line" blocking problems.   
-    	- Four way handshake reducing the possibility for blind denial of
-      	  service attacks.
-    	- Adjustment of congestion control parameters
-    	- Cookie mechanism to protect against "SYN" attacks
+        - Direct support for multi-homing
+        - Support for multiple streams per connection (known as associations) 
+          to reduce "head of line" blocking problems.   
+        - Four way handshake reducing the possibility for blind denial of
+          service attacks.
+        - Adjustment of congestion control parameters
+        - Cookie mechanism to protect against "SYN" attacks
 
 API's
 ========
@@ -35,44 +35,45 @@ The IETF TSVWG (Transport Area Working Group) has published a draft
 the BSD sockets interface.  This interface has made porting TCP applications to
 SCTP as simple as changing one socket call.
 
-	OpenSS7
-	--------
-	OpenSS7 has defined, a similar BSD style sockets interface.  It is 
-	slightly different from the one defined by the IETF, however, at the
- 	time of our evaluation it was the most stable implementation.  
+        OpenSS7
+        --------
+        OpenSS7 has defined, a similar BSD style sockets interface.  It is 
+        slightly different from the one defined by the IETF, however, at the
+        time of our evaluation it was the most stable implementation.  
 
-	Please see README.OpenSS7 for more details.   
+        Please see README.OpenSS7 for details and build instructions.   
 
         LKSCTP
         ------
         The LKSCTP implementation is based on the TSVWG's sockets draft.  
-        It is included with the Linux 2.5 series development kernels.  
+        It is included with the Linux 2.6 series test kernels. Backported
+        (Linux 2.4) patches are also available from the LKSCTP website.  
 
-        Please see README.LKSCTP for more details.  
+        Please see README.LKSCTP for more details and build instructions.  
 
 Resources
 ===========
 
-	RFCs
-	-----
-	RFC2960: Stream Control Transmission Protocol
-	RFC3309: Stream Control Transmission Protocol Checksum Change
+        RFCs
+        -----
+        RFC2960: Stream Control Transmission Protocol
+        RFC3309: Stream Control Transmission Protocol Checksum Change
 
-	Internet-Drafts
-	----------------
-	
-	draft-ietf-tsvwg-sctpsocket-06.txt: 
-		Sockets API Extensions for Stream Control Transmission Protocol
+        Internet-Drafts
+        ----------------
+        
+        draft-ietf-tsvwg-sctpsocket-07.txt: 
+                Sockets API Extensions for Stream Control Transmission Protocol
 
-	draft-ietf-tsvwg-sctpimpguide-08.txt
-		Stream Control Transmission Protocol Implementer's Guide
+        draft-ietf-tsvwg-sctpimpguide-08.txt
+                Stream Control Transmission Protocol Implementer's Guide
 
-	Internet Links
-	---------------
-	IETF: Transport Area Working Group (tsvwg):
-		http://www.ietf.org/html.charters/tsvwg-charter.html
+        Internet Links
+        ---------------
+        IETF: Transport Area Working Group (tsvwg):
+                http://www.ietf.org/html.charters/tsvwg-charter.html
 
-	The OpenSS7 Project: http://www.openss7.org/sctp.html
+        The OpenSS7 Project: http://www.openss7.org/sctp.html
 
         The LKSCTP Project: http://lksctp.sourceforge.net/