DLPI Programmer's Guide

118 Chapter 2
DLPI Primitives
Connection-mode Service Primitives
Parameters
dl_primitive
DL_TOKEN_ACK
dl_token
connection response token associated with the stream. This value
must be a non-zero value. The DLS provider will generate a token
value for each stream upon receipt of the first DL_TOKEN_REQ
primitive issued on that stream. The same token value will be
returned in response to all subsequent DL_TOKEN_REQ primitives
issued on a stream.
State
The message is valid in any state in response to a DL_TOKEN_REQ.
New State
The resulting state is unchanged.
DL_DATA_REQ
Conveys a complete DLS Data Unit (DLSDU) from the DLS user to the
DLS provider for transmission over the data link connection.
Format
The message consists of one or more M_DATA message blocks containing
at least one byte of data.
State
The message is valid in state DL_DATAXFER. If it is received in state
DL_IDLE or DL_PROV_RESET_PENDING, it should be discarded
without generating an error.
New State
The resulting state is unchanged.
Response
If the request is valid, no response is generated. If the request is
erroneous, a STREAMS M_ERROR message should be issued to the DLS
user specifying an errno value of EPROTO. This action should be
interpreted as a fatal, unrecoverable, protocol error. A request is
considered erroneous under the following conditions.