DLPI Programmer's Guide

Chapter 2 105

DLPI Primitives

Connection-mode Service Primitives

The message is valid in the states DL_IDLE, DL_DATAXFER,

DL_OUTCON_PENDING, DL_INCON_PENDING,

DL_USER_RESET_PENDING, and DL_PROV_RESET_PENDING.

New State

The resulting state is unchanged.

Response

If the speciﬁed dl_ack_thresh is valid and the primitive was issued from

a valid state, the DLS provider responds with a DL_OK_ACK. Otherwise

a DL_ERROR_ACK is returned.

Reasons for Failure

DL_OUTSTATE

Primitive was issued from an invalid state.

DL_SYSERR

If the speciﬁed dl_ack_thresh is greater than the remote receive

window size, then a DL_ERROR_ACK with dl_errno set to

DL_SYSERR and dl_unix_errno set to EINVAL is returned.

DL_HP_SET_LOCAL_WIN_REQ

Requests the DLS provider to set the local window size to the speciﬁed

value.

NOTE Setting the local window size also causes the DLPI read side streams

queue hi water mark to be set to (local_window_size * MTU). The

(local_window_size * MTU) cannot exceed (1 << 16) - (2 * MTU).

Format

typedef struct {

u_long dl_primitive;

u_long dl_local_win;

} dl_hp_set_local_win_req_t;

Parameters

dl_primitive

DL_HP_SET_LOCAL_WIN_REQ

dl_local_win