Links

GitHub

Open HUB

Quick Links

Download

STREAMS

SIGTRAN

SS7

Hardware

SCTP

Related

Package

Manual

Manual Pages

References

Conformance

Documentation

FAQ

OS

LDL

strinet

strsctp

DDI/DKI

STREAMS

Kernel

XTI

SOCKSYS

Sockets

TPI

NPI

DLPI

CDI

NLI

LLI

WAN

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

Communications Device Interface (CDI)

Description: OpenSS7 Project Manual Pages CDI


CDI

Section: Communications Device Interface (CDI) (7)
Updated: 2008-10-31
Index Return to Main Contents

NAME

CDI - Communications Device Interface

SYNOPSIS

#include <sys/cdi.h>

OVERVIEW


The Communications Device Interface (CDI) is a low-level device interface that is defined between a user and a provider using STREAMS(4) and the putmsg(2) and getmsg(2) system calls.

DESCRIPTION

Local Manaement Primitives

The following management primitives are common to all styles of communication providers and devices.
CD_INFO_REQ(7)
Requests information concerning the communications device, provider limits, styles and features.
CD_INFO_ACK(7)
Provides information concerning the communications device, provider limits, styles and features.
CD_ATTACH_REQ(7)
Requests that a Style 2 communications device provider be attached to the speciifed physical point of appearance (PPA).
CD_DETACH_REQ(7)
Requests that a Style 2 communications device provider be detached from the attached physical point of appearance (PPA).
CD_OK_ACK(7)
Provides positive acknowledgment of request primitives that require acknowledgment.
CD_ERROR_ACK(7).
Provides negative acknowledgment of request primitives that require acknowledgment.

Device Connection Primitives

The following primitves enable and disable the communications device for transmission.
CD_ENABLE_REQ(7)
Requests that the communications device be enabled on the attached physical point of appearance and with an optional dial string.
CD_ENABLE_CON(7)
Provides confirmation of the CD_ENABLE_REQ(7) primitive.
CD_DISABLE_REQ(7)
Requests that the communications device be disabled on the attached physical point of appearance.
CD_DISABLE_CON(7).
Provides confirmation of the CD_DISABLE_REQ(7) primitive.

Device Data Transfer Primitives

The following primitives provide for the indication of errors associated with received or transmitted data.

CD_ERROR_IND(7)
Provides indication of an error in the input or output section.
CD_BAD_FRAME_IND(7)
Provides indication of a frame received in error.

The following primitives provide for the reception of data.

CD_READ_REQ(7)
Requests that the communications device read received data within the timeout specified, and then convert the input section to output.
CD_ALLOW_INPUT_REQ(7)
Requests that the input section be enabled until the next CD_HALT_INPUT_REQ(7).
CD_HALT_INPUT_REQ(7)
Requests that the input section be disabled until the next CD_ALLOW_INPUT_REQ(7).
CD_UNITDATA_IND(7)
Provides indication of received data.

The following primitives provide for the transmission of data.

CD_UNITDATA_REQ(7)
Requests the transmission of data.
CD_UNITDATA_ACK(7)
Acknowledges the transmission of data or provides timing clues for paced output.
CD_ABORT_OUTPUT_REQ(7)
Aborts the output of data.

The following primitives provide for the synchronized transmission and reception of data on half-duplex communications devices.

CD_WRITE_READ_REQ(7).
Requests that a combination of write and read be performed.

Leads and Signals

The following primitives provide the CD user with the ability to manage modem leads and signals.
CD_MODEM_SIG_IND(7)
Provides an indication of the current state of leads and signals.
CD_MODEM_SIG_POLL(7)
Requests that the communications device provider reply with a CD_MODEM_SIG_IND(7) indicating the current state of modem leads and signals.
CD_MODEM_SIG_REQ(7)
Requests that the specified leads and signals be asserted or deasserted.

Miscellaneous

CD_MUX_NAME_REQ(7) Not documented.

SEE ALSO

CD_ABORT_OUTPUT_REQ(7), CD_ALLOW_INPUT_REQ(7), CD_ATTACH_REQ(7), CD_BAD_FRAME_IND(7), CD_DETACH_REQ(7), CD_DISABLE_CON(7), CD_DISABLE_REQ(7), CD_ENABLE_CON(7), CD_ENABLE_REQ(7), CD_ERROR_ACK(7), CD_ERROR_IND(7), CD_HALT_INPUT_REQ(7), CD_INFO_ACK(7), CD_INFO_REQ(7), CD_MODEM_SIG_IND(7), CD_MODEM_SIG_POLL(7), CD_MODEM_SIG_REQ(7), CD_MUX_NAME_REQ(7), CD_OK_ACK(7), CD_READ_REQ(7), CD_UNITDATA_ACK(7), CD_UNITDATA_IND(7), CD_UNITDATA_REQ(7), CD_WRITE_READ_REQ(7).

HISTORY

The Communications Device Interface first appeared in SVR 4[1].

CONFORMANCE

This interface conforms to CDI with Gcom extensions.

REFERENCES

[1]
SVR 4, UNIX® System V Release 4 Programmer's Manual, 1990, (Englewood Cliffs, New Jersey), AT&T UNIX System Laboratories, Inc., Prentice Hall.
[2]
Magic Garden, The Magic Garden Explained: The Internals of UNIX® System V Release 4 / An Open Systems Design, 1994, (Australia), B. Goodheart, J. Cox, Prentice Hall. [ISBN 0-13-098138-9]
[3]
Advanced Programming in the UNIX®Environment, 15th edition, December 1997, (Reading, Massachusetts), W. R. Stevens, Addison Wesley. [ISBN 0-201-56317-7]

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 XNS Networking: Package strxns version 0.9.2.7 released 2008-10-31.

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



Index

NAME
SYNOPSIS
OVERVIEW
DESCRIPTION
Local Manaement Primitives
Device Connection Primitives
Device Data Transfer Primitives
Leads and Signals
Miscellaneous
SEE ALSO
HISTORY
CONFORMANCE
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 13:18:31 GMT, November 12, 2014
Last modified: Sun, 05 Mar 2006 08:34:06 GMT  
Copyright © 2014 OpenSS7 Corporation All Rights Reserved.