| Text file for ipddp.c: | |
| AppleTalk-IP Decapsulation and AppleTalk-IP Encapsulation | |
| This text file is written by Jay Schulist <jschlst@samba.org> | |
| Introduction | |
| ------------ | |
| AppleTalk-IP (IPDDP) is the method computers connected to AppleTalk | |
| networks can use to communicate via IP. AppleTalk-IP is simply IP datagrams | |
| inside AppleTalk packets. | |
| Through this driver you can either allow your Linux box to communicate | |
| IP over an AppleTalk network or you can provide IP gatewaying functions | |
| for your AppleTalk users. | |
| You can currently encapsulate or decapsulate AppleTalk-IP on LocalTalk, | |
| EtherTalk and PPPTalk. The only limit on the protocol is that of what | |
| kernel AppleTalk layer and drivers are available. | |
| Each mode requires its own user space software. | |
| Compiling AppleTalk-IP Decapsulation/Encapsulation | |
| ================================================= | |
| AppleTalk-IP decapsulation needs to be compiled into your kernel. You | |
| will need to turn on AppleTalk-IP driver support. Then you will need to | |
| select ONE of the two options; IP to AppleTalk-IP encapsulation support or | |
| AppleTalk-IP to IP decapsulation support. If you compile the driver | |
| statically you will only be able to use the driver for the function you have | |
| enabled in the kernel. If you compile the driver as a module you can | |
| select what mode you want it to run in via a module loading param. | |
| ipddp_mode=1 for AppleTalk-IP encapsulation and ipddp_mode=2 for | |
| AppleTalk-IP to IP decapsulation. | |
| Basic instructions for user space tools | |
| ======================================= | |
| To enable AppleTalk-IP decapsulation/encapsulation you will need the | |
| proper tools. You can get the tools for decapsulation from | |
| http://spacs1.spacs.k12.wi.us/~jschlst/index.html and for encapsulation | |
| from http://www.maths.unm.edu/~bradford/ltpc.html | |
| I will briefly describe the operation of the tools, but you will | |
| need to consult the supporting documentation for each set of tools. | |
| Decapsulation - You will need to download a software package called | |
| MacGate. In this distribution there will be a tool called MacRoute | |
| which enables you to add routes to the kernel for your Macs by hand. | |
| Also the tool MacRegGateWay is included to register the | |
| proper IP Gateway and IP addresses for your machine. Included in this | |
| distribution is a patch to netatalk-1.4b2+asun2.0a17.2 (available from | |
| ftp.u.washington.edu/pub/user-supported/asun/) this patch is optional | |
| but it allows automatic adding and deleting of routes for Macs. (Handy | |
| for locations with large Mac installations) | |
| Encapsulation - You will need to download a software daemon called ipddpd. | |
| This software expects there to be an AppleTalk-IP gateway on the network. | |
| You will also need to add the proper routes to route your Linux box's IP | |
| traffic out the ipddp interface. | |
| Common Uses of ipddp.c | |
| ---------------------- | |
| Of course AppleTalk-IP decapsulation and encapsulation, but specifically | |
| decapsulation is being used most for connecting LocalTalk networks to | |
| IP networks. Although it has been used on EtherTalk networks to allow | |
| Macs that are only able to tunnel IP over EtherTalk. | |
| Encapsulation has been used to allow a Linux box stuck on a LocalTalk | |
| network to use IP. It should work equally well if you are stuck on an | |
| EtherTalk only network. | |
| Further Assistance | |
| ------------------- | |
| You can contact me (Jay Schulist <jschlst@samba.org>) with any | |
| questions regarding decapsulation or encapsulation. Bradford W. Johnson | |
| <johns393@maroon.tc.umn.edu> originally wrote the ipddp.c driver for IP | |
| encapsulation in AppleTalk. |