0001 .. SPDX-License-Identifier: GPL-2.0
0002
0003 =========================================================
0004 AppleTalk-IP Decapsulation and AppleTalk-IP Encapsulation
0005 =========================================================
0006
0007 Documentation ipddp.c
0008
0009 This file is written by Jay Schulist <jschlst@samba.org>
0010
0011 Introduction
0012 ------------
0013
0014 AppleTalk-IP (IPDDP) is the method computers connected to AppleTalk
0015 networks can use to communicate via IP. AppleTalk-IP is simply IP datagrams
0016 inside AppleTalk packets.
0017
0018 Through this driver you can either allow your Linux box to communicate
0019 IP over an AppleTalk network or you can provide IP gatewaying functions
0020 for your AppleTalk users.
0021
0022 You can currently encapsulate or decapsulate AppleTalk-IP on LocalTalk,
0023 EtherTalk and PPPTalk. The only limit on the protocol is that of what
0024 kernel AppleTalk layer and drivers are available.
0025
0026 Each mode requires its own user space software.
0027
0028 Compiling AppleTalk-IP Decapsulation/Encapsulation
0029 ==================================================
0030
0031 AppleTalk-IP decapsulation needs to be compiled into your kernel. You
0032 will need to turn on AppleTalk-IP driver support. Then you will need to
0033 select ONE of the two options; IP to AppleTalk-IP encapsulation support or
0034 AppleTalk-IP to IP decapsulation support. If you compile the driver
0035 statically you will only be able to use the driver for the function you have
0036 enabled in the kernel. If you compile the driver as a module you can
0037 select what mode you want it to run in via a module loading param.
0038 ipddp_mode=1 for AppleTalk-IP encapsulation and ipddp_mode=2 for
0039 AppleTalk-IP to IP decapsulation.
0040
0041 Basic instructions for user space tools
0042 =======================================
0043
0044 I will briefly describe the operation of the tools, but you will
0045 need to consult the supporting documentation for each set of tools.
0046
0047 Decapsulation - You will need to download a software package called
0048 MacGate. In this distribution there will be a tool called MacRoute
0049 which enables you to add routes to the kernel for your Macs by hand.
0050 Also the tool MacRegGateWay is included to register the
0051 proper IP Gateway and IP addresses for your machine. Included in this
0052 distribution is a patch to netatalk-1.4b2+asun2.0a17.2 (available from
0053 ftp.u.washington.edu/pub/user-supported/asun/) this patch is optional
0054 but it allows automatic adding and deleting of routes for Macs. (Handy
0055 for locations with large Mac installations)
0056
0057 Encapsulation - You will need to download a software daemon called ipddpd.
0058 This software expects there to be an AppleTalk-IP gateway on the network.
0059 You will also need to add the proper routes to route your Linux box's IP
0060 traffic out the ipddp interface.
0061
0062 Common Uses of ipddp.c
0063 ----------------------
0064 Of course AppleTalk-IP decapsulation and encapsulation, but specifically
0065 decapsulation is being used most for connecting LocalTalk networks to
0066 IP networks. Although it has been used on EtherTalk networks to allow
0067 Macs that are only able to tunnel IP over EtherTalk.
0068
0069 Encapsulation has been used to allow a Linux box stuck on a LocalTalk
0070 network to use IP. It should work equally well if you are stuck on an
0071 EtherTalk only network.
0072
0073 Further Assistance
0074 -------------------
0075 You can contact me (Jay Schulist <jschlst@samba.org>) with any
0076 questions regarding decapsulation or encapsulation. Bradford W. Johnson
0077 <johns393@maroon.tc.umn.edu> originally wrote the ipddp.c driver for IP
0078 encapsulation in AppleTalk.
