Blame view

Documentation/networking/ipddp.txt 3.19 KB
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
  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
  =======================================
1da177e4c   Linus Torvalds   Linux-2.6.12-rc2
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
  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.