Dlpi Primitives | HP UX 11i v2 Networking Software manual

DLPI Primitives

The kernel-level interface to the data link layer deﬁnes a STREAMS-based message interface between the provider of the data link service (DLS provider) and the consumer of the data link service (DLS user). STREAMS provides the mechanism in which DLPI primitives may be passed between the DLS user and DLS provider.

Before DLPI primitives can be passed between the DLS user and the DLS provider, the DLS user must establish a stream to the DLS provider using open(2). The DLS provider must therefore be conﬁgured as a STREAMS driver. When interactions between the DLS user and DLS provider have completed, the stream may be closed.

The STREAMS messages used to transport data link service primitives across the interface have one of the following formats:

•One M_PROTO message block followed by zero or more M_DATA blocks. The M_PROTO message block contains the data link layer service primitive type and all relevant parameters associated with the primitive. The M_DATA block(s) contain any DLS user data that might be associated with the service primitive.

•One M_PCPROTO message block containing the data link layer service primitive type and all relevant parameters associated with the service primitive.

•One or more M_DATA message blocks conveying user data.

The following sections describe the format of the supported primitives. The primitives are grouped into four categories:

•Local Management Service Primitives

•Connectionless-mode Service Primitives

•Connection-mode Service Primitives

•Primitives to handle XID and TEST operations

All of the DLPI extensions listed in this chapter are deﬁned in <sys/dlpi_ext.h> and <sys/dlpi.h>.

50

Chapter 2

Image 50

HP UX 11i v2 Networking Software manual Dlpi Primitives

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 Physical Attachment Identiﬁcation Connectionless-mode ServiceDlpi Addressing 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 Snap BindingReserved IEEESAPS/Ethertypes 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 Dlunknown DlhprawdlsDlacldls DLSTYLE1 DLSTYLE2 Dlbadppa DlaccessDlattachreq Dlsyserr DldetachreqDloutstate Dlbindreq Dlnotinit DlbadaddrDlinitfailed Dlbindack Dlunbindreq Dlsubsbindreq Dlpeerbind Dlhierarchicalbind Dlsubsbindack Dltoomany Dlsubsunbindreq Dlenabmultireq Dldisabmultireq Dlnotsupported Dlpromisconreq Dlnotenab Dlpromiscmulti DlpromiscphysDlpromiscsap 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 Dlhpinforeq Connection-mode Service PrimitivesConnection-Oriented Dlpi Extensions Dlhpinfoack Dlhpinforeq Dlhpinfoack Connection-mode Service Primitives Connection-mode Service Primitives Dlhpsetacktoreq Dlhpsetacktoreq Dlhpsetptoreq Dlhpsetptoreq Dlhpsetrejtoreq DlhpsetrejtoreqDlhpsetbusytoreq Dlhpsetsendacktoreq Dlhpsetbusytoreq Dlhpsetmaxretriesreq DlhpsetmaxretriesreqDlhpsetsendacktoreq Dlhpsetackthreshreq DLOUTCONPENDING, Dlinconpending Dlhpsetlocalwinreq Dlhpsetremotewinreq Dlhpclearstatsreq Dlhpsetremotewinreq Dlhpsetlocalbusyreq DlhpsetlocalbusyreqDlhpclearstatsreq Dlhpclearlocalbusyreq Dlhpclearlocalbusyreq Dlconnectreq Dlbadqostype DlconnectindDlbadqosparam 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