HP 800 HP DLPI Programmer's Guide - Page 4

Contents

4

XID and TEST Packet Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

An Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

2. DLPI Primitives

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93

Optional Primitives to Perform Essential Management Functions. . . . . . . . . . . . . . 94

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99

Section	Page
1 Introduction to DLPI	15
HP DLPI Features	17
Fine-grained Privileges with Security Containment Release	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	93
Optional Primitives to Perform Essential Management Functions	94
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	99
DL_HP_GET_64BIT_STATS_ACK	101
DL_HP_MULTICAST_LIST_REQ	102
DL_HP_MULTICAST_LIST_ACK	103
Connectionless-mode Service Primitives	105
DL_UNITDATA_REQ	105
DL_UNITDATA_IND	107
DL_UDERROR_IND	108
Raw Mode Service Primitives	110
DL_HP_RAWDATA_REQ	110
DL_HP_RAWDATA_IND	111
Connection-mode Service Primitives	113
Connection-Oriented DLPI Extensions	113
DL_HP_INFO_REQ	113
DL_HP_INFO_ACK	114
DL_HP_SET_ACK_TO_REQ	118
DL_HP_SET_P_TO_REQ	119
DL_HP_SET_REJ_TO_REQ	120
DL_HP_SET_BUSY_TO_REQ	121
DL_HP_SET_SEND_ACK_TO_REQ	122
DL_HP_SET_MAX_RETRIES_REQ	123
DL_HP_SET_ACK_THRESH_REQ	123
DL_HP_SET_LOCAL_WIN_REQ	125
DL_HP_SET_REMOTE_WIN_REQ	126
DL_HP_CLEAR_STATS_REQ	127
DL_HP_SET_LOCAL_BUSY_REQ	128
DL_HP_CLEAR_LOCAL_BUSY_REQ	129
DL_CONNECT_REQ	129
DL_CONNECT_IND	131
DL_CONNECT_RES	133
DL_CONNECT_CON	136
DL_TOKEN_REQ	137
DL_TOKEN_ACK	138
DL_DATA_REQ	138
DL_DATA_IND	139
DL_DISCONNECT_REQ	139
DL_DISCONNECT_IND	141
DL_RESET_REQ	143
DL_RESET_IND	144
DL_RESET_RES	145
DL_RESET_CON	146
Primitives to Handle XID and TEST Operations	147
DL_TEST_REQ	147
DL_TEST_IND	149
DL_TEST_RES	150
DL_TEST_CON	151
DL_XID_REQ	152
DL_XID_IND	154
DL_XID_RES	155
DL_XID_CON	156
DLPI States	158
3 DLPI Input/Output Controls	165
ioctl Processing	167
Supported ioctls	169
DL_IOC_DRIVER_OPTIONS	169
DL_IOC_HDR_INFO	171
DL_HP_SET_DRV_PARAM_IOCTL	173
DL_HP_GET_DRV_PARAM_IOCTL	177
DLPI_SET_NOLOOPBACK	178
A Sample Programs	181
ioctl Example	182
Connection Mode Example	187
Connectionless Mode Example	201
Raw Mode Example	214
Glossary	221
Index	223
D	223

HP 800 HP DLPI Programmer's Guide - Page 4

DLPI Primitives, Optional Primitives to Perform Essential Management Functions.94

Page 4 highlights