., 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…

( Medusa Programmer's Guide Beta Draft Apple Confidential Medusa Programmer's Guide, Beta Draft S APPLE COMP'Ulll, INC. This manual is cq>yrighted by Apple or by Apple's suppliers, with all rights reserved. Under the cop)'!ight laws, this manual may !10l be copied, in whole or in part, without the written consent of Apple Computer, Inc. This exception does !lC( allow copies to be made for OOiers, whether or ncx sold, but all ci the material purchased may be sold, given, or lent to another person. Under the law, copying includes translating into another language. C Apple Computer, Inc., 1989 20525 Mariani Avenue Cupertino, CA 95014 (~)996-1010 Apple, the Apple logo, and Macintosh are registered trademarks of Apple Computer, Inc. TokenTalk, Macinta;h Coprocessor Platform, and MR-DOS are trademarks of Apple Computer, Inc. NuBus i.5 a trademark of Texas Instruments. Simultaneously publi.shed in the United States and Canada Notice The information in this document rctlects the current state of the product. Every effort has been made to verify the accuracy of this information; however, it is subject to change. Beta Drafts an: rcJe:ased in this form to ptOTlde the deveJopmem community with essendal information In order to work on compatible products. Apple confidential Y21/89 Apple C.Onfidential ( Contents Preface What this document contains I Suggested reading I Possible applications I Conventions used in this manual I 1 Introduction 1 Token Ring Networks I The network layers I A token ring network I Token communication I The Macintosh II token ring interface I SubNetwork Access Protocol (SNAP) I The 802.2 Logical Link Control !PC interface I Macintosh Operating System !PC services I Download and initialization services I iii Apple Confidential 2 Source Routing Support What is source routing? I Hierarchical networks I Mesh networks I How source routing works I Routing information I Source routing implementation I SNAPuse I U.C use I Source route limits I 3 SubNetwork Access Protocol (SNAP) Interface General information I Typical SNAP use I !PC requests to SNAP I SNAPAttach I SNAPGetConfig I SNAPGetHdr I SNAPTransmit I SNAPDetach I SNAPReceive I SNAPC.ancel I SNAPGetParm.s I Functions supporting 802.2 I SNAPSwapHdr I Example program listing I 4 The 802.2 llC I lPC Interface General information I Typi:al rol-2 llC use I !PC requests ID ~2.2 LLC I U.COpenSAP I U.CCloseSAP / iv CONTENTS Apple Confidential ( IlCGetHdr I IlCGetCoofig I LLCOpenStation I LLCClo.seStation I IlCConnectStation I LLCModifyParams I IlCReceive I IlCReceiveC.ancel I IlCTl Transmit I IlCT2Transmit I IlCReset I LLCRetumBuffer I IlCGetStatistics I IlCStatus I IlCSetFunctionalAddr I Functions Supporting 802.2 I LLCSwapHdr I 5 Apple IPC Services I 1 General information I Apple !PC driver I Apple !PC library I Apple !PC managers I Csing Apple !PC I Apple !PC services I C<RQJeue I CopvNuBus I freeMsg / GetCard I GetETick I GetICCTID I GetlPCg I GetMsg I GeL"larn…

·~Apple MacTCP Administrator's Guide Product Marketing Networking and Communications Publications AppleTalk Documentation February 1, 1989 Apple Confldeotial ( S APPIJ! CoMPT.Tl'ER, INC. This manual is copyriglted by Apple er by Apple's suppliers, with all rights reserved. Under the copyright laws, th.is manual may not be copied, in whole or in part, without the wrlten c:onselX of Apple (.omputer, Ioc. This exception does ncx allow copies to be made for others, whether or ncx sold, but all of the material purchased may be sold, given, or lent to aoother person. Under the law, copying includes translating into ancxher language. The Apple logo is a regisrered trademark d Apple Computer, Inc. Use of the "keybaard" Apple logo (Opti>n-Shift-K) for commercial purposes without the prior wrillen consent of Apple may c:omtitute trademark infringement and unfair competition in relation 6f federal and state Jaws. ~ Apple Computer, Ioc., 1989 20525 Mariani Avenue Cupertiro, CA 95014 (4~) 996-1010 Apple, the Apple logo, AppleTalk, EtherTalk, LaserWriter, l.oC2II'alk, Macintosh, and MacTCP are regisrered trademarks d Apple Computer, Inc. ii Apple Coofidential C 0 N T E N T S Contents About This Gulde xiii Who should read this guide xiv How to use this guide xiv f Conventions xv ' What yoo need xvi Associated documeIXS xvi Part I Apple Confidential Concepts 1 About MacTCP Overview 2 1 Network environment DDP-IP gateway 4 3 iii .. \ 2 About TCP/IP 5 The family ci protocols 7 Iruernet Protcx:ol (IP) 9 Transmission Control Protocol \I'CP) 10 User Datagram Protocol (UDP) 10 Telnet 11 File Transfer Protcx:ol (FTP) 11 Simple Mail Transfer Protocol (SMTP) 11 3 TCP/IP Addressing Conventions Internet addresses 14 Subnetwork addressing 16 Subnetwork masks 18 The domain name system 19 13 Addres.5 Resolution Prcxocol (ARP) 21 Reverse Address Resolution Protocol (RARP) 22 Boexstrap Protocol (BoolP) 23 4 Routing 25 Gateways 26 Routing tables Z7 Routing protocols 28 Routing Information Protocol (RIP) 28 Iruemet Comd Mwage Protocol OCMP) 28 iv Contents Apple Confidential ( Part II Procedures 5 Installation 29 MacTCP scitware 30 Creating a master cmk 31 user installation in.structm 35 lNlalling Macro> on a fk>ppy disk-based system 35 lNlalling MacTCP en a hard disk 36 6 MacTCP Configuration Configuratioo tools 40 39 The MacTCP Corurol Panel 41 The Administrator dialog box 43 Obtain Address box 43 IP Address box 44 Routing Information box 44 Domain Name Server Information box « Protected button « c:onfiguration scenarias 45 Bringing up the MacTCP Control Panel 47 Entering the IP address in decimal rotation 48 Bringing up the Administrator dialog 49 Setting the IP address SO Setting the address manually 51 Setting the addtcss ~ 51 Settins the subnet mask 53 Selling the IP address (integer format) 53 Entering the net number 54 Enlering the subnet number 54 Entering the node number 54 Having the address set auromatically 56 Setti…

Apple Confidential (/ •~ Apple~ AppleTalk* Internet Router Administrator's Guide (_ . Apple Confidential • ti APPLE COMPUTER, INC. This manual and the software described in it are copyrighted, with all rights reserved. Under the cop'YJ'ight laws, neither this manU1l nor the software may be copied, in whole or in part, wlhout 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 aff'ixed to any permined copies as were aff'ixed to the original. This exception does not allow copies to be made for othels, whether or not sold, but all of the mate.rial purchased (with all backup copies) may be sold, given, or loaned to another person. Under the law, copying includes translating into another language or fomiat. You may use the software on any computer owned by you, but exua copies cannot be made for this purpose. © Apple Computer, Inc., 1989 20525 Mariani Avenue Cupenino, CA 95014 (408) 996-1010 Apple, the Apple logo, AppleShare, AppleTalk, ImageWriter, LaserWriter, and Macintosh are registered trademarks of Apple Computer, Inc. EtherTalk, Finder, Inter• Poll, LocalTalk, and TokenTalk are trademarks of Apple Computer, Inc. MacDraw is a registered trademark of Claris Corporation. . Apple Confldentlal Contents Figures and tables Preface About This Guide Who should read this guide How to use this guide If you're new to routers If you're experienced with routers Selecting a network administrator Additional references Part I 1 Introduction and System Requirements The AppleTalk Internet Router How the AppleTalk Internet Router works Network connections on your router What the AppleTalk Internet Router can do Internet routing functions Router control and monitoring functions Bridges and routers v .. Apple Confldentlal 2 AppleTaJk Terms and Concepts AppleTalk networks and intemets Network Internet 1be AppleTalk Network System Netwm servkes AppleTalk addressing Packers Nodes Network addresses Node addreues AppleTalk zones 1.one names and zone lists An inremet zone example Internet routers Hardware-based and software-based routers Seed routers Hops Routing tables 3 System Requirements .and Router Environments System requirements Hardware Software Macintosh router environments Running the AppleTalk Internet Router on a nondedicated Macintosh computer Running the AppleTalk Internet Router on a dedicated Macintosh computer RuMing the AppleTalk Internet Router on a Macintosh workstation Connecting networks to the router ports Potts 4 A quick tour The Router desk accessory The Router Setup window The Network Information window The Port Statistics window Router operatioo vi Contents Apple Conllderit!al . Part U JostaWng and Using the AppleTalk Internet Router 5 Installing the AppleTalk Internet Router The AppleTalk Inremct Rooter diR Installing on a bard <&k Installing the AppleTalk Internet Router with an AppleShare file server Sh…