Dlpi | HP UX 11i v2 Networking Software specs

Introduction to DLPI

The Data Link Layer

Figure 1-1

Abstract View of DLPI

Data Link

User

Request/Response

Primitives

DLPI

Indication/Confirmation

Primitives

Data Link

Provider

The data link interface is the boundary between the network and the data link layers of the OSI Reference Model. The network layer entity is the user of the services of the data link interface (DLS user), and the data link layer entity is the provider of those services (DLS provider). This interface consists of a set of primitives that provide access to the data link layer services, plus the rules for using those primitives (state transition rules). A data link interface service primitive might request a particular service or indicate a pending event.

To provide uniformity among the various UNIX system networking products, an effort is underway to develop service interfaces that map to the OSI Reference Model. A set of kernel-level interfaces, based on the STREAMS development environment, constitute a major portion of this effort. The service primitives that make up these interfaces are deﬁned as STREAMS messages that are transferred between the user and provider of the service. DLPI is one such kernel-level interface, and is targeted for STREAMS protocol modules that either use or provide data link services. In addition, user programs that wish to access a STREAMS-based data link provider directly may do so using the putmsg(2) and getmsg(2) system calls.

Referring to Figure 1-1, the DLS provider is conﬁgured as a STREAMS driver, and the DLS user accesses the provider using open(2) to establish a stream to the DLS provider. The stream acts as a communication

18

Chapter 1

Image 18

HP UX 11i v2 Networking Software manual Dlpi

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