N_EXDATA_REQ

Section: Network Provider Interface (NPI) (7)
Updated: 2008-10-31
Index Return to Main Contents

NAME

N_EXDATA_REQ, N_exdata_req_t - expedited data transfer request

DESCRIPTION

This is a NS user originated primitive and is used to indicate to the network provider that the message block contains an ENSDU.

SYNOPSIS

The format of the message is one M_PROTO(9) message block, followed by one or more M_DATA(9) blocks. The NS user must send an integral number of octets of data within the range supported by the NS provider (see N_INFO_ACK(7)). The structure of the M_PROTO(9) message block is as follows:

typedef struct {
    ulong PRIM_type;  /* always N_EXDATA_REQ */
} N_exdata_req_t;

PARAMETERS

PRIM_type: Indicates the primitive type.

STATE

This primitive is valid in state NS_DATA_XFER.

NEW STATE

The resulting state remains the same (NS_DATA_XFER).

RESPONSE

This primitive does not require any acknowledgemnts, although it may generate a fatal (unrecoverable) error. This is indicated via an M_ERROR STREAMS message type (issued to the NS user with the errno(3) value of EPROTO), which results in the failure of all system calls on that stream.

ERRORS

The applicable errors are as follows:

[EPROTO]: This indicates one of the following unrecoverable protocol conditions:
-: The network interface was found to be in an incorrect state.
-: The amount of NS user data associated with the primitive defines an expedited network service data unit of a size that is outside the range supported by the NS provider.
-: Expedited data transfer is either not supported by the NS provider or not requested with the N_CONN_REQ(7) primitive.

Note: If the interface is in the NS_IDLE or NS_WRES_RIND states when the provider receives the N_EXDATA_REQ primitive, then the NS provider should discard the request without generating a fatal error.

HISTORY

The Network Provider Interface first appeared in SVR 4[1].

CONFORMANCE

This interface conforms to NPI Revision 2[2].

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]: NPI, Open Group CAE Specification: Network Provider Interface (NPI) Specification, Revision 2.0.0, Draft 2, August 17, 1992, (Parsippany, New Jersey), UNIXInternational,Inc., UNIX International Press. <http://www.openss7.org/docs/npi.pdf>
[3]: 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]
[4]: 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.

This document was created by man2html, using the manual pages.
Time: 01:22:01 GMT, June 20, 2013

Description: Manual Page

Keywords: ss7 ss7/ip ss7 over ip ss7 mtp ss7 sccp ss7 tcap sigtran mtp sccp tcap openss7 acb56 linux telephony pstn linux telephony linux nebs linux compactpci