MacTCP Programmers Guide

., l AppleGD MacTCP™ Programmer's Guide -.• ----·--•-·•··•-~-~-~~•• -----··•·•no.·-•·•••-• ··•·•• -•-••--·--·••·-··· ---·------------- ti APPLE COMPUTER, INC. This manual and the software described in it are copyrighted, with all rights reserved. Under the copyright laws, this manual or the software may not be copied, in whole or in part, without written consent of Apple, except in the normal use of the software or to make a backup copy of the software. The same proprietary and copyright notices must be affixed to any permitted copies as were affixed to the original. This exception does not allow copies to be made for others, whether or not sold, but all of the material purchased (with all backup copies) may be sold, given, or loaned to another person. Under the law, copying includes translating into another language or format. You may use the software on any computer owned by you, but extra copies cannot be made for this purpa;e. ©Apple Computer, Inc., 1989 20525 Mariani Avenue Cupertino, CA 95014 (400) 996-1010 Apple, the Apple logo, AppleTalk, and Macintosh are registered trademarks of Apple Computer, Inc. LocaJTalk, MacTCP, and MPW are trademarks of Apple Computer, Inc. ITC Garamond is a registered trademark of International Typeface Capcntion. Microsoft is a registered trademark of Microsoft Corporation. PostScript is a registered trademark of Adobe Systems Incorporated. Simultaneously published in the United States and Canada. • ' ' (/ Contents / Figures and tables I vii Preface I ix What's in th~ guide I ix Who should read ~guide I ix Document conventions I ix Related documents I x 1 Introduction I 1 Architectural overview I 2 Application, presentation, and session layers I 2 Transport layer I 3 User Datagram Protocol (UDP) I 3 Transmission Control Protocol O'CP) I 3 Network layer I 3 Link access layer I 4 Physical layer I 4 :\ 2 The MacTCP Driver I S The PBOpen call I 6 The PBControl call I 7 The PBOose call I 8 Implementation notes I 8 Breakpoints I 8 Fragmentation and reassembly I 8 Routing I 9 3 User Datagram Protocol I 11 Data structures I 12 Write Data Structures I 12 Receive buffer area I 13 Apple Confidential iii - - -- - --- ------- • Using UDP I 13 UDP routines I 14 UDPCreate I 15 UDPRead I 16 UDPBfrRetum I 17 UDPWrite I 18 UDPRelease I 19 UDPMTIJ I 20 UDP asynchronous notification routine I 21 C parameter block definitions I 23 , '" 4 Transmission Control Protocol I 25 Data struc.tures I 26 Read and Write Data Structures I 26 Receive buffer area I 'l'! Using TCP I 'l'! Streams and connections I 27 Asynchronous notification routine I 'l'! Connection opening I 28 Receiving data I 28 Sending data I 28 Time-outs I 28 Pushed data I 29 Urgent mode I 29 Connection dosing I 30 Network management information I 30 Formatting MacTCP commands I 30 TCP routines I 31 TCPCJeate I 32 TCPJ>wiveOpen I 33 Ta>A<.ti.veOpen I 36 TCPSend /37 TCJ>NoCopyRcv I 38 Ta>BfrRetum I 40 TCPRcv /41 Ta>Oaie I 43 Ta>Abort I 44 TCPStatu…