Raw-mode Services | HP UX 11i v2 Networking Software guide

Introduction to DLPI

DLPI Services

transfer is neither acknowledged nor conﬁrmed, and there is no end-to-end ﬂow control provided. As such, the connectionless data transfer service cannot guarantee reliable delivery of data. However a speciﬁc DLS provider can provide assurance that messages will not be lost, duplicated, or reordered.

DL_UNITDATA_REQ conveys one DLSDU to the DLS provider.

DL_UNITDATA_IND conveys one DLSDU to the DLS user. The normal ﬂow of messages is illustrated in Figure 1-27.

Figure 1-27 Message Flow: Connectionless Data Transfer

DL_UNITDATA request

DL_UNITDATA indication

Error Reporting Service

The connectionless-mode error reporting service may be used to notify a DLS user that a previously sent data unit either produced an error or could not be delivered. This service does not, however, guarantee that an error indication will be issued for every undeliverable data unit.

Figure 1-28 Connectionless-Mode Error Reporting

DL_UDERROR indication

Raw-mode Services

The raw-mode services enable a DLS user to transfer packets containing complete MAC and LLC headers to a peer DLS user. The raw-mode service does not guarantee reliable delivery of data units between peer DLS users (e.g. lack of ﬂow control may cause buffer resource shortages that result in data being discarded).

The DLS user requests the raw-mode services by setting the service mode in the DL_BIND_REQ to DL_HP_RAWDLS.

44

Chapter 1

Image 44

HP UX 11i v2 Networking Software manual Raw-mode Services, Error Reporting Service

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 Dlerrorack DlinforeqDlinfoack Dlhpppareq Dlresetreq DlresetindDlresetres Dlresetcon Local Management Services Information Reporting ServiceDlhprawdatareq 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 Dlcsmacd DltpbDltpr Dlmetro Dlchar DlctcaDlfddi 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 DlsetphysaddrreqDlphysaddrack Dlphysaddrreq Dlsetphysaddrreq Dlgetstatisticsreq DlgetstatisticsackDlbusy 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 Dlconnectcon DlbadtokenDlbadcorr 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 User Reset Dluserreset Dlresetcon Prov Reset DlprovresetDlresetres Resetres Udqos Pend Dludqos DLDISCON9 Pend PendingDlinconpending 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