arch/all-unix/devs/networks/eth/README

   1 README for tap.device
   2 ---------------------
   3
   4 eth.device is a SANA-II-compliant network driver that allows AROS running in
   5 hosted environments to access the network via the host operating system
   6 (currently Linux only).
   7
   8 This driver is early alpha. Its unfinished in places, and there are probably
   9 several groovy bugs about.
  10
  11 REQUIREMENTS
  12
  13  - AROS hosted running as the root user
  14  - A free ethernet device (ie eth0) which the driver will open in
  15    promiscuous mode
  16
  17 INSTALLATION
  18
  19  - Build AROS as normal
  20
  21  - As root, start AROS
  22
  23     # linux/AROSBootstrap
  24
  25  - Edit SYS:System/Network/AROSTCP/db/interfaces and add the
  26    following line:
  27
  28    eth0 DEV=DEVS:networks/eth.device UNIT=0
  29
  30  - Start AROSTCP
  31
  32    > execute SYS:System/Network/AROSTCP/S/startnet
  33
  34 Thats it. AROS can now reach the Linux host's network device on ethN.
  35
  36
  37 NOTES
  38
  39 The driver is extremely verbose. I'm leaving the debug output in place until I
  40 consider the code to be stable. If you want to disable it, edit
  41 arch/all-unix/devs/networks/tap/tap.h and redefine DEBUG to be 0, then
  42 recompile.
  43
  44 The unit number and Linux interface name are linked such that opening unit #0
  45 on the Amiga side will result in attachment to interface eth0 on the Linux
  46 side, unit #1 -> eth1, etc. By default, the driver can handle up to 32
  47 units; this can be increased by changing MAX_ETH_UNITS in eth.h.
  48
  49 BUG REPORTING
  50
  51 You'll undoubtedly have problems; this is very new code. Please send reports,
  52 feedback and other comments to me at jason.mcmullan@gmail.com
  53
  54 If you are having a problem, I'm probably going to ask for debug output, and
  55 possibly steps to reproduce the problem.
  56
  57 COPYRIGHT & LICENSE
  58
  59 Copyright (c) 2013 Jason McMullan. All rights reserved.
  60 Copyright (c) 2007 Robert Norris. All rights reserved.
  61
  62 This program is free software; you can redistribute it and/or modify it under
  63 the same terms as AROS itself.