SS7 ISUP User Adaptation Layer (ISUA)

ISUA

Section: The OpenSS7 Project Devices (4)
Updated: Tue, 18 Nov 2008 21:27:24 GMT
Index Return to Main Contents

NAME

ISUA - SS7 ISUP User Adaptation Layer (ISUA)

SYNOPSIS

#include <ss7/cci.h>
#include <ss7/isupi.h>
#include <ss7/isupi_ioctl.h>
#include <ss7/isua_ioctl.h>

int isua_stream = open(device, flag);

DESCRIPTION

ISUA
is an implementation of the SS7 ISUP User Adaptation Layer (ISUA) defined in draft-bidulock-sigtran-isua-01.txt. ISUA provides a back haul of the serivces of isup(4) over an IP network using Stream Control Transmission Protocol, sctp(4), as defined in RFC 2960[1]. In addition it provides a building block of redundant and distributed SS7 systems. (See ``NOTICES'', below.)

ISUA is implemented as a STREAMS(4) multiplexing driver for LiS(9)[2]. isup(4), bicc(4) or sctp(4) streams are linked under the ISUA multiplexing driver using the I_LINK or I_PLINK commands of streamio(7), to provide transport or direct ISUP services to ISUA. Once linked, the streams must be configured using isua_ioctl(4). This procedure is normally performed by the SS7 Configuration Daemon, ss7confd(8).

ISUA provides the following stream types that are directly compatible with the stream types provided by isup(4). To select one of these stream types, device can be selected from the following:

/dev/isua: This device provides ISUP protocol service interfce using the Call Control Interface (CCI)[3] described in cci(7). This interface is suitable for use with other SS7 modules and drivers, as well as with user-level programs such as the cframe(3) library using the OpenSwitch call framework.

NOTICES

Unlike other SS7 protocol modules and drivers providing transport services, ISUA does not provide a sockets(3) interface. This is because the special needs of call control are divorced from the sockets paradigm.

ISUA can be configured on a system as a drop in transparent replacement for isup(4). In such a configuration, users opening streams or sockets as defined in isup(4) will be opening isua streams and sockets, but will be unaware of the difference. In OpenSS7, isua is used as the primary mechanism of redundancy and distribution at the ISUP level, and, when properly configured (see ss7confd(8)), isua functions transparently to the ISUP-User.

Also, opening and binding a isua stream or socket may result in the opening and binding of an isup (4) stream on the local or remote host in direct support of the local ISUP-User.

IOCTLS

All interfaces support a set of management IO controls using ioctl(2) system call on the isua_stream file descriptor or socket. These management controls are documented in isua_ioctl(4).

In addition, isua supports isup(4) IO controls. See isup_ioctl(4).

FILES

<ss7/cci.h>, <ss7/isupi.h>, <ss7/isupi_ioctl.h>, <ss7/isua_ioctl.h>, <sys/tpi.h>, <sys/tpi_ss7.h>, <sys/tpi_mtp.h>, <sys/tpi_isup.h>, <xti.h>, <xti_isup.h>, <sys/socket.h>.

DEVICES

/dev/isua.

VERSIONS

The ISUA driver is specific to the OpenSS7 stack. This is Version 2 of the interface.

REFERENCES

[1]: RFC 2960, Stream Control Transmission Protocol (SCTP), October 2000, Randall R. Stewart, ed., The Internet Society. (Obsoleted by RFC 4960) (Updated by RFC 3309) (Status: PROPOSED STANDARD) <http://www.ietf.org/rfc/rfc2960.txt>
[2]: LIS 2.18, Linux STREAMS (LiS) 2.18.6 Source Code, Brian Bidulock, ed., OpenSS7 Corporation. <http://www.openss7.org/>
[3]: CCI Revision 1.0.0, Call Control Interface (CCI) Specification, Draft 1, April 2003, (Edmonton), B. Bidulock, OpenSS7 Corporation. <http://www.openss7.org/docs/cci.pdf>
[4]: draft-bidulock-sigtran-isua-04.txt, SS7 ISUP-User Adaptation Layer (ISUA), February 3, 2007, Brian Bidulock, ed., Internet Engineering Task Force --- Signalling Transport Working Group. Work In Progress. <http://www.ietf.org/internet-drafts/draft-bidulock-sigtran-isua-04.txt>
[5]: ITU-T Recommendation Q.761, Signalling System No. 7 --- Functional Description of the ISDN User Part, March 1993, (Geneva), ITU, ITU-T Telecommunication Standardization Sector of ITU. (Previously "CCITT Recommendation") <http://www.itu.int/rec/T-REC-Q.761/>
[6]: ITU-T Recommendation Q.762, Signalling System No. 7 --- General Function of Messages and Signals of the ISDN User Part, March 1993, (Geneva), ITU, ITU-T Telecommunication Standardization Sector of ITU. (Previously "CCITT Recommendation") <http://www.itu.int/rec/T-REC-Q.762/>
[7]: ITU-T Recommendation Q.763, Signalling System No. 7 --- Formats and Codes of the ISDN User Part, March 1993, (Geneva), ITU, ITU-T Telecommunication Standardization Sector of ITU. (Previously "CCITT Recommendation") <http://www.itu.int/rec/T-REC-Q.763/>
[8]: ITU-T Recommendation Q.764, Signalling System No. 7 --- ISDN User Part Signalling Procedures, March 1993, (Geneva), ITU, ITU-T Telecommunication Standardization Sector of ITU. (Previously "CCITT Recommendation") <http://www.itu.int/rec/T-REC-Q.764/>

TRADEMARKS

OpenSS7tm: is a trademark of OpenSS7 Corporation.
Linux®: is a registered trademark of Linus Torvalds.
UNIX®: is a registered trademark of The Open Group.
Solaris®: is a registered trademark of Sun Microsystems.

Other trademarks are the property of their respective owners.

IDENTIFICATION

The OpenSS7 Project: Package OpenSS7 version 0.9.2 released Tue, 18 Nov 2008 21:27:24 GMT.

This document was created by man2html, using the manual pages.
Time: 21:27:24 GMT, November 18, 2008