1*4882a593Smuzhiyun.. SPDX-License-Identifier: GPL-2.0 2*4882a593Smuzhiyun 3*4882a593Smuzhiyun========================================================= 4*4882a593SmuzhiyunAppleTalk-IP Decapsulation and AppleTalk-IP Encapsulation 5*4882a593Smuzhiyun========================================================= 6*4882a593Smuzhiyun 7*4882a593SmuzhiyunDocumentation ipddp.c 8*4882a593Smuzhiyun 9*4882a593SmuzhiyunThis file is written by Jay Schulist <jschlst@samba.org> 10*4882a593Smuzhiyun 11*4882a593SmuzhiyunIntroduction 12*4882a593Smuzhiyun------------ 13*4882a593Smuzhiyun 14*4882a593SmuzhiyunAppleTalk-IP (IPDDP) is the method computers connected to AppleTalk 15*4882a593Smuzhiyunnetworks can use to communicate via IP. AppleTalk-IP is simply IP datagrams 16*4882a593Smuzhiyuninside AppleTalk packets. 17*4882a593Smuzhiyun 18*4882a593SmuzhiyunThrough this driver you can either allow your Linux box to communicate 19*4882a593SmuzhiyunIP over an AppleTalk network or you can provide IP gatewaying functions 20*4882a593Smuzhiyunfor your AppleTalk users. 21*4882a593Smuzhiyun 22*4882a593SmuzhiyunYou can currently encapsulate or decapsulate AppleTalk-IP on LocalTalk, 23*4882a593SmuzhiyunEtherTalk and PPPTalk. The only limit on the protocol is that of what 24*4882a593Smuzhiyunkernel AppleTalk layer and drivers are available. 25*4882a593Smuzhiyun 26*4882a593SmuzhiyunEach mode requires its own user space software. 27*4882a593Smuzhiyun 28*4882a593SmuzhiyunCompiling AppleTalk-IP Decapsulation/Encapsulation 29*4882a593Smuzhiyun================================================== 30*4882a593Smuzhiyun 31*4882a593SmuzhiyunAppleTalk-IP decapsulation needs to be compiled into your kernel. You 32*4882a593Smuzhiyunwill need to turn on AppleTalk-IP driver support. Then you will need to 33*4882a593Smuzhiyunselect ONE of the two options; IP to AppleTalk-IP encapsulation support or 34*4882a593SmuzhiyunAppleTalk-IP to IP decapsulation support. If you compile the driver 35*4882a593Smuzhiyunstatically you will only be able to use the driver for the function you have 36*4882a593Smuzhiyunenabled in the kernel. If you compile the driver as a module you can 37*4882a593Smuzhiyunselect what mode you want it to run in via a module loading param. 38*4882a593Smuzhiyunipddp_mode=1 for AppleTalk-IP encapsulation and ipddp_mode=2 for 39*4882a593SmuzhiyunAppleTalk-IP to IP decapsulation. 40*4882a593Smuzhiyun 41*4882a593SmuzhiyunBasic instructions for user space tools 42*4882a593Smuzhiyun======================================= 43*4882a593Smuzhiyun 44*4882a593SmuzhiyunI will briefly describe the operation of the tools, but you will 45*4882a593Smuzhiyunneed to consult the supporting documentation for each set of tools. 46*4882a593Smuzhiyun 47*4882a593SmuzhiyunDecapsulation - You will need to download a software package called 48*4882a593SmuzhiyunMacGate. In this distribution there will be a tool called MacRoute 49*4882a593Smuzhiyunwhich enables you to add routes to the kernel for your Macs by hand. 50*4882a593SmuzhiyunAlso the tool MacRegGateWay is included to register the 51*4882a593Smuzhiyunproper IP Gateway and IP addresses for your machine. Included in this 52*4882a593Smuzhiyundistribution is a patch to netatalk-1.4b2+asun2.0a17.2 (available from 53*4882a593Smuzhiyunftp.u.washington.edu/pub/user-supported/asun/) this patch is optional 54*4882a593Smuzhiyunbut it allows automatic adding and deleting of routes for Macs. (Handy 55*4882a593Smuzhiyunfor locations with large Mac installations) 56*4882a593Smuzhiyun 57*4882a593SmuzhiyunEncapsulation - You will need to download a software daemon called ipddpd. 58*4882a593SmuzhiyunThis software expects there to be an AppleTalk-IP gateway on the network. 59*4882a593SmuzhiyunYou will also need to add the proper routes to route your Linux box's IP 60*4882a593Smuzhiyuntraffic out the ipddp interface. 61*4882a593Smuzhiyun 62*4882a593SmuzhiyunCommon Uses of ipddp.c 63*4882a593Smuzhiyun---------------------- 64*4882a593SmuzhiyunOf course AppleTalk-IP decapsulation and encapsulation, but specifically 65*4882a593Smuzhiyundecapsulation is being used most for connecting LocalTalk networks to 66*4882a593SmuzhiyunIP networks. Although it has been used on EtherTalk networks to allow 67*4882a593SmuzhiyunMacs that are only able to tunnel IP over EtherTalk. 68*4882a593Smuzhiyun 69*4882a593SmuzhiyunEncapsulation has been used to allow a Linux box stuck on a LocalTalk 70*4882a593Smuzhiyunnetwork to use IP. It should work equally well if you are stuck on an 71*4882a593SmuzhiyunEtherTalk only network. 72*4882a593Smuzhiyun 73*4882a593SmuzhiyunFurther Assistance 74*4882a593Smuzhiyun------------------- 75*4882a593SmuzhiyunYou can contact me (Jay Schulist <jschlst@samba.org>) with any 76*4882a593Smuzhiyunquestions regarding decapsulation or encapsulation. Bradford W. Johnson 77*4882a593Smuzhiyun<johns393@maroon.tc.umn.edu> originally wrote the ipddp.c driver for IP 78*4882a593Smuzhiyunencapsulation in AppleTalk. 79