ODI Developers Guide

( •• ODlmDeveloper's Guide ( S APPLE COMPUI'l!R, INC. This manual is copyrighted by Apple or by Apple's suppliers, with ail rights reserved. Under the copyright laws, this manual may not be copied, in whole or in part, without the written consent of Apple Computer, Inc. except in the normal use of software or to make a backup copy of the software. This exception does not allow copies to be made for O<hers, whether or not sold, but ail of the material purchased may be sold, given, or lent to another person. Under the law, copying includes translating into anaher language. © Apple Computer, Inc., 1988 20525 Mariani Avenue Cupertino, CA 95014 (4~) 996-1010 Apple, the Apple logo, laserWrirer, and Macintosh are registered trademarks of Apple Computer, Inc. Ethernet is a registered trademark of Xerox Corporation. ITC Avant Garde Gothic, ITC Garamond, and ITC Zapf Dingbats are registered trade- marks of International Typeface Corporation. MicroChannel is a trademark of Internation Business Corporation. MU/MPI, MU, MPI, and Link Support I.ayer are jointly owned trademarks of Apple Computer and Novell, Inc. POSTSCRIPT is a regi1tered trademark: of Adobe Systems Incorporared. Varityper is a~ trade-mark, and VT600 is a trademark, of AM International, Inc. Simultaneously published in the United States and Canada. 2/21/88 ( Contents Introduction 1 Introducing the MWMPI Benefits for the user Benefits for the developer MLI/MPI module specifics Protocol stack independence from MUDs Developing MLIDs 2 The Unk Support Layer Protocol Stack Support Entry Point MUD Support Entry Point General Services Entry Point What You Need to Know 3 Link Support Layer General Services AllocMemory FreeMemory ReAllocMemory MemoryStatistics AddMemoryToPool AddGeneralService RermveGeneralSe.rvice pART I. Writing Drivers for the Mll 4 MllD Operations The SEND Entry Point Handler iii The Interrupt Service Routine 5 MLID Initialization 6 MLID Control Procedures GetMLIDConfiguration GetMLIDStatistics AddMulticastAddress DeleteMulticastAddress ReceptionControl MLIDShutdown MLIDReset CreateConnection RernoveConnection AddPromiscuousSourceFilter AddPromiscuousDestinationFilter dearProrni.scuousFilters DriverPoll 7 IJnk Support Commands for MI.IDs GetECB RetumECB DeFragmentECB ScheduleAESEvent CancelAESEvent GetintervalMarker DeregisterMUD HoldRcvEvent StartCriticalSection EndCriticalSection GetCriticalSectionStatus ScrviceEvents F.oqueueSend GetNextSend SendComplete AddProtocolID iv Contents PART II Writing Protocol Stacks for the MPI ( 8 Protocol Stack Operations 1be Receive Entry Point The Default Receiver Entry Point The PreScanEntry Point The Transmit Packet Handler 9 Protocol Stack Initialization Stack Installation Stages Registering a Protocol Stack Register by binding with an MUD Register as the default stack Register as the PreScan stack Finding an MUD by Name 10 Protocol Stack Control Commands GetProtocolStackConfiguration GetProtocolStackStatistics Bin…