114 | HP UX 11i v2 Networking Software guide

DLPI Primitives

Connection-mode Service Primitives

dl_correlation

correlation number that was received with the DL_CONNECT_IND associated with the connection request. The DLS provider will use the correlation number to identify the connect indication to which the DLS user is responding.

dl_resp_token

if non-zero, the token associated with the responding stream on which the DLS provider is to establish the connection; this stream must be attached to a PPA and bound to a DLSAP.

dl_qos_length

length of the quality of service parameter. This should be the same parameter speciﬁed in the DL_CONNECT_IND.

dl_qos_offset

offset from the beginning of the M_PROTO message block where the quality of service parameters begin.

dl_growth

growth ﬁeld for future enhancements to this primitive. Its value will be set to zero.

State

The primitive is valid in state DL_INCON_PENDING.

New State

The resulting state is DL_CONN_RES_PENDING.

Response

If the connect response is successful, DL_OK_ACK is sent to the DLS user. If no outstanding connect indications remain, the resulting state for the current stream is DL_IDLE; otherwise, it remains DL_INCON_PENDING. For the responding stream (designated by the parameter dl_res_token), the resulting state is DL_DATAXFER. If the current stream and responding stream are the same, the resulting state of that stream is DL_DATAXFER. These streams may only be the same when the response corresponds to the only outstanding connect indication.

114

Chapter 2

Image 114

HP UX 11i v2 Networking Software manual 114

Contents

Dlpi Programmer’s Guide Edition Legal Notices Page Page Contents Contents Contents Sample Programs Printing History Page Preface Appendix a Sample ProgramsPage Introduction to Dlpi Introduction to Dlpi HP Dlpi Features Device File Format Header Files Service Interface Data Link Layer Dlpi Connection-mode Service Modes of Communication Data Link Layer Connectionless-mode Service Dlpi AddressingPhysical Attachment Identiﬁcation HP PPA Format Data Link User Identiﬁcation HP’s Dlsap Address Format 802.3, Ethernet, Token Ring, Fddi HP’s Dlsap Address Format for Fibre Channel Dlsap Promiscuous Mode Clariﬁcations Dlpi Services Dlinfoack DlerrorackDlinforeq Dlhpppareq Dlresetres DlresetreqDlresetind Dlresetcon Dlhprawdatareq Local Management ServicesInformation Reporting Service Dlhprawdataind Attach Service Bind Service Binding Reserved IEEESAPS/EthertypesSnap Message Flow Binding a Stream to a Dlsap Message Flow Enabling a Speciﬁc Multicast Address on a Connection-mode Services Connection Establishment Service Connection Handoff 12 Message Flow Successful Connection Establishment 13 Message Flow Token Retrieval 16 Message Flow Both Primitives are Destroyed by Provider Data Transfer Service 19 Message Flow Normal Data Transfer Connection Release Service 20 Message Flow DLS User-Invoked Connection Release Reset Service 23 Message Flow DLS User-Invoked Connection Reset Connectionless-mode Services Connectionless Data Transfer Raw-mode Services Error Reporting Service XID and Test Service Raw-mode Data Transfer 31 Message Flow XID Service XID and Test Packet Handling 32 Message Flow Test Service An Example 33 Message Flow a Connection-Mode Example Dlpi Primitives Dlpi Primitives Local Management Primitives PPA Initialization/De-initialization Dlhpppareq Dlhpppaack Dlhpppaack Dlinforeq MTU Dlinfoack Dltpr DlcsmacdDltpb Dlmetro Dlfddi DlcharDlctca Dlother Dlhprawdls DlacldlsDlunknown DLSTYLE1 DLSTYLE2 Dlaccess DlattachreqDlbadppa Dldetachreq DloutstateDlsyserr Dlbindreq Dlbadaddr DlinitfailedDlnotinit Dlbindack Dlunbindreq Dlsubsbindreq Dlpeerbind Dlhierarchicalbind Dlsubsbindack Dltoomany Dlsubsunbindreq Dlenabmultireq Dldisabmultireq Dlnotsupported Dlpromisconreq Dlnotenab Dlpromiscphys DlpromiscsapDlpromiscmulti Dlpromiscoffreq Dlokack Dlerrorack Dlphysaddrreq Dlfactphysaddr Dlcurrphysaddr Dlphysaddrack DlphysaddrackDlsetphysaddrreq Dlphysaddrreq Dlsetphysaddrreq Dlbusy DlgetstatisticsreqDlgetstatisticsack Dlgetstatisticsreq Dlhpmulticastlistreq Dlgetstatisticsack Dlhpmulticastlistack Dlhpmulticastlistack Connectionless-mode Service Primitives Dlunitdatareq Dlbaddata Dlunitdataind Dluderrorind Message is valid in state Dlidle Raw Mode Service Primitives Dlhprawdatareq Dlhprawdataind Dlbadprim Raw Mode Service Primitives Connection-mode Service Primitives Connection-Oriented Dlpi ExtensionsDlhpinforeq Dlhpinfoack Dlhpinforeq Dlhpinfoack Connection-mode Service Primitives Connection-mode Service Primitives Dlhpsetacktoreq Dlhpsetacktoreq Dlhpsetptoreq Dlhpsetptoreq Dlhpsetrejtoreq DlhpsetbusytoreqDlhpsetrejtoreq Dlhpsetsendacktoreq Dlhpsetbusytoreq Dlhpsetmaxretriesreq DlhpsetsendacktoreqDlhpsetmaxretriesreq Dlhpsetackthreshreq DLOUTCONPENDING, Dlinconpending Dlhpsetlocalwinreq Dlhpsetremotewinreq Dlhpclearstatsreq Dlhpsetremotewinreq Dlhpsetlocalbusyreq DlhpclearstatsreqDlhpsetlocalbusyreq Dlhpclearlocalbusyreq Dlhpclearlocalbusyreq Dlconnectreq Dlconnectind DlbadqosparamDlbadqostype 112 Dlconnectres 114 Dlbadcorr DlconnectconDlbadtoken Dlpending 116 Dltokenreq Dltokenack Dldatareq Dldataind Dldisconnectreq 120 Dldisconnectind Dlresetreq Dlresetind Dlresetres Dlresetcon 126 Primitives to Handle XID and Test Operations Dltestreq Dltestind Dltestauto Chapter 129 Dltestres Dltestcon Dlxidreq Dlxidind Dlxidauto 134 Dlxidres Dlpollfinal Dlxidcon Chapter 137 Dlpi States Dlresetres Resetres User Reset DluserresetDlresetcon Prov Reset Dlprovreset Udqos Pend Dludqos Dlinconpending DLDISCON9Pend Pending DLDISCON11 Chapter 141 142 Sample Programs Connection Mode Longareasize Appendix a 145 146 Appendix a 147 148 Appendix a 149 150 Appendix a 151 152 Appendix a 153 154 Appendix a 155 Connectionless Mode Snap SAP Appendix a 157 158 Appendix a 159 160 Appendix a 161 162 Appendix a 163 164 Appendix a 165 166 Raw Mode 168 Appendix a 169 170 Appendix a 171 Raw Mode 172 Glossary Connection establishment 174 Glossary Index