$Id: README 94590 2011-10-05 13:46:45Z johnnyw $

This directory provides programs that measure the round trip latency
of synchronous octet messaging using ACE wrapper-facades for the SCTP
protocol. Currently these programs provide the only example code on
how to use ACE's wrapper-facades for SCTP. In the future additional
code will be placed in the ACE_wrappers/examples/IPC_SAP/SOCK_SAP
directory.

SOCK_STREAM_clt and SOCK_STREAM_srv use the SOCK_STREAM service
provided by SCTP via ACE's SOCK_Connector, SOCK_Stream,
SOCK_Association wrapper-facade classes.

SOCK_SEQPACK_clt and SOCK_SEQPACK_srv use the SOCK_SEQPACKET service
provided by SCTP via ACE's SOCK_SEQPACK_Connector,
SOCK_SEQPACK_Association and SOCK_SEQPACK_Acceptor wrapper-facade
classes.

The following table provides a summary of relationships between two main
Linux SCTP implementations (OpenSS7 and LKSCTP), and ACE Wrapper Facades
support that is provided. Built on top of the ACE Wrapper Facade support is
the SCIOP support in TAO. SCIOP works identically on both OpenSS7 and
LKSCTP implementations. Please read additional README* files listed below.

-------------------------------------------------------------------------------
    SCTP      Transport          Transport                ACE
   Protocol    Service            Service               Wrapper
    Impl.       Type           Characteristics          Facades
 ------------------------------------------------------------------------------
 OpenSS7     SOCK_SEQPACKET    {Connected,      ACE_SOCK_SEQPACKET_Acceptor
                                Reliable,       ACE_SOCK_SEQPACKET_Connector
                                Messages}       ACE_SOCK_SEQPACKET_Association

 OpenSS7      SOCK_STREAM      {Connected,      ACE_SOCK_Acceptor(IPPROTO_SCTP)
                                Reliable,       ACE_SOCK_Connector(IPPROTO_SCTP)
                                Byte Stream}    ACE_SOCK_Stream(IPPROTO_SCTP)

 OpenSS7       SOCK_RDM        {Connectionless,      NOT IMPLEMENTED IN ACE
                                Reliable,
                                Messages}


 LKSCTP      SOCK_SEQPACKET    {Connectionless,         NOT USED IN ACE
                                UNRELIABLE,
                                Messages}

 LKSCTP      SOCK_STREAM      {Connected,       ACE_SOCK_SEQPACKET_Acceptor
                                Reliable,       ACE_SOCK_SEQPACKET_Connector
                                Messages}       ACE_SOCK_SEQPACKET_Association
                                                ACE_SOCK_Acceptor(IPPROTO_SCTP)
                                                ACE_SOCK_Connector(IPPROTO_SCTP)
                                                ACE_SOCK_Stream(IPPROTO_SCTP)


Additional information can be found in the following README files also
located in this directory.

 README.SCTP - Brief description of the major features and benefits
               SCTP protocol and references for further information.

 README.SCTP_in_ACE - Description of the wrapper-facade classes that
                      ACE provides to use SCTP, general usage
                      guidance, release notes, technical point of
                      contact information.

 README.SCTP_PERF_TEST - Detailed description on how to use the
                         performance tests and the run_spectrum.pl
                         script contained in this directory.
                         Discussion of the baseline performance
                         results obtained by LM ATL.

 THANKS - Documents all the people who contributed to the development
          of the ACE wrapper-facades for SCTP and the SCIOP (SCTP
          Inter-ORB Protocol) for TAO. Information on that can be
          found in ACE_wrappers/TAO/tao/Strategies/README.SCIOP

General requests for information beyond what is contained in these
files can be sent to either of the following individuals.

Patrick Lardieri plardier@atl.lmco.com
Gautam Thaker    gthaker@atl.lmco.com

This work was sponsored by DARPA/IXO PCES Program.
