DLPI Programmer's Guide

106 Chapter 2

DLPI Primitives

Connection-mode Service Primitives

size of the local receive window. This value must be greater than 0

and less than 128.

State

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_local_win 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_local_win is invalid, then a DL_ERROR_ACK with

dl_errno set to DL_SYSERR and dl_unix_errno set to EINVAL is

returned.

DL_HP_SET_REMOTE_WIN_REQ

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

value.

NOTE Setting the remote window size causes the ack thresh to be set to

((remote_window_size + 1) / 2).

Format

typedef struct {

u_long dl_primitive;

u_long dl_remote_win;

} dl_hp_set_remote_win_req_t;

Parameters

dl_primitive