blob: 661a5558dd8e928f15771c07ef34b3ee9cb81e57 [file] [log] [blame]
Linus Torvalds1da177e2005-04-16 15:20:36 -07001Text 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
39To enable AppleTalk-IP decapsulation/encapsulation you will need the
40proper tools. You can get the tools for decapsulation from
41http://spacs1.spacs.k12.wi.us/~jschlst/index.html and for encapsulation
42from http://www.maths.unm.edu/~bradford/ltpc.html
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.