HP UX 11i v2 Networking Software manual

Page 141

DLPI Primitives

DLPI States

The DLS provider may never generate a primitive that places the interface out of state.

If the DLS provider generates a STREAMS M_ERROR message upstream, it should free any further primitives processed by its write side put or service procedure.

The close of a stream is considered an abortive action by the DLS user, and may be executed from any state. The DLS provider must issue appropriate indications to the remote DLS user when a close occurs. For example, if the DLPI state is DL_DATAXFER, a DL_DISCONNECT_IND should be sent to the remote DLS user. The DLS provider should free any resources associated with that stream and reset the stream to its unopened condition.

The following points clarify the state transition table.

If the DLS provider supports connection-mode service, the value of the outcnt state variable must be initialized to zero for each stream when that stream is first opened.

The initial and final state for a style 2 DLS provider is

DL_UNATTACHED. However, because a style 1 DLS provider implicitly attaches a PPA to a stream when it is opened, the initial and final DLPI state for a style 1 provider is DL_UNBOUND. The DLS user should not issue DL_ATTACH_REQ or DL_DETACH_REQ primitives to a style 1 DLS provider.

A DLS provider may have multiple connect indications outstanding (i.e. the DLS user has not responded to them) at one time. As the state transition table points out, the stream on which those indications are outstanding will remain in the DL_INCON_PENDING state until the DLS provider receives a response for all indications.

The DLPI state associated with a given stream may be transferred to another stream only when the DL_CONNECT_RES primitive indicates this behavior. In this case, the responding stream (where the connection will be established) must be in the DL_IDLE state.

The labeling of the states DL_PROV_RESET_PENDING and

DL_USER_RESET_PENDING indicate the party that started the local interaction, and does not necessarily indicate the originator of the reset procedure.

Chapter 2

141

Image 141
Contents Edition Dlpi Programmer’s GuideLegal Notices Page Page Contents Contents Contents Sample Programs Printing History Page Appendix a Sample Programs PrefacePage Introduction to Dlpi Introduction to Dlpi HP Dlpi Features Header Files Device File FormatData Link Layer Service InterfaceDlpi Modes of Communication Connection-mode ServiceData Link Layer Connectionless-mode Service Dlpi AddressingPhysical Attachment Identification HP PPA Format HP’s Dlsap Address Format 802.3, Ethernet, Token Ring, Fddi Data Link User IdentificationHP’s Dlsap Address Format for Fibre Channel Dlsap Promiscuous Mode Clarifications Dlpi Services Dlinforeq DlerrorackDlinfoack DlhpppareqDlresetind DlresetreqDlresetres DlresetconInformation Reporting Service Local Management ServicesDlhprawdatareq DlhprawdataindBind Service Attach ServiceBinding Reserved IEEESAPS/EthertypesSnap Message Flow Binding a Stream to a Dlsap Message Flow Enabling a Specific Multicast Address on a Connection Establishment Service Connection-mode Services12 Message Flow Successful Connection Establishment Connection Handoff13 Message Flow Token Retrieval 16 Message Flow Both Primitives are Destroyed by Provider 19 Message Flow Normal Data Transfer Data Transfer Service20 Message Flow DLS User-Invoked Connection Release Connection Release ServiceReset Service 23 Message Flow DLS User-Invoked Connection Reset Connectionless Data Transfer Connectionless-mode ServicesError Reporting Service Raw-mode ServicesRaw-mode Data Transfer XID and Test ServiceXID and Test Packet Handling 31 Message Flow XID ServiceAn Example 32 Message Flow Test Service33 Message Flow a Connection-Mode Example Dlpi Primitives Dlpi Primitives PPA Initialization/De-initialization Local Management PrimitivesDlhpppareq Dlhpppaack Dlhpppaack MTU DlinforeqDlinfoack Dltpb DlcsmacdDltpr DlmetroDlctca DlcharDlfddi DlotherDlhprawdls DlacldlsDlunknown DLSTYLE2 DLSTYLE1Dlaccess DlattachreqDlbadppa Dldetachreq DloutstateDlsyserr Dlbindreq Dlbadaddr DlinitfailedDlnotinit Dlbindack Dlunbindreq Dlsubsbindreq Dlhierarchicalbind DlpeerbindDltoomany DlsubsbindackDlsubsunbindreq Dlenabmultireq Dlnotsupported DldisabmultireqDlnotenab DlpromisconreqDlpromiscphys DlpromiscsapDlpromiscmulti Dlpromiscoffreq Dlokack Dlerrorack Dlphysaddrreq Dlfactphysaddr Dlcurrphysaddr Dlsetphysaddrreq DlphysaddrackDlphysaddrack DlphysaddrreqDlsetphysaddrreq Dlgetstatisticsack DlgetstatisticsreqDlbusy DlgetstatisticsreqDlgetstatisticsack DlhpmulticastlistreqDlhpmulticastlistack Dlhpmulticastlistack Dlunitdatareq Connectionless-mode Service PrimitivesDlbaddata Dlunitdataind Dluderrorind Message is valid in state Dlidle Dlhprawdatareq Raw Mode Service PrimitivesDlbadprim DlhprawdataindRaw Mode Service Primitives Connection-mode Service Primitives Connection-Oriented Dlpi ExtensionsDlhpinforeq Dlhpinforeq DlhpinfoackDlhpinfoack Connection-mode Service Primitives Connection-mode Service Primitives Dlhpsetacktoreq DlhpsetacktoreqDlhpsetptoreq DlhpsetptoreqDlhpsetrejtoreq DlhpsetbusytoreqDlhpsetrejtoreq Dlhpsetbusytoreq DlhpsetsendacktoreqDlhpsetmaxretriesreq DlhpsetsendacktoreqDlhpsetmaxretriesreq DLOUTCONPENDING, Dlinconpending DlhpsetackthreshreqDlhpsetlocalwinreq Dlhpsetremotewinreq Dlhpsetremotewinreq DlhpclearstatsreqDlhpsetlocalbusyreq DlhpclearstatsreqDlhpsetlocalbusyreq Dlhpclearlocalbusyreq DlhpclearlocalbusyreqDlconnectreq Dlconnectind DlbadqosparamDlbadqostype 112 Dlconnectres 114 Dlbadtoken DlconnectconDlbadcorr Dlpending116 Dltokenack DltokenreqDldatareq Dldisconnectreq Dldataind120 Dldisconnectind Dlresetreq Dlresetind Dlresetres Dlresetcon 126 Dltestreq Primitives to Handle XID and Test OperationsDltestauto DltestindChapter 129 Dltestres Dltestcon Dlxidreq Dlxidauto Dlxidind134 Dlpollfinal DlxidresDlxidcon Chapter 137 Dlpi States Dlresetcon Prov Reset Dlprovreset User Reset DluserresetDlresetres Resetres Udqos Pend DludqosPend Pending DLDISCON9Dlinconpending DLDISCON11Chapter 141 142 Sample Programs Longareasize Connection ModeAppendix a 145 146 Appendix a 147 148 Appendix a 149 150 Appendix a 151 152 Appendix a 153 154 Appendix a 155 Snap SAP Connectionless ModeAppendix 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 Connection establishment Glossary174 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