  =========================================================================
  
  @(#) $Id: README,v 0.7.4.3 2001/02/18 09:58:23 brian Exp $
  
  =========================================================================
  
  This README is Copyright (C) 1997-2001 Brian Bidulock.
  
  All Rights Reserved.
  
  Permission is granted to make and distribute verbatim copies of this
  README file provided the copyright notice and this permission notice are
  preserved on all copies.
  
  Permission is granted to copy and distribute modified versions of this
  manual under the conditions for verbatim copying, provided that the
  entire resulting derived work is distributed under the terms of a
  permission notice identical to this one
  
  Since the Linux kernel and libraries are constantly changing, this README
  file may be incorrect or out-of-date.  The author(s) assume no
  responsibility for errors or omissions, or for damages resulting from the
  use of the information contained herein.  The author(s) may not have
  taken the same level of care in the production of this manual, which is
  licensed free of charge, as they might when working professionally.
  
  Formatted or processed versions of this manual, if unaccompanied by the
  source, must acknowledge the copyright and authors of this work.
  
  =========================================================================
  
  Modified $Date: 2001/02/18 09:58:23 $ by $Author: brian $
  
  =========================================================================



                        ++++++++++++++++++++++++++
                        OPENSS7 for STREAMS README
                        ++++++++++++++++++++++++++

    Welcome to the OpenSS7 package for LiS STREAMS.
    
    This is a pre-alpha release and is partially operational.  It provides a
    fully operational (and Q.781 conforming) Signalling Data Link UDP
    Emulation (sdludp) which emulates an SS7 Signalling Data Link with Linux
    UDP sockets within the driver.  The first actual hardware driver (ACB56)
    has not been made operational for this release, but the source is included
    for illustration.

    The purpose of this release has been to place a partially working
    snapshot of the development code base into the hands of a few people
    that are interested in contributing to or building towards the
    development path of the OpenSS7 Project.  This release also provides the
    test-q781 test program which demonstrates Q.781 conformance of the SDL UDP
    driver (effectively verifying the SL, SDT and SDL mdoules).

    This release also provides fully operational (and Q.781 tested) pushable
    STREAMS modules for the following components:

        sdl -   Signalling Data Link
        sdt -   Signalling Data Terminal
        sl  -   Signalling Link

    There is non-operational (under development) code for the following
    STREAMS muxes:

        sls -   Signalling Link Set
        mtp -   Message Transfer Part

    For more information on the STREAMS design approach for OpenSS7, see the
    website at http://www.openss7.org/.

    You will find INSTALATION INSTRUCTIONS in the top-level directory (along
    with this file) in the file named "INSTALL".  You will find the
    licensing terms (GPL) in the file named "LICENSE".  The Linux Software
    Map entry is in the file LSM.

    For an example of how to (or perhaps how no to) write user-level
    applications, see the test programs in the strss7-0.7.4/test/
    directory.
