Orange Pi5 kernel

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