cdi.h

OpenSS7 This the fourth public release of the OpenSS7 Master Package. See README in the release for

/*****************************************************************************

 @(#) cdi.h,v 0.9.2.4 2007/02/13 14:05:28 brian Exp

 -----------------------------------------------------------------------------

 Copyright (c) 2001-2007  OpenSS7 Corporation <http://www.openss7.com/>
 Copyright (c) 1997-2001  Brian F. G. Bidulock <[e-mail]>

 All Rights Reserved.

 This program is free software; you can redistribute it and/or modify it under
 the terms of the GNU General Public License as published by the Free Software
 Foundation; version 2 of the License.

 This program is distributed in the hope that it will be useful, but WITHOUT
 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
 details.

 You should have received a copy of the GNU General Public License along with
 this program; if not, write to the Free Software Foundation, Inc., 675 Mass
 Ave, Cambridge, MA 02139, USA.

 -----------------------------------------------------------------------------

 U.S. GOVERNMENT RESTRICTED RIGHTS.  If you are licensing this Software on
 behalf of the U.S. Government ("Government"), the following provisions apply
 to you.  If the Software is supplied by the Department of Defense ("DoD"), it
 is classified as "Commercial Computer Software" under paragraph 252.227-7014
 of the DoD Supplement to the Federal Acquisition Regulations ("DFARS") (or any
 successor regulations) and the Government is acquiring only the license rights
 granted herein (the license rights customarily provided to non-Government
 users).  If the Software is supplied to any unit or agency of the Government
 other than DoD, it is classified as "Restricted Computer Software" and the
 Government's rights in the Software are defined in paragraph 52.227-19 of the
 Federal Acquisition Regulations ("FAR") (or any successor regulations) or, in
 the cases of NASA, in paragraph 18.52.227-86 of the NASA Supplement to the FAR
 (or any successor regulations).

 -----------------------------------------------------------------------------

 Commercial licensing and support of this software is available from OpenSS7
 Corporation at a fee.  See http://www.openss7.com/

 -----------------------------------------------------------------------------

 Last Modified 2007/02/13 14:05:28 by brian

 -----------------------------------------------------------------------------

 cdi.h,v
 Revision 0.9.2.4  2007/02/13 14:05:28  brian
 - corrected ulong and long for 32-bit compat

 *****************************************************************************/

#ifndef _SYS_CDI_H
#define _SYS_CDI_H

#ident "@(#) cdi.h,v openss7-0_9_2_E(0.9.2.4) Copyright (c) 2001-2007 OpenSS7 Corporation."

/* This file can be processed by doxygen(1). */

/*
 * cdi.h header for Communications Device Interface
 *
 * Copyright (c) 1989 NCR Comten
 *
 * This file distributed by Gcom, Inc with permission of NCR Comten
 */

/*
 * Primitives for Local Management Services
 */
#define CD_INFO_REQ		0x00	/* Information request */
#define CD_INFO_ACK		0x01	/* Information acknowledgement */
#define CD_ATTACH_REQ		0x02	/* Attach a PPA */
#define CD_DETACH_REQ		0x03	/* Detach a PPA */
#define CD_ENABLE_REQ		0x04	/* Prepare a device */
#define CD_DISABLE_REQ		0x05	/* Disable a device */
#define CD_OK_ACK		0x06	/* Success acknowledgement */
#define CD_ERROR_ACK		0x07	/* Error acknowledgement */
#define CD_ENABLE_CON		0x08	/* Enable confirmation */
#define CD_DISABLE_CON		0x09	/* Disable confirmation */
#define CD_ERROR_IND		0x0a	/* Error indication */

/*
 * Primitives used for Data Transfer
 */
