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
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
73
|
aranym.xif
==========
The MiNT-Net xif driver for the ARAnyM ethernet interface.
Installation and usage
----------------------
On host side (linux):
---------------------
Make sure the 'aratapif' (ARAnyM TAP IFconfig) binary is installed somewhere
in your $PATH (/usr/bin or /usr/local/bin) and that it is installed setuid
root. If it's not use the following commands (run them as root):
linux:~# chown root /usr/bin/aratapif
linux:~# chmod u+s /usr/bin/aratapif
Another important thing is to load the tuntap device driver (if it isn't
compiled in the host kernel). I load it with the following command:
linux:~# modprobe tun
And before loading this driver please check (and possibly fix) the
read/write permissions of the "/dev/net/tun" device:
linux:~# chmod a+rw /net/dev/tun
Otherwise ARAnyM started by regular user could not access this device.
More information about TUN/TAP you'll find at http://vtun.sourceforge.net/tun/
On Atari side:
--------------
Install MiNT-Net and copy the aranym.xif into your mint folder.
Then configure the eth0 interface, best by calling the 'eth0-config.sh'
script.
If you wanted to configure the IP addresses or netmask, you could do that
in the ARAnyM config file.
Then in MiNT-Net you can e.g. ping to 192.168.0.1 (which is the default IP
of the TAP tunnel's host side).
How it works
------------
The ARAnyM establishes the TAP interface (using tuntap driver).
tuntap linux driver: /usr/src/linux/Documentation/networking/tuntap.txt
Some related info can be found at the following URLs:
VTUN (virtual tunnel)
http://vtun.sourceforge.net/tun
Hercules (s390 emulator)
http://www.conmicro.cx/hercules/
Compilation
-----------
aranym.xif:
* you need the source tree of FreeMiNT 1.16 (use
CVS head branch) and if compiling on host, don't forget to edit
freemint's CONFIGVARS and enable the CROSS=yes there. Point the
FREEMINT_SRC_HOME environment variable to its home (the
COPYING.MiNT file is there).
* use make.sh to compile
* the binaries are placed into the bin subfolder
nfeth-config:
* regular MiNT setup is able to compile it with simple 'make nfeth-config'
ARAnyM itself:
* run configure with --enable-ethernet
|
