Home » HP Manuals » Servers » HP 800 » Manual Viewer

HP 800 HP DLPI Programmer's Guide - Page 57

Local Management Primitives, PPA Initialization and De-initialization

Add to My Manuals
Save this manual to your list of manuals

Page 57 highlights

Chapter 2 DLPI Primitives Local Management Primitives Local Management Primitives This section describes the local management service primitives. These primitives support the information reporting, Attach, and Bind. Once a stream has been opened by a DLS user, these primitives initialize the stream, preparing it for use. PPA Initialization and De-initialization The PPA associated with each stream must be initialized before the DLS provider can transfer data over the medium. The initialization and de-initialization of the PPA is a network management issue, but DLPI must address the issue because of the impact such actions have on a DLS user. More specifically, DLPI requires the DLS provider to initialize the PPA associated with a stream at some point before it completes the processing of the DL_BIND_REQ. Guidelines for initialization and de-initialization of a PPA by a DLS provider are presented here. A DLS provider may initialize a PPA using one of the following methods: • Preinitialized by some network management mechanism before the DL_BIND_REQ is received • Automatic initialization on receipt of a DL_BIND_REQ or DL_ATTACH_REQ A specific DLS provider may support either of these methods, or possibly combination of the two, but the method implemented has no impact on the DLS user. From the DLS user's viewpoint, the PPA is guaranteed to be initialized on receipt of a DL_BIND_ACK. For automatic initialization, it implies that the DL_BIND_ACK may not be issued until the initialization is complete. If pre-initialization is not performed and/or automatic initialization fails, the DLS provider will fail the DL_BIND_REQ. Two errors, DL_INITFAILED and DL_NOTINIT, may be returned in the DL_ERROR_ACK response to a DL_BIND_REQ if PPA initialization fails. DL_INITFAILED is returned when a DLS provider supports automatic PPA initialization, but the initialization attempt failed. DL_NOTINIT is returned when the DLS provider requires pre-initialization, but the PPA is not initialized before the DL_BIND_REQ is received. 57

