SS7 ISUP User Adaptation Layer (ISUA)
Description: OpenSS7 Project Manual Pages SIGTRAN Stack
ISUA
Section: OpenSS7 STREAMS SIGTRAN Devices (4)
Updated: 2008-10-31
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.
SEE ALSO
SS7(4),
ss7confd(8),
cci(7),
isupi(7),
isup_tpi(7),
isup_xti(7),
isup_socket(7),
sockets(3),
xnet(3),
isua_ioctl(4),
isup_ioctl(4).
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
-
OpenSS7 STREAMS SIGTRAN: Package sigtran version 0.9.2.4 released 2008-10-31.
Copyright©1997-2008OpenSS7 Corp.
All Rights Reserved.
(See roff source for permission notice.)
Index
- NAME
- SYNOPSIS
- DESCRIPTION
- NOTICES
- IOCTLS
- FILES
- DEVICES
- SEE ALSO
- VERSIONS
- REFERENCES
- TRADEMARKS
- IDENTIFICATION
This document was created by
man2html,
using the manual pages.
Time: 03:33:47 GMT, November 15, 2024