Manpage of BUA

BUA

Section: OpenSS7 STREAMS SIGTRAN Devices (4)
Updated: 2008-10-31
Index Return to Main Contents

NAME

bua - SS7 BICC User Adaptation Layer (BUA)

SYNOPSIS

#include <ss7/cci.h>
#include <ss7/bicci.h>
#include <ss7/bicci_ioctl.h>
#include <ss7/bua_ioctl.h>

int bicc_stream = open(device, flags);

DESCRIPTION

BUA
is an implementation of the SS7 BICC User Adaptation Layer (BUA) defined in draft-bidulock-sigrran-bua-00.txt. BUA provides a back haul of the services of bicc(4) over an IP network using Stream Control Transmission Protocol, sctp(4), as defined in RFC2960[1]. In addition it provide a building block of redundant and distributed SS7 systems. (See ``NOTICES'', below).

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

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

/dev/bua: This device provides BICC protocol service interface using the Call Control Interface (CCI)[3] described in cci(7), as integrated for use with bicc(4), as described in cci_bicc(7). This interface is suitable both for use with other SS7 modules and drivers, as well as with the cframe(3) library using the OpenSwitch call framework.

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

NOTICES

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

Also, opening and binding a bua stream or socket may result in the opening and binding of a bicc(4) stream on the local or remote host in direct support of the local BICC-User.

IOCTLS

All interfaces support a set of Local Management Interface IO controls using ioctl(2) and I_STR streamio(7) system calls on the bua_stream file descriptor. The common Local Management Interface IO commands are described in lmi_ioctl(4). The management structure and constant definitions for BUA are described in bua_ioctl(4). BUA also supports the BICC IO commands, management structures and contants defined in bicc_ioctl(4).

FILES

<ss7/lmi.h>, <ss7/cci.h>, <ss7/bicci.h>, <ss7/lmi_ioctl.h>, <ss7/bicci_ioctl.h>, <ss7/bua_ioctl.h>.

VERSIONS

The BUA driver is specific to the OpenSS7 SIGTRAN(4) 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-bua-00.txt, SS7 BICC-User Adaptation Layer (BUA), (TBD), Brian Bidulock, ed., Internet Engineering Task Force --- Signalling Transport Working Group. Work In Progress. (Expired) <http://www.ietf.org/internet-drafts/draft-bidulock-sigtran-bua-00.txt>

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.

This document was created by man2html, using the manual pages.
Time: 20:20:39 GMT, May 19, 2013