npi.7.man

来自「This a separate release of the OpenSS7 X」· MAN 代码 · 共 1,041 行 · 第 1/3 页

.IP A. 4
a
.BR N_RESET_REQ (7)
from the NS user, followed by a
.BR N_RESET_CON (7)
from the NS provider;
or
.IP B. 4
a
.BR N_RESET_IND (7)
from the NS provider, followed by a
.BR N_RESET_RES (7)
from the NS user.
.PP
The complete sequence of primitives depends upon the origin/s of the reset
action.  The reset service may be:
.IP 1. 4
invoked by one NS user, leading to interaction (A) with that NS user
and interaction (B) with the peer NS user;
.IP 2. 4
invoked by both NS users, leading to interaction (A) with both NS users;
.IP 3. 4
invoked by the NS provider, leading to interaction (B) with both NS users;
.IP 4. 4
invoked by one NS user and the NS provider, leading to interaction (A) with
the originating NS user and (B) with the peer NS user.
.PP
The
.BR N_RESET_REQ (7)
acts as a synchronization mark in the flow of
.BR N_DATA ,
.BR N_EXDATA ,
and
.B N_DATACK
primitives transmitted by the issuing NS user; the
.BR N_RESET_IND (7)
acts as a synchronization mark in the flow of
.BR N_DATA ,
.BR N_EXDATA ,
and
.B N_DATACK
primitives received by the receiving NS user.  Similarly,
.BR N_RESET_RES (7)
acts as a
synchronization mark in the flow of
.BR N_DATA ,
.BR N_EXDATA ,
and
.B N_DATACK
primitives
transmitted by the responding NS user, while the
.BR N_RESET_CON (7)
acts as a
synchronization mark in the flow of
.BR N_DATA ,
.BR N_EXDATA ,
and
.B N_DATACK
primitives
received by the NS user that originally issued the reset.  The resynchronizing
properties of the reset service are the following:
.IP i. 4
All
.BR N_DATA ,
.BR N_EXDATA ,
and
.B N_DATACK
primitives issued before issuing
the
.BR N_RESET_REQ (7)/ N_RESET_RES (7)
that have not been delivered to the other NS user
before the
.BR N_RESET_IND (7)/ N_RESET_CON (7)
are issued by the NS provider,should be
discarded by the NS provider.
.IP ii. 4
Any
.BR N_DATA ,
.BR N_EXDATA ,
and
.B N_DATACK
primitives issued after the synchronization
mark will not be delivered to the other NS user before the synchronization
mark is received.
.PP
.B User Primitives for Reset Operations
.IP \(em \w'\(em\(em'u
.BR N_RESET_REQ (7):
This primitive requests that the NS provider reset the
network connection.
.IP \(em \w'\(em\(em'u
.BR N_RESET_RES (7):
This primitive indicates to the NS provider that the NS user
has accepted a reset indication.
.PP
.B Provider Primitives for Reset Operations
.IP \(em \w'\(em\(em'u
.BR N_RESET_IND (7):
This primitive indicates to the NS user that the
network connection has been reset.
.IP \(em \w'\(em\(em'u
.BR N_RESET_CON (7):
This primitive indicates to the NS user that the reset request
has been confirmed.
.PP
The sequence of primitives may remain incomplete if a
.B N_DISCON
primitive occurs.
.PP
.B Connection Termination Phase
The NC release procedure is initialized by the insertion of a disconnect
object(associated with a
.BR N_DISCON_REQ) (7)
into the queue.  As shown in Table 3, the disconnect procedure is destructive
with respect to other objects in the queue, and eventually results in the
emptying of queues and termination of the NC connection.
.PP
The sequence of primitives depends on the origin of the release action.  The
sequence may be:
.IP 1. 4
invoked by one NS user, with a request from that NS user leading to an
indication to the other;
.IP 2. 4
invoked by both NS users, with a request from each of the NS users;
.IP 3. 4
invoked by the NS provider, with an indication to each of the NS users;
.IP 4. 4
invoked independently by one NS user and the NS provider, with a request
from the originating NS user and an indication to the other.
.PP
.B User Primitives for Connection Termination
.IP \(em \w'\(em\(em'u
.BR N_DISCON_REQ (7):
This primitive requests that the NS provider deny
an outstanding request for a connection or disconnect an existing connection.
.PP
.B Provider Primitives for Connection Termination
.IP \(em \w'\(em\(em'u
.BR N_DISCON_IND (7):
This primitive indicates to the NS user that either a request
for connection has been denied or an existing connection has been terminated.
.PP
A NS user may reject an NC establishment attempt by issuing a
.BR N_DISCON_REQ (7).
The originator parameter in the
.B N_DISCON
primitives will indicate NS user invoked release.
.PP
If the NS provider is unable to establish an NC, it indicates this to the
requester by an
.BR N_DISCON_IND (7).
The originator in this primitive indicates an NS provider invoked release.
.SS "Connectionless Network Services Definition"
The CLNS allows for the transfer of the NS user data in one or both
directions simultaneously without establishing a network connection.  A set of
primitives are defined that carry user data and control information between
the NS user and NS provider entities.  The primitives are modeled as requests
initiated by the NS user and indications initiated by the NS provider.
Indications may be initiated by the NS provider independently from requests by
the NS user.
.PP
The connectionless network service consists of one phase.
.PP
.B User Request Primitives
.IP \(em \w'\(em\(em'u
.BR N_UNITDATA_REQ (7):
This primitive requests that the NS provider send the data unit to the
specified destination.
.PP
.B Provider Response Primitives
.IP \(em \w'\(em\(em'u
.BR N_UNITDATA_IND (7):
This primitive indicates to the NS user that a data unit has been received
from the specified source address.
.IP \(em \w'\(em\(em'u
.BR N_UDERROR_IND (7):
This primitive indicates to the NS user that the data unit
with the specified destination address and QOS parameters produced an error.
This primitive is specific to CLNS.
.\"
.\"
.\"
.\"
.SS "Local Management"
The following management primitives are common to all modes of network service
provider.
.IP \(em \w'\(em\(em'u
.BR N_INFO_ACK (7):
Requests information concerning the communications device, provider limits,
styles and features.
.IP \(em \w'\(em\(em'u
.BR N_INFO_REQ (7):
Provides information concerning the communications device, provider limits,
styles and features.
.IP \(em \w'\(em\(em'u
.BR N_OPTMGMT_REQ (7):
Requests the management of network provider options.
.IP \(em \w'\(em\(em'u
.BR N_BIND_REQ (7):
Requests the binding of the stream to a network endpoint address.
.IP \(em \w'\(em\(em'u
.BR N_BIND_ACK (7):
Provides acknowledgment of the bound network endpoint address.
.IP \(em \w'\(em\(em'u
.BR N_UNBIND_REQ (7):
Requests the stream be unbound from the bound network endpoint address.
.IP \(em \w'\(em\(em'u
.BR N_OK_ACK (7):
Provides positive acknowledgment of request primitives that require
acknowledgment.
.IP \(em \w'\(em\(em'u
.BR N_ERROR_ACK (7):
Provides negative acknowledgment of request primitives that require
acknowledgment.
.SS "Connectionless Data Transfer"
The following primitives provide for the transfer of data with a
connectionless network service provider.
.IP \(em \w'\(em\(em'u
.BR N_UNITDATA_REQ (7):
Requests the transmission of connectionless data.
.IP \(em \w'\(em\(em'u
.BR N_UNITDATA_IND (7):
Provides indication of the reception of connectionless data.
.IP \(em \w'\(em\(em'u
.BR N_UDERROR_IND (7):
Provides indication of errors encountered in the transmission of
connectionless data.
.SS "Connection Establishment"
The following primitives establish a network connection with a connection
oriented network service provider.
.IP \(em \w'\(em\(em'u
.BR N_CONN_REQ (7):
Requests connection to a peer network endpoint.
.IP \(em \w'\(em\(em'u
.BR N_CONN_CON (7):
Provides confirmation of a connection request.
.IP \(em \w'\(em\(em'u
.BR N_CONN_IND (7):
Provides indication of a connection request from a peer endpoint.
.IP \(em \w'\(em\(em'u
.BR N_CONN_RES (7):
Responds to an outstanding connection indication.
.SS "Connection Data Transfer"
The following primitives provide for the transfer of data with a connection
oriented network service provider.
.PP
.B Data Transfer Service.
The following primitives provide for the transfer of data on the network
connection.
.IP \(em \w'\(em\(em'u
.BR N_DATA_REQ (7):
Requests the transmission of data on a network connection.
.IP \(em \w'\(em\(em'u
.BR N_DATA_IND (7):
Provides indication of the reception of data on a network connection.
.IP \(em \w'\(em\(em'u
.BR N_EXDATA_REQ (7):
Requests the transmission of expedited data on a network connection.
.IP \(em \w'\(em\(em'u
.BR N_EXDATA_IND (7):
Provides indication of the reception of expedited data on a network
connection.
.PP
.B Data Acknowledgment Service.
The following primitives provider for the acknowledgment of data transfer.
.IP \(em \w'\(em\(em'u
.BR N_DATACK_REQ (7):
Requests acknowledgment of the last received data on the network connection.
.IP \(em \w'\(em\(em'u
.BR N_DATACK_IND (7):
Provides indication of acknwowldgment of the last transmitted data on the
network connection.
.SS "Connection Reset"
The following primitives provide for the reset of the network connection.
.IP \(em \w'\(em\(em'u
.BR N_RESET_REQ (7):
Requests that a network connection be reset.
.IP \(em \w'\(em\(em'u
.BR N_RESET_CON (7):
Provides confirmation of the reset of the network connection.
.IP \(em \w'\(em\(em'u
.BR N_RESET_IND (7):
Provides indication of the reset of a network connection.
.IP \(em \w'\(em\(em'u
.BR N_RESET_RES (7):
Responds to an outstanding indication of network connection reset.
.SS "Connection Release"
The following primitives provide for the release of a network connection with
a connection oriented network service provider.
.IP \(em \w'\(em\(em'u
.BR N_DISCON_REQ (7):
Requests that a network connection be released.
.IP \(em \w'\(em\(em'u
.BR N_DISCON_IND (7):
Provides indication that a network connection has been released.
.SH "SEE ALSO"
.BR N_BIND_ACK (7),
.BR N_BIND_REQ (7),
.BR N_CONN_CON (7),
.BR N_CONN_IND (7),
.BR N_CONN_REQ (7),
.BR N_CONN_RES (7),
.BR N_DATACK_IND (7),
.BR N_DATACK_REQ (7),
.BR N_DATA_IND (7),
.BR N_DATA_REQ (7),
.BR N_DISCON_IND (7),
.BR N_DISCON_REQ (7),
.BR N_ERROR_ACK (7),
.BR N_EXDATA_IND (7),
.BR N_EXDATA_REQ (7),
.BR N_INFO_ACK (7),
.BR N_INFO_REQ (7),
.BR N_OK_ACK (7),
.BR N_OPTMGMT_REQ (7),
.BR N_RESET_CON (7),
.BR N_RESET_IND (7),
.BR N_RESET_REQ (7),
.BR N_RESET_RES (7),
.BR N_UDERROR_IND (7),
.BR N_UNBIND_REQ (7),
.BR N_UNITDATA_IND (7),
.BR N_UNITDATA_REQ (7).
.SH HISTORY
.PP
The Network Provider Interface first appeared in SVR 4.
.[
svr4
.]
.SH CONFORMANCE
.PP
This interface conforms to NPI Revision 2.
.[
npi
.]
.XX
.[
magic
.]
.[
advprog
.]
.[
$LIST$
.]
.T2