Section	Page
1 Introduction to DLPI	15
HP DLPI Features	17
Fine-grained Privileges	17
Device File Format	19
Header Files	19
The Data Link Layer	20
The Service Interface	20
Modes of Communication	22
Connection-mode Service	23
Connectionless-mode Service	24
DLPI Addressing	24
Physical Attachment Identification	25
HP PPA Format	26
Data Link User Identification	26
HP DLSAP Address Format (802.3, Ethernet, Token Ring, FDDI)	26
Promiscuous Mode Clarifications	29
DLPI Services	30
Local Management Services	34
Information Reporting Service	34
Attach Service	34
Bind Service	35
Binding	35
Reserved IEEESAPS/Ethertypes	36
Connection-mode Services	39
Connection Establishment Service	39
Connection Handoff	40
Data Transfer Service	44
Connection Release Service	44
Reset Service	46
Connectionless-mode Services	48
Connectionless Data Transfer	49
Error Reporting Service	49
Raw-mode Services	50
Raw-mode Data Transfer	50
Error Reporting Service	51
XID and TEST Service	51
XID and TEST Packet Handling	51
An Example	53
2 DLPI Primitives	55
Local Management Primitives	57
PPA Initialization and De-initialization	57
DL_HP_PPA_REQ	58
DL_HP_PPA_ACK	59
DL_INFO_REQ	62
DL_INFO_ACK	62
DL_HP_NOTIFY_EVENT_REQ	67
DL_LINK_DOWN_IND	69
DL_LINK_UP_IND	69
DL_ATTACH_REQ	70
DL_DETACH_REQ	72
DL_BIND_REQ	73
DL_BIND_ACK	76
DL_UNBIND_REQ	77
DL_SUBS_BIND_REQ	78
DL_SUBS_BIND_ACK	80
DL_SUBS_UNBIND_REQ	81
DL_ENABMULTI_REQ	82
DL_DISABMULTI_REQ	83
DL_PROMISCON_REQ	85
DL_PROMISCOFF_REQ	87
DL_HP_HW_RESET_REQ	89
DL_HP_RESET_STATS_REQ	90
DL_OK_ACK	92
DL_ERROR_ACK	92
Optional Primitives to Perform Essential Management Functions	93
DL_PHYS_ADDR_REQ	94
DL_PHYS_ADDR_ACK	95
DL_SET_PHYS_ADDR_REQ	96
DL_GET_STATISTICS_REQ	98
DL_GET_STATISTICS_ACK	99
DL_HP_GET_64BIT_STATS_REQ	100
DL_HP_GET_64BIT_STATS_ACK	101
DL_HP_MULTICAST_LIST_REQ	102
DL_HP_MULTICAST_LIST_ACK	104
Connectionless-mode Service Primitives	106
DL_UNITDATA_REQ	106
DL_UNITDATA_IND	108
DL_UDERROR_IND	109
Raw Mode Service Primitives	111
DL_HP_RAWDATA_REQ	111
DL_HP_RAWDATA_IND	112
Connection-mode Service Primitives	114
Connection-Oriented DLPI Extensions	114
DL_HP_INFO_REQ	114
DL_HP_INFO_ACK	115
DL_HP_SET_ACK_TO_REQ	119
DL_HP_SET_P_TO_REQ	120
DL_HP_SET_REJ_TO_REQ	121
DL_HP_SET_BUSY_TO_REQ	122
DL_HP_SET_SEND_ACK_TO_REQ	123
DL_HP_SET_MAX_RETRIES_REQ	124
DL_HP_SET_ACK_THRESH_REQ	124
DL_HP_SET_LOCAL_WIN_REQ	126
DL_HP_SET_REMOTE_WIN_REQ	127
DL_HP_CLEAR_STATS_REQ	128
DL_HP_SET_LOCAL_BUSY_REQ	129
DL_HP_CLEAR_LOCAL_BUSY_REQ	130
DL_CONNECT_REQ	130
DL_CONNECT_IND	132
DL_CONNECT_RES	134
DL_CONNECT_CON	137
DL_TOKEN_REQ	138
DL_TOKEN_ACK	139
DL_DATA_REQ	139
DL_DATA_IND	140
DL_DISCONNECT_REQ	140
DL_DISCONNECT_IND	142
DL_RESET_REQ	144
DL_RESET_IND	145
DL_RESET_RES	146
DL_RESET_CON	147
Primitives to Handle XID and TEST Operations	148
DL_TEST_REQ	148
DL_TEST_IND	150
DL_TEST_RES	151
DL_TEST_CON	152
DL_XID_REQ	153
DL_XID_IND	155
DL_XID_RES	156
DL_XID_CON	157
DLPI States	159
3 DLPI Input/Output Controls	167
ioctl Processing	169
Supported ioctls	171
DL_IOC_DRIVER_OPTIONS	171
DL_IOC_HDR_INFO	173
DL_HP_SET_DRV_PARAM_IOCTL	175
DL_HP_GET_DRV_PARAM_IOCTL	179
DLPI_SET_NOLOOPBACK	180
A Sample Programs	183
ioctl Example	184
Connection Mode Example	189
Connectionless Mode Example	203
Raw Mode Example	216

Match case Limit results 1 per page

DLPI Primitives

Local Management Primitives

Chapter 2

Local Management Primitives

This section describes the local management service primitives. These

primitives support the information reporting, Attach, and Bind. Once a

stream has been opened by a DLS user, these primitives initialize the

stream, preparing it for use.

PPA Initialization and De-initialization

The PPA associated with each stream must be initialized before the DLS

provider can transfer data over the medium. The initialization and

de-initialization of the PPA is a network management issue, but DLPI

must address the issue because of the impact such actions have on a DLS

user. More specifically, DLPI requires the DLS provider to initialize the

PPA associated with a stream at some point before it completes the

processing of the DL_BIND_REQ. Guidelines for initialization and

de-initialization of a PPA by a DLS provider are presented here.

A DLS provider may initialize a PPA using one of the following methods:

•

Preinitialized by some network management mechanism before the

DL_BIND_REQ is received

•

Automatic initialization on receipt of a DL_BIND_REQ or

DL_ATTACH_REQ

A specific DLS provider may support either of these methods, or possibly

combination of the two, but the method implemented has no impact on

the DLS user. From the DLS user

’

s viewpoint, the PPA is guaranteed to

be initialized on receipt of a DL_BIND_ACK. For automatic

initialization, it implies that the DL_BIND_ACK may not be issued until

the initialization is complete.

If pre-initialization is not performed and/or automatic initialization fails,

the DLS provider will fail the DL_BIND_REQ. Two errors,

DL_INITFAILED and DL_NOTINIT, may be returned in the

DL_ERROR_ACK response to a DL_BIND_REQ if PPA initialization

fails.

DL_INITFAILED is returned when a DLS provider supports automatic

PPA initialization, but the initialization attempt failed. DL_NOTINIT is

returned when the DLS provider requires pre-initialization, but the PPA

is not initialized before the DL_BIND_REQ is received.