Novell ODI Specification: Netware 16-Bit DOS Protocol Stacks and Mlids
Total Page:16
File Type:pdf, Size:1020Kb
Novell ODI Specification: NetWare 16-Bit DOS Protocol Stacks and MLIDs ODI Specification Version 4.00 Document Version 1.03 Part Number: 107–00078–001 February 2, 1996 NetWare 16-Bit DOS Protocol Stacks and MLIDs Specification Disclaimer Novell, Inc. makes no representations or warranties with respect to the contents or use of this manual, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Further, Novell, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes. E Copyright 1995 and 1996 by Novell, Inc. All rights reserved. This document may be freely copied and distributed as long as it is reproduced in its entirety and for the benefit of network product developers. Portions of this document may be included with other material as long as authorship is attributed to Novell, Inc. and appropriate copyright notices are included. Novell, Incorporated 122 East 1700 South Provo, Utah 84606 Trademarks Novell, Inc. has attempted to supply trademark information about company names, products, and services mentioned in this manual. Novell and NetWare are registered trademarks of Novell, Inc. Internetwork Packet Exchange, IPX, Link Support Layer, LSL, MAC, Multiple Link Interface, MLI, Multiple Link Interface Driver, MLID, Multiple Protocol Interface, MPI, NE1000, NE2000, NE2100, NE/2, NE2–32, NTR2000, NetWare System Interface, NSI, NetWare Access Services, NetWare Core Protocol, NCP, NetWare Directory Services, NDS, NetWare DOS Requester, NDR, NetWare Express, NetWare Loadable Module, NLM, NetWare Management Agent, NetWare Requester, NetWare Runtime, Novell Embedded Systems Technology, NEST, Novell Labs, Open Data–Link Interface, ODI, Packet Burst, RX–Net, SFT, Transactional Tracking System, TTS, Virtual Loadable Module, VLM are trademarks of Novell, Inc. IBM is a registered trademark of International Business Machines Corporation. AppleTalk is a registered trademark of Apple Computer, Inc. LAT is a trademark of Digital Equipment Corporation. ii Version 1.03 (February 2, 1996) 1 1 1. Table of Contents Table of Contents. iii Preface . x Document Organization. x Referenced Documents. x Equates and Structures. xi LSL Initialization Entry Function Equates. xi Registration Structures. xii MemStatStruc Structure. xii StackChainStruc Structure. xii LookAheadStruc Structure. xiii LDestType Bit Definitions. xiii LPacketAttrib Bit Definitions. xiii Promiscuous State Flag Bit Definitions. xiii ODI Architecture. I-1 Section Overview. I-2 Introduction to ODI. 1-1 Chapter Overview. 1-2 Open Data-Link Interface (ODI). 1-3 Protocol Stacks. 1-3 Link Support Layer (LSL). 1-5 Multiple Link Interface Drivers (MLIDs). 1-5 Data Flow. 1-6 Send Data Flow. 1-6 Receive Data Flow. 1-7 Protocol Stacks. II-1 Section Overview. II-2 Overview of Protocol Stacks. 2-1 DOS Environment. 2-2 Protocol Stack Performance. 2-2 Network Interface Card Utilization. 2-2 Hardware/Media Independence. 2-3 Protocol Stack Multiplexing. 2-4 Packet Transmission and Reception. 2-4 Binding Protocol Stacks. 2-4 Receiving Packets. 2-6 Version 1.03 (February 2, 1996) iii Table of Contents Priority Packet Support. 2-6 Stack Filtering. 2-7 Protocol Stack Data Structures. 3-1 Overview. 3-2 Protocol Stack Configuration Table. 3-3 Protocol Stack Configuration Table Structure Sample Code. 3-3 Protocol Stack Statistics Table. 3-4 Protocol Stack Statistics Table Structure Sample Code. 3-4 Protocol Stack Initialization. 4-1 Overview. 4-2 Locating the LSL. 4-3 Registering with the LSL. 4-5 Determining Which Logical Boards to Service. 4-6 Explicit Method. 4-6 Dynamic Method. 4-6 Adding Protocol IDs. 4-7 Multiple Board Support. 4-8 Obtaining Protocol ID Value(s). 4-8 Customizing a Protocol Stack. 4-8 Line Speed. 4-9 Measuring Effective Network Performance. 4-9 Maximum Packet Size. 4-9 Multicast Support. 4-10 Receive Look Ahead. 4-11 Bind to Logical Board(s). 4-11 Final Initialization. 4-12 Unhooking the Protocol Stack. 4-12 Unload Module Algorithm. 4-12 Protocol Stack Packet Reception. 5-1 Protocol Stack Packet Receive Operation. 5-2 Receive Routine Events. 5-2 Receive Look Ahead. 5-2 Receive Handler. 5-2 LookAheadStruc Structure. 5-3 Receive Look Ahead Size. 5-5 Protocol Stack Packet Reception Methods. 5-6 Bound Protocol Stack. 5-6 Prescan Protocol Stack. 5-6 Default Protocol Stack. 5-6 StackChainStruc Structure. ..