#define CD_ALLOW_INPUT_REQ	0x0b	/* Allow input */
#define CD_READ_REQ		0x0c	/* Wait-for-input request */
#define CD_UNITDATA_REQ		0x0d	/* Data send request */
#define CD_WRITE_READ_REQ	0x0e	/* Write/read request */
#define CD_UNITDATA_ACK		0x0f	/* Data send acknowledgement */
#define CD_UNITDATA_IND		0x10	/* Data receive indication */
#define CD_HALT_INPUT_REQ	0x11	/* Halt input */
#define CD_ABORT_OUTPUT_REQ	0x12	/* Abort output */
#define CD_MUX_NAME_REQ		0x13	/* get mux name (Gcom) */
#define CD_BAD_FRAME_IND	0x14	/* frame w/error (Gcom extension) */
#define CD_MODEM_SIG_REQ	0x15	/* Assert modem signals (Gcom) */
#define CD_MODEM_SIG_IND	0x16	/* Report modem signal state (Gcom) */
#define CD_MODEM_SIG_POLL	0x17	/* requests a CD_MODEM_SIG_IND (Gcom) */

/*
 * CDI device states
 */
#define CD_UNATTACHED		0x00	/* No PPA attached */
#define CD_UNUSABLE		0x01	/* PPA cannot be used */
#define CD_DISABLED		0x02	/* PPA attached */
#define CD_ENABLE_PENDING	0x03	/* Waiting ack of enable req */
#define CD_ENABLED		0x04	/* Awaiting use */
#define CD_READ_ACTIVE		0x05	/* Input section enabled; disabled after data arrives */
#define CD_INPUT_ALLOWED	0x06	/* Input section permanently enabled */
#define CD_DISABLE_PENDING	0x07	/* Waiting ack of disable req */
#define CD_OUTPUT_ACTIVE	0x08	/* Output section active only */
#define CD_XRAY			0x09	/* Xray-ing another ppa */
#define CD_NOT_AUTH		0x0A	/* Not authorized, unusable */

/*
 * CD_ERROR_ACK and CD_ERROR_IND error return values
 */
#define CD_BADADDRESS		0x01	/* Address was invalid */
#define CD_BADADDRTYPE		0x02	/* Invalid address type */
#define CD_BADDIAL		0x03	/* Dial information was invalid */
#define CD_BADDIALTYPE		0x04	/* Invalid dial information type */
#define CD_BADDISPOSAL		0x05	/* Invalid disposal parameter */
#define CD_BADFRAME		0x06	/* Defective SDU received */
#define CD_BADPPA		0x07	/* Invalid PPA identifier */
#define CD_BADPRIM		0x08	/* Unrecognized primitive */
#define CD_DISC			0x09	/* Disconnected */
#define CD_EVENT		0x0a	/* Protocol-specific event occurred */
#define CD_FATALERR		0x0b	/* Device has become unusable */
#define CD_INITFAILED		0x0c	/* Line initialization failed */
#define CD_NOTSUPP		0x0d	/* Primitive not supported by this device */
#define CD_OUTSTATE		0x0e	/* Primitive was issued from an invalid state */
#define CD_PROTOSHORT		0x0f	/* M_PROTO block too short */
#define CD_READTIMEOUT		0x10	/* Read request timed out before data arrived */
#define CD_SYSERR		0x11	/* UNIX system error */
#define CD_WRITEFAIL		0x12	/* Unitdata request failed */

/*
 * Error explanations
 */
#define CD_CRCERR		0x01	/* CRC or FCS error */
#define CD_DLE_EOT		0x02	/* DLE EOT detected */
#define CD_FORMAT		0x03	/* Format error detected */
#define CD_HDLC_ABORT		0x04	/* Aborted frame detected */
#define CD_OVERRUN		0x05	/* Input overrun */
#define CD_TOOSHORT		0x06	/* Frame too short */
#define CD_INCOMPLETE		0x07	/* Partial frame received */
#define CD_BUSY			0x08	/* Telephone was busy */
#define CD_NOANSWER		0x09	/* Connection went unanswered */
#define CD_CALLREJECT		0x0a	/* Connection rejected */
#define CD_HDLC_IDLE		0x0b	/* HDLC line went idle */
#define CD_HDLC_NOTIDLE		0x0c	/* HDLC line no longer idle */
#define CD_QUIESCENT		0x0d	/* Line being reassigned */
#define CD_RESUMED		0x0e	/* Line has been reassigned */
#define CD_DSRTIMEOUT		0x0f	/* Did not see DSR in time */
#define CD_LAN_COLLISIONS	0x10	/* LAN excessive collisions */
#define CD_LAN_REFUSED		0x11	/* LAN message refused */
#define CD_LAN_NOSTATION	0x12	/* LAN no such station */
#define CD_LOSTCTS		0x13	/* Lost Clear to Send signal */
#define CD_DEVERR		0x100	/* Start of device-specific codes */

/*
 * CDI device classes
 */
#define CD_HDLC			0x00	/* Bit-synchronous */
#define CD_BISYNC		0x01	/* Character-synchronous */
#define CD_LAN			0x02	/* ISO 8802-3,4,5 local-area network MAC */
#define CD_NODEV		0x03	/* no device, ppa used for X-ray */

/*
 * CDI duplex types
 */
#define CD_FULLDUPLEX		0x00	/* Full duplex; allow input supported */
#define CD_HALFDUPLEX		0x01	/* Half duplex; read and write/read supported */

/*
 * CDI output styles
 */
#define CD_UNACKEDOUTPUT	0x00	/* No unitdata acknowledgements */
#define CD_ACKEDOUTPUT		0x01	/* Unitdata acknowledgements */
#define CD_PACEDOUTPUT		0x02	/* Unitdata acks as output timing hints */

/*
 * CDI optional features
 */
#define CD_CANREAD	0x01	/* Read request supported on full duplex */
#define CD_CANDIAL	0x02	/* Dial information supported */
#define CD_AUTOALLOW	0x04	/* CD_INPUT_ALLOWED as soon as enabled */
#define CD_KEEPALIVE	0x08	/* Gcom: Don't send off at CD_DISABLE_REQ */

/*
 * CDI provider style.
 * The CDI provider style which determines whether a provider
 * requires a CD_ATTACH_REQ to inform the provider which PPA
 * user messages should be sent/received on.
 */
#define CD_STYLE1	0x00	/* PPA is implicitly bound by open(2) */
#define CD_STYLE2	0x01	/* PPA must be explicitly bound via CD_ATTACH_REQ */
#define CD_STYLE_1	CD_STYLE1	/* Gcom -- to match document */
#define CD_STYLE_2	CD_STYLE2	/* Gcom -- to match document */

/*
 * Symbolic value for "no dialing information"
 */
#define CD_NODIAL	0x00

/*
 * Actions to take with undelivered data in a CD_DISABLE_REQ or
 CD_HALT_INPUT_REQ
 */
#define CD_FLUSH	0x00	/* Discard undelivered data */
#define CD_WAIT 	0x01	/* Attempt to deliver unsent data */
#define CD_DELIVER	0x02

/*
 * Address types
 */
#define CD_SPECIFIC	0x00	/* Specific address follows */
#define CD_BROADCAST	0x01	/* Broadcast; no address follows */
#define CD_IMPLICIT	0x02	/* No address or embedded address */

/*
 * Error types for CD_BAD_FRAME_IND
 */

#define CD_FRMTOOLONG	0xFFFF	/* frame overflowed rcv bfr */
#define CD_FRMNONOCTET	0xFFFE	/* frame not octet-aligned */
#define CD_EMPTY_BFR	0xFFFD	/* empty rcv buffer (not used) */
#define CD_BAD_CRC	0xFFFC	/* CRC error */
#define CD_FRM_ABORTED	0xFFFB	/* frame aborted */
#define CD_RCV_OVERRUN	0xFFFA	/* receive overrun */

/*
 * Modem signal bits for modem signal related requests and indications
 */
#define CD_DTR		0x01
#define CD_RTS		0x02
#define CD_DSR		0x04
#define CD_DCD		0x08
#define CD_CTS		0x10
#define CD_RI		0x20

/*
 * CDI interface primitive definitions.
 *
 * Each primitive is sent as a Stream message.  It is possible that
 * the messages may be viewed as a sequence of bytes that have the
 * following form without any padding. The structure definition
 * of the following messages may have to change depending on the
 * underlying hardware architecture and crossing of a hardware
 * boundary with a different hardware architecture.
 *
 * Each message has the name defined followed by the
 * Stream message type (M_PROTO, M_PCPROTO, M_DATA)
 */

typedef int32_t cd_long;
typedef u_int32_t cd_ulong;
typedef u_int16_t cd_ushort;

/*
 *      LOCAL MANAGEMENT PRIMITIVES
 */