OpenSS7
SS7 for the
Common Man
© Copyright 1997-2007 OpenSS7 Corporation All Rights Reserved.
Last modified: Sun, 05 Mar 2006 08:34:25 GMT
Home Top Index First Prev Next Last More Download Info FAQ Mail  Home -> Documentation -> Man Pages -> SIGTRAN Stack -> TUA
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

SS7 TCAP User Adaptation Layer (TUA)

Description: OpenSS7 Project Manual Pages SIGTRAN Stack


TUA

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

NAME

TUA - SS7 TCAP User Adaptation Layer (TUA)

SYNOPSIS

#include <ss7/tcapi.h>
#include <ss7/tcapi_ioctl.h>
#include <ss7/tua_ioctl.h>

int tua_stream = open(device, flags);
int tua_xtistr = t_open(device, flags);
int tua_socket = socket(PF_SS7, socket_type, SS7PROTO_TUA);

DESCRIPTION

TUA
is an implementation of the SS7 TCAP User Adaptation Layer (TUA)[1]. TUA provides a back haul of the services of tcap(4) over an IP network using Stream Control Transmission Protocol, sctp(4), as defined in RFC 2960[2]. In addition it provides a building block of redundant and distributed SS7 systems. (See ``NOTICES'', below.)

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

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

/dev/tua
This device provides the TCAP protocol service interface using the TR- and TC-primitives of the Transaction Component Interface (TCI) described in tcapi(7). This interface is suitable for use with other SS7 modules and drivers.
/dev/tua-tpi
This device provides the TCAP protocol service interface using the T-primitives of the Transport Provider Interface[4], tpi(7), used for the Transaction Capabilities Application Part as described in tcap_tpi(7). The tpi(7) interface provided on a stream opening this device is a suitable device for use with xnet(3) or xti(3) library t_open(3) call and provides the TCAP interface using XTI[5, 6] as described in xti_tcap(3).

TUA provides three socket types used by the sockets(3) library socket(3) call. TUA provides sockets in the protocol family PF_SS7 using the protocol number SS7PROTO_TUA. The socket_type argument can be one of the following:

SOCK_DGRAM
Provides a connection-less datagram service without regard to order. This is a TCAP operations class 1 or 2 service provider.
SOCK_RDM
Provides a connectiono-less reliable datagram service with regard to order. This is a TCAP operations class 3 or 4 service provider.
SOCK_SEQPACKET
Provides a connection oriented reliable datagram service with or without receipt confirmation and flow control. This is a TCAP operations class 5 service provider.

NOTICES

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

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

IOCTLS

All interfaces support a set of management IO controls using ioctl(2) system calls on the tua_stream, tua_xtistr or tua_socket file descriptor or socket. These management controls are documented in tua_ioctl(4).

In addition, tua supports tcap(4) IO controls. See tcap_ioctl(4).

DEVICES

/dev/tua, /dev/tua-tpi.

FILES

<ss7/tcapi.h>, <ss7/tcapi_ioctl.h>, <ss7/tua_ioctl.h>, <sys/tpi.h>, <sys/tpi_ss7.h>, <sys/tpi_mtp.h>, <sys/tpi_sccp.h>, <sys/tpi_tcap.h>, <xti.h>, <xti_tcap.h>, <sys/socket.h>.

SEE ALSO

ss7confd(8), tcapi(7), tcap_tpi(7), xti_tcap(3), tcao_socket(7), sockets(3), xnet(3), tua_ioctl(4), tcap_ioctl(4).

REFERENCES

[1]
draft-bidulock-sigtran-tua-01.txt, SS7 TCAP-User Adaptation Layer (TUA), January 2, 2003, Brian Bidulock, ed., Internet Engineering Task Force --- Signalling Transport Working Group. Work In Progress. (Expired) <http://www.ietf.org/internet-drafts/draft-bidulock-sigtran-tua-01.txt>
[2]
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>
[3]
LIS 2.18, Linux STREAMS (LiS) 2.18.6 Source Code, Brian Bidulock, ed., OpenSS7 Corporation. <http://www.openss7.org/>
[4]
TPI Revision 2.0.0, Open Group CAE Specification: Transport Provider Interface (TPI) Specification, Revision 2.0.0, Draft 2, 1999, (Berkshire, UK), OpenGroup, Open Group Publication. <http://www.opengroup.org/onlinepubs/>
[5]
XTI/TLI Revision 1.0, Open Group CAE Specification: XOpen Transport Interface, Revision 1, n.d., (Berkshire, UK), XPG, X Programmer's Group. <http://www.opengroup.org/onlinepubs/>
[6]
XNS, Open Group CAE Specification: Technical Standard: Network Services (XNS), Issue 5.2, Draft 2, 1999, (Berkshire, UK), OpenGroup, Open Group Publication. [ISBN 1-85912-241-8] <http://www.opengroup.org/onlinepubs/>

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:29 GMT.

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



Index

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

This document was created by man2html, using the manual pages.
Time: 21:27:29 GMT, November 18, 2008
OpenSS7
SS7 for the
Common Man
Home Top Index First Prev Next Last More Download Info FAQ Mail  Home -> Documentation -> Man Pages -> SIGTRAN Stack -> TUA
Last modified: Sun, 05 Mar 2006 08:34:25 GMT
© Copyright 1997-2007 OpenSS7 Corporation All Rights Reserved.