Installation instructions  -  ATM on Linux, release 0.3 (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 almost 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/dist/atm-0.3.tar.gz
 - Linux kernel 1.3.12
   ftp.funet.fi:/pub/OS/Linux/PEOPLE/Linus/v1.3/linux-1.3.12.tar.gz

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

  tar xfz atm-0.3.tar.gz

and the kernel source

  tar xfz linux-1.3.12.tar.gz

Finally, you can extract the ATM-related patches:

  cd linux
  patch -s -p1 <../atm/atm-0.3.patch

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

  Asynchronous Transfer Mode (ATM) (CONFIG_ATM)
  ATM over TCP (CONFIG_ATM_TCP)
  Efficient Networks ENI155P (CONFIG_ATM_ENI)
  ZeitNet ZN1221 (CONFIG_ATM_ZATM)

Note that the "MMU hacks" are not included in this version, because the
structure of skbuffs has changed.

Support for a simple type of serial consoles is automatically added by the
ATM patch. If you're using LILO, you can enable it by putting a line like

append="scon=N"

with N indicating the serial port (equal to the first number in the
serial=  line) into /etc/lilo.conf.

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 get something like

  atm0: zatm rev.0,base=0xf800,irq=9,mem=128kB (00-20-D4-10-04-B0)
  atm0: uPD98401 0.5 at 30.264 MHz

plus a few strange debugging messages, because the driver isn't ready
yet.

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

  cd ../atm
  make
  make install

If you also want ttcp (the version in the Linux ATM distribution supports
some ATM features; the original is on ftp.sgi.com in /sgi/src/ttcp),
compile it with

  make ttcp.atm

See the file USAGE for how to use them.
