ILMI for ATM on Linux 0.6 by Scott W. Shumate (shumate@tisl.ukans.edu)
----------------------------------------------------------------------
This distribution contains the ILMI agent for the ATM on Linux effort.
The agent supports only the address registration procedures specified
in section 5.8 of the ATM Forum's UNI 3.1 specification.  These
procedures involve the switch registering the network prefix on the
host and the host registering the final ATM address back on the
switch.  The host accomplishes this by appending an ESI (End System
Identifier) and a null selector byte to the network prefix registered
by the switch.  The ESI is the physical or MAC address of the ATM
interface.

None of the other MIB objects in the ILMI specification are currently
supported.  Additional MIB objects may be added at a later date.

The agent was tested with several different switches: the Fore
ASX-200BX, the UB Networks GeoSwitch, and the Digital GIGAswitch.  In
all cases, an ATM address was successfully registered with the switch
and configured with the atmarp daemon.

Availability
------------
The ILMI agent is released as free software under the copyright
restrictions given in the file COPYRIGHT and the code.  The ILMI agent
is available via anonymous ftp at:

	tisl.ukans.edu in /pub/ilmid 

A HTML version of this document is available at:

	http://www.tisl.ukans.edu/~shumate/ilmi.html

Usage:
------
The ILMI agent requires one parameter on the command line, the name of
the IP interface configured with atmarp:

	ilmid [-b] [-d] <IP interface> 

The two optional switches are -b, background the daemon, and -d, debug
mode.  The agent registers the host's ATM address with the switch and
configures the atmarp daemon with that address.  There is no way to
dynamically configure the ARP server's ATM address.  This is a fault
with the standards, not the agent.

To configure a host with UNI signaling and RFC 1577 support, use the
following commands:

	/usr/src/atm/sigd/atmsigd -b
	/usr/src/atm/arpd/atmarpd -b
	/usr/src/atm/ip/atmarp -c atm0
	/sbin/ifconfig atm0 <ip address>
	/sbin/route add -net <network>
	/usr/src/atm/ilmid/ilmid -b atm0
	/usr/src/atm/ip/atmarp -s <network> <arp server address> arpsrv

The ILMI agent must be executed after the atmarp daemon is started and
the IP address and network route of the IP interface are set.  This is
because the agent needs to know the IP address and network mask in
order to configure the atmarp daemon with the registered ATM address.

