Manpage of N_EDATA

N_EDATA

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

NAME

N_EData - Expedited Data

INTERFACE

Network Layer Interface (NLI)[1], nli(7).

SYNOPSIS

#include <netx25/x25_proto.h>
struct xedataf {
    unsigned char xl_type;
    unsigned char xl_command;
};

DESCRIPTION

The Expedited Data message primitive, N_EData, is used to transfer expedited NS user data to or from the NS user. The control part of the message consists of one M_PROTO(9) message block, and contains the xedataf structure. The data part of the message consists of one or more M_DATA(9) message blocks containing the local or remote expedited NS user data (ENSDU).

The Expedited Data message primitive, N_EData, is used when expedited data, carried by an X.25 interrupt packet, corsses the X.25 NLI service interface from NS provider to user or NS user to provider. The Expedited Data message is a confirmed primitive and must be acknowledged before another expedited data unit can be requested or indicated.

FORMAT

The Expedited Data message uses the xedataf structure. The control part of the message consists of one M_PROTO(9) message block, and contains the xedataf structure. The data part of the message consists of one or more M_DATA(9) message blocks containing the local or remote expedited NS user data (ENSDU).

MEMBERS

The xedataf structure contains the following members:

xl_type: Always XL_DAT.
xl_command: Always N_EData.

STATE

This message primitive is only valid during the data transfer phase.

RESPONSE

When NS user or provider issues this primtive it expectes an Expedited Data Acknowledgement message primitive in reponse. The Expedited Data message is a confirmed primitive and must be acknowledged before another expedited data unit can be requested or indicated.

USAGE

The Expedited Data message primitive is equivalent to the N_EXDATA_REQ(7) and N_EXDATA_IND(7) primitives of the Network Provider Interface (NPI)[2], npi(7).

NOTICES

The Network Layer Interface (NLI) is a proprietary interface without a formal standard. Either the Network Provider Interface (NPI)[2], npi(7), or the XTI-X25 interface[3], xti_x25(3), should be used in its stead.

FILES

N_EData is defined in the <netx25/x25_proto.h> file.

COMPATIBILITY

N_EData is compatible with NLI, and implementations based on NLI such as Solaris Solstice® X.25 9.2[4], IRIX SX.25[5], HP-UX X.25/9000, PT X.25[6], with the following considerations:

---: Solaris Solstice® X.25 9.2[4], IRIX SX.25[5], PT X.25[6], are consistent in their documentation of N_EData.
---: NLI is an inherently low level and non-portable interface and should not be used by portable programs. Portable programs should use the NPI or XX25 interfaces in its stead.
---: Binary compatibility is not attempted: only a rough source compatibility. Any binary compatibility exhibited is a bug and is scheduled to be removed in the next release.

See NLI(7), STREAMS(4), for additional compatiblity considerations.

CONFORMANCE

The NLI is not a formal standard. The OpenSS7tm implementation of NLI conforms to documentation for Version 3 of the NLI.

HISTORY

The NLI is an interface originally developed by Spider Systems, Ltd. (now a division of Emmerson Power). The NLI interface found its way into may mainstream UNIX implementations and UNIX-like RTOS sporting STREAMS such as Windriver's VxWorks. The NLI was never standardized and remains an inherently non-portable interface.

VERSIONS

This manual page was written for the OpenSS7tm implementation of X.25.

REFERENCES

[1]: NLI, OpenSS7 CAE Specification: Network Layer Interface (NLI) Specification, Revision 0.9.2, Draft 1, July 15, 2008, (Edmonton, Canada), B. Bidulock, OpenSS7 Corporation. Distributed with package strx25-0.9.2. <http://www.openss7.org/specs/nli.pdf>
[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]: C411 (XX25), X/Open CAE Specification: X.25 Programming Interface using XTI (XX25), November 1995, (Berkshire, UK), X/Open, Open Group Publication. [ISBN: 1-85912-136-5] <http://www.opengroup.org/onlinepubs/>
[4]: Solstice® X.25, Solstice® X.25 9.2 Programming Guide, October 1999, (Palo Alto, California), Sun Microsystems, Inc., Sun. [Part No: 806-1235-10] <http://docs-pdf.sun.com/>
[5]: IRIX® SX.25, SX.25 NLI Programming's Guide, 1994, (Mountainview, California), Silicon Graphics, Inc., SGI Technical Publications. [Doc. No: 007-2268-002] <http://techpubs.sgi.com/>
[6]: PT X.25, X.25 Protocol User's Manual, 2007, (Rochester, New York), Performance Technologies Inc., PT.

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 X.25 Networking: Package strx25 version 0.9.2.1 released 2008-10-31.

Index

NAME
INTERFACE
SYNOPSIS
DESCRIPTION
FORMAT
MEMBERS
STATE
RESPONSE
USAGE
NOTICES
FILES
SEE ALSO
COMPATIBILITY
CONFORMANCE
HISTORY
VERSIONS
REFERENCES
TRADEMARKS
IDENTIFICATION

This document was created by man2html, using the manual pages.
Time: 15:25:17 GMT, May 18, 2013