Installation instructions  -  ATM on Linux, release 0.5 (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.5.tar.gz
 - Linux kernel 1.3.24
   ftp.funet.fi:/pub/OS/Linux/PEOPLE/Linus/v1.3/linux-1.3.24.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.5.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.5.patch

The distribution installs into the following directories:

  atm/		Documentation, kernel patch, top-level Makefile, and
		distribution scripts
  atm/sigd/	UNI 3.0 (and later UNI 3.1) signaling demon: atmsigd
		Test program: svc
  atm/qgen/	Q.2931-style message handling
  atm/maint/	ATM maintenance programs: atmdiag, atmdump, atmtcp, and
		sonetdiag
  atm/test/	Test programs: aread, awrite, br, bw, ttcp
  atm/ip/	IP over ATM: clip, atmarp
  atm/arpd/	ATMARP demon
  atm/debug/	Debugging tools: ed, en, encopy, endump, zndump
  atm/lib/	Libraries for applications and demons

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. There's also an option to enable
extended debugging in the ENI driver.

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. Use the SERIAL option of LILO to make
LILO use the serial console too.

Then build your kernel and reboot.

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

  atmtcp(itf 1): ready

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

  eni(itf 0): rev.0,base=0xff400000,irq=10,mem=512kB (00-20-EA-00-07-56)
  eni(itf 0): FPGA,MMF

(512kB for the -C version, 2048kB for the -S version.)

If you've configured the ZN1221 driver, you will get something like

  zatm(itf 1): rev.0,base=0xf800,irq=9,mem=128kB (00-20-D4-10-04-B0)
  zatm(itf 1): uPD98401 0.5 at 30.072 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 depend
  make
  make install

See the file USAGE for how to use them.
