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