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