|
AMnet documentationContact: flexinet-support@ibr.cs.tu-bs.de |
Actually AMnet is supported only for Linux kernel version 2.2.14 and 2.2.17. These sources can be found at http://www.linux.org. If you are not familiar with compiling and installing linux kernel you should read the Kernel-HOWTO, which is located at http://www.linuxdoc.org.
After having unpacked the kernel source you have to apply the matching AMnet patch (amnet_ltap_patch-2.2.14 or amnet_ltap_patch-2.2.17). This patches are located in the directory amnet/kernel/patches. For example: if you have extracted the kernel sources to /usr/src/linux-2.2.17, first copy the patch amnet_ltap_patch-2.2.17 to /usr/src/linux-2.2.17, change into that directory and then enter 'patch -p1 < amnet_ltap_patch-2.2.17'.
Now your kernel is ready to be configured for AMnet support. Start your favourite linux kernel configuration tool and activate the IBR Ltap support within the Networking options (of course you are free to activate other options for your special demands). WARNING: You must not activate "Socket Filtering" because it breaks LTAP support.
For general information about the kernel's compilation take a look at the Kernel-HOWTO.
The kernel modules (ltap, myfilter and socket_lt) provide low-level access to the network packets. The major task is the correct demultiplexing of incoming data to corresponding user space applications. A received packet should bypass normal kernel networking if an AMnet service is registered for it. The packet classification is based on the well-known Berkeley Packet Filter (BPF) and its extension Berkeley Packet Filter/Classifier (BPFX).
These modules are stored in the AMnet structure in the directory amnet/kernel/modules. That means that these kernel modules are not being compiled when invoking make modules out of the linux source path. Instead these kernel modules are being compiled during the AMnet compilation so you don't have to care about it. The only thing you have to make sure is that you have configured the correct path to the matching kernel sources. This can be done with the --kernel-dir option when invoking the AMnet configure script.