1Text file for ipddp.c: 2 AppleTalk-IP Decapsulation and AppleTalk-IP Encapsulation 3 4This text file is written by Jay Schulist <jschlst@samba.org> 5 6Introduction 7------------ 8 9AppleTalk-IP (IPDDP) is the method computers connected to AppleTalk 10networks can use to communicate via IP. AppleTalk-IP is simply IP datagrams 11inside AppleTalk packets. 12 13Through this driver you can either allow your Linux box to communicate 14IP over an AppleTalk network or you can provide IP gatewaying functions 15for your AppleTalk users. 16 17You can currently encapsulate or decapsulate AppleTalk-IP on LocalTalk, 18EtherTalk and PPPTalk. The only limit on the protocol is that of what 19kernel AppleTalk layer and drivers are available. 20 21Each mode requires its own user space software. 22 23Compiling AppleTalk-IP Decapsulation/Encapsulation 24================================================= 25 26AppleTalk-IP decapsulation needs to be compiled into your kernel. You 27will need to turn on AppleTalk-IP driver support. Then you will need to 28select ONE of the two options; IP to AppleTalk-IP encapsulation support or 29AppleTalk-IP to IP decapsulation support. If you compile the driver 30statically you will only be able to use the driver for the function you have 31enabled in the kernel. If you compile the driver as a module you can 32select what mode you want it to run in via a module loading param. 33ipddp_mode=1 for AppleTalk-IP encapsulation and ipddp_mode=2 for 34AppleTalk-IP to IP decapsulation. 35 36Basic instructions for user space tools 37======================================= 38 39I will briefly describe the operation of the tools, but you will 40need to consult the supporting documentation for each set of tools. 41 42Decapsulation - You will need to download a software package called 43MacGate. In this distribution there will be a tool called MacRoute 44which enables you to add routes to the kernel for your Macs by hand. 45Also the tool MacRegGateWay is included to register the 46proper IP Gateway and IP addresses for your machine. Included in this 47distribution is a patch to netatalk-1.4b2+asun2.0a17.2 (available from 48ftp.u.washington.edu/pub/user-supported/asun/) this patch is optional 49but it allows automatic adding and deleting of routes for Macs. (Handy 50for locations with large Mac installations) 51 52Encapsulation - You will need to download a software daemon called ipddpd. 53This software expects there to be an AppleTalk-IP gateway on the network. 54You will also need to add the proper routes to route your Linux box's IP 55traffic out the ipddp interface. 56 57Common Uses of ipddp.c 58---------------------- 59Of course AppleTalk-IP decapsulation and encapsulation, but specifically 60decapsulation is being used most for connecting LocalTalk networks to 61IP networks. Although it has been used on EtherTalk networks to allow 62Macs that are only able to tunnel IP over EtherTalk. 63 64Encapsulation has been used to allow a Linux box stuck on a LocalTalk 65network to use IP. It should work equally well if you are stuck on an 66EtherTalk only network. 67 68Further Assistance 69------------------- 70You can contact me (Jay Schulist <jschlst@samba.org>) with any 71questions regarding decapsulation or encapsulation. Bradford W. Johnson 72<johns393@maroon.tc.umn.edu> originally wrote the ipddp.c driver for IP 73encapsulation in AppleTalk. 74