HP UX 11i v2 Networking Software manual Dlpi Primitives

Page 50

DLPI Primitives

The kernel-level interface to the data link layer defines 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 configured 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 defined in <sys/dlpi_ext.h> and <sys/dlpi.h>.

50

Chapter 2

Image 50
Contents Dlpi Programmer’s Guide EditionLegal 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 FilesService Interface Data Link LayerDlpi Connection-mode Service Modes of CommunicationData Link Layer Physical Attachment Identification Connectionless-mode ServiceDlpi Addressing HP PPA Format Data Link User Identification HP’s Dlsap Address Format 802.3, Ethernet, Token Ring, FddiHP’s Dlsap Address Format for Fibre Channel Dlsap Promiscuous Mode Clarifications Dlpi Services Dlinfoack DlerrorackDlinforeq DlhpppareqDlresetres DlresetreqDlresetind DlresetconDlhprawdatareq Local Management ServicesInformation Reporting Service DlhprawdataindAttach Service Bind ServiceSnap BindingReserved IEEESAPS/Ethertypes Message Flow Binding a Stream to a Dlsap Message Flow Enabling a Specific Multicast Address on a Connection-mode Services Connection Establishment ServiceConnection Handoff 12 Message Flow Successful Connection Establishment13 Message Flow Token Retrieval 16 Message Flow Both Primitives are Destroyed by Provider Data Transfer Service 19 Message Flow Normal Data TransferConnection Release Service 20 Message Flow DLS User-Invoked Connection ReleaseReset Service 23 Message Flow DLS User-Invoked Connection Reset Connectionless-mode Services Connectionless Data TransferRaw-mode Services Error Reporting ServiceXID and Test Service Raw-mode Data Transfer31 Message Flow XID Service XID and Test Packet Handling32 Message Flow Test Service An Example33 Message Flow a Connection-Mode Example Dlpi Primitives Dlpi Primitives Local Management Primitives PPA Initialization/De-initializationDlhpppareq Dlhpppaack Dlhpppaack Dlinforeq MTUDlinfoack Dltpr DlcsmacdDltpb DlmetroDlfddi DlcharDlctca DlotherDlunknown DlhprawdlsDlacldls DLSTYLE1 DLSTYLE2Dlbadppa DlaccessDlattachreq Dlsyserr DldetachreqDloutstate Dlbindreq Dlnotinit DlbadaddrDlinitfailed Dlbindack Dlunbindreq Dlsubsbindreq Dlpeerbind DlhierarchicalbindDlsubsbindack DltoomanyDlsubsunbindreq Dlenabmultireq Dldisabmultireq DlnotsupportedDlpromisconreq DlnotenabDlpromiscmulti DlpromiscphysDlpromiscsap Dlpromiscoffreq Dlokack Dlerrorack Dlphysaddrreq Dlfactphysaddr Dlcurrphysaddr Dlphysaddrack DlphysaddrackDlsetphysaddrreq DlphysaddrreqDlsetphysaddrreq Dlbusy DlgetstatisticsreqDlgetstatisticsack DlgetstatisticsreqDlhpmulticastlistreq DlgetstatisticsackDlhpmulticastlistack Dlhpmulticastlistack Connectionless-mode Service Primitives DlunitdatareqDlbaddata Dlunitdataind Dluderrorind Message is valid in state Dlidle Raw Mode Service Primitives DlhprawdatareqDlhprawdataind DlbadprimRaw Mode Service Primitives Dlhpinforeq Connection-mode Service PrimitivesConnection-Oriented Dlpi Extensions Dlhpinfoack DlhpinforeqDlhpinfoack Connection-mode Service Primitives Connection-mode Service Primitives Dlhpsetacktoreq DlhpsetacktoreqDlhpsetptoreq DlhpsetptoreqDlhpsetrejtoreq DlhpsetrejtoreqDlhpsetbusytoreq Dlhpsetsendacktoreq DlhpsetbusytoreqDlhpsetmaxretriesreq DlhpsetmaxretriesreqDlhpsetsendacktoreq Dlhpsetackthreshreq DLOUTCONPENDING, DlinconpendingDlhpsetlocalwinreq Dlhpsetremotewinreq Dlhpclearstatsreq DlhpsetremotewinreqDlhpsetlocalbusyreq DlhpsetlocalbusyreqDlhpclearstatsreq Dlhpclearlocalbusyreq DlhpclearlocalbusyreqDlconnectreq Dlbadqostype DlconnectindDlbadqosparam 112 Dlconnectres 114 Dlbadcorr DlconnectconDlbadtoken Dlpending116 Dltokenreq DltokenackDldatareq Dldataind Dldisconnectreq120 Dldisconnectind Dlresetreq Dlresetind Dlresetres Dlresetcon 126 Primitives to Handle XID and Test Operations DltestreqDltestind DltestautoChapter 129 Dltestres Dltestcon Dlxidreq Dlxidind Dlxidauto134 Dlxidres DlpollfinalDlxidcon Chapter 137 Dlpi States Dlresetres Resetres User Reset DluserresetDlresetcon Prov Reset Dlprovreset Udqos Pend DludqosDlinconpending DLDISCON9Pend Pending DLDISCON11Chapter 141 142 Sample Programs Connection Mode LongareasizeAppendix 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 SAPAppendix 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 establishment174 Glossary Index
Related manuals
Manual 94 pages 16.8 Kb Manual 74 pages 39 Kb Manual 236 pages 18.16 Kb Manual 12 pages 39.66 Kb Manual 28 pages 49.76 Kb