Installation instructions  -  ATM on Linux, release 0 (pre-alpha)
-----------------------------------------------------------------

This is experimental software. There are known major bugs and certainly
even many more yet unknown problems. Internal and external interfaces are
far from being stable. In fact, they change daily. Use at your own risk.

In order to install this package, you need
 - the package itself, of course
   lrcftp.epfl.ch:/pub/linux/atm/aol.0.tar.gz
 - Linux kernel 1.2.5
   ftp.funet.fi:/pub/OS/Linux/PEOPLE/Linus/v1.2/linux-1.2.5.tar.gz
 - Netset 3
   ftp.linux.org.uk:/pub/tmp/linux-netset-3.tar.gz
 - upgrade to Netset 4
   ftp.linux.org.uk:/pub/tmp/linux-net3set-3to4.tar.gz
 - modified Netset 4 kernel patch
   lrcftp.epfl.ch:/pub/linux/atm/kernel-patch-netset-4.hacked

All the files can be found in lrcftp.epfl.ch:/pub/linux/atm

First, create a directory in which the linux/ kernel source directory
and the ATM on Linux distribution directory (aol/) should be created,
and put all the files listed above there. Then extract the ATM on Linux
distribution

  tar xfz aol.0.tar.gz

and the kernel source

  tar xfz linux-1.2.5.tar.gz

Extract Netset 3 over the kernel source

  tar xfz linux-netset-3.tar.gz

Next, extract the upgrade to Netset 4 in the linux/ subdirectory

  cd linux
  tar xfz ../linux-net3set-3to4.tar.gz

and remove the now obsolete net/inet directory tree (yes, I'm serious).

  rm -rf net/inet

Next, apply the kernel patch for Netset 4

  patch -s -p0 <../kernel-patch-netset-4.hacked

Finally, you can extract the ATM-related patches:

  patch -s -p1 <../aol/atm.0.patch

Now, change links (if necessary) and do the usual  make config
You should find the following new options:

  Serial console support (CONFIG_SERIAL_CONSOLE)
  Enable MMU performance hacks (CONFIG_MMU_HACKS)
  Asynchronous Transfer Mode (ATM) (CONFIG_ATM)
  ATM over TCP (CONFIG_ATM_TCP)
  Efficient Networks ENI155P (CONFIG_ATM_ENI)
  ZeitNet ZN1221 (CONFIG_ATM_ZATM)

The ZN1221 driver should not be enabled. The MMU hacks de-stabilize
the system but may improve performance. Currently, they _must_ be
enabled to properly compile all parts of the ATM package.

Then build your kernel and reboot.

If you've configured the ATM over TCP driver, you should see eight lines
like this one:

  atm1: atmtcp ready

If you've configured the ENI155P-MF driver, you should see one line like
this one:

  atm0: eni rev. 0,base=0xff400000,irq=9,mem=512kB,UTOPIA (00-20-EA-00-07-56)

(512kB for the -C version, 2048kB for the -S version. The "UTOPIA" is
misleading but that's how at least my boards identify themselves. I have
no idea whether the driver works with UTP-5 versions too.)

If you've configured the ZN1221 driver, you will probably see something
strange, because the driver isn't ready yet.

Now, as the final step, build the ATM tools:

  cd wherever/aol
  make

If you also want ttcp (there's a version supporting some ATM features
in lrcftp.epfl.ch:/pub/linux/atm), compile it with

  gcc -O2 -o ttcp.atm ttcp.atm.c

See the file USAGE for how to use them.
