OpenSS7
SS7 for the
Common Man
© Copyright 1997-2007 OpenSS7 Corporation All Rights Reserved.
Last modified: Sun, 05 Mar 2006 08:34:05 GMT
Home Top Index FirstPrev Next Last More Download Info FAQ Mail  Home -> Documentation -> Man Pages -> SIGTRAN Stack -> BUA
Quick Links

Download

SCTP

SIGTRAN

SS7

Hardware

STREAMS

Asterisk

Related

Package

Manual

Manual Pages

References

Conformance

Performance

Documentation

Design

Status

FAQ

SIGTRAN Stack

BUA

ISUA

TUA

SUA

M3UA

M2UA

IUA

TALI

UA LM

Man Pages

Applications

SS7 Stack

ISDN Stack

SIGTRAN Stack

VoIP Stack

MG Stack

SS7/ISDN Devices

IP Transport

Embedded Systems

OS

Documentation

FAQ

SIGTRAN

Design

Conformance

Performance

References

Man Pages

Manuals

Papers

Home

Overview

Status

Documentation

Resources

About

News

BICC User Adaptation Layer (BUA)

Description: OpenSS7 Project Manual Pages SIGTRAN Stack


BUA

Section: The OpenSS7 Project Devices (4)
Updated: Mon, 08 Dec 2008 13:00:52 GMT
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>.

SEE ALSO

lmi(7), lmi_ioctl(4), bua_ioctl(4), bicc_ioctl(4), cci(7), cci_bicc(7).

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

The OpenSS7 Project: Package OpenSS7 version 0.9.2 released Mon, 08 Dec 2008 13:00:52 GMT.

Copyright©1997-2008OpenSS7 Corp.
All Rights Reserved.
(See roff source for permission notice.)



Index

NAME
SYNOPSIS
DESCRIPTION
NOTICES
IOCTLS
FILES
SEE ALSO
VERSIONS
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 13:00:51 GMT, December 08, 2008
OpenSS7
SS7 for the
Common Man
Home Top Index FirstPrev Next Last More Download Info FAQ Mail  Home -> Documentation -> Man Pages -> SIGTRAN Stack -> BUA
Last modified: Sun, 05 Mar 2006 08:34:05 GMT
© Copyright 1997-2007 OpenSS7 Corporation All Rights Reserved.