/*
 * Marko Kiiskila carnil@cs.tut.fi 
 * 
 * Tampere University of Technology - Telecommunications Laboratory
 *
 */

LAN Emulation Package
=====================
Lan Emulation Daemon (LED) Zeppelin & kernel driver. Description
of LAN-E can be found from ATM Forum's specification "LAN Emulation
Over ATM - Version 1.0". 
ftp://ftp.atmforum.com/pub/specs/af-lane-0021.000.ps.Z

Usage:
======
In order to use LE one has to compile kernel with LANE support.

zeppelin [-c LECS_address]|[-s LES_address] [-e esi] [-n VLAN_name]
         [-m msg_mask] [-l listen_address]

LECS_address: ATM address of Lan Emulation Configuration Server, if not
set, Well-Known server address is used.

LES_address: ATM address of Lan Emulation Server, can be used to
bypass configuration phase in joining emulated Lan i.e LECS address
is not used.

Esi: Mac address to use when communicating in Emulated LAN

VLAN_name: Name of the virtual LAN to which joining is requested.

msg_mask: Sometimes one wants to know more what is happening in LE
daemon e.g. when nothing works. This is a hexadecimal long value
setting global message mask. 0 = No messages, ffff = All messages.
Purpose of different mask values is shown in source file g_event.h.

listen_address: ATM address that zeppelin uses in signalling.

e.g. 
> zeppelin -c coral_lecs -n tut-lane1 &
> ifconfig lec0 viulu.lane.tut.fi netmask 255.255.255.0
> route add -net 193.166.165.0
> netstat -nr

Suggested way of running LAN-E is via two scripts:
/etc/rc.d/rc.atm:
----8<-----
#/bin/sh
/usr/local/bin/atmsigd -b
/usr/local/bin/ilmid -b
sleep 2
/usr/local/bin/zeppelin.sh &
/sbin/ifconfig lec0 viulu.lane.tut.fi netmask 255.255.255.0
route add -net 193.166.165.0
----8<-----

/usr/local/bin/zeppelin.sh:
----8<-----
#/bin/sh

while [ 1 ]; do
  /usr/local/bin/zeppelin -c coral_lecs -m 3
  sleep 30
done
----8<-----

Wrapper scripts aren't really needed anymore. This is because demon
code is becoming more stable and won't (hopefully) crash :)

Known limitations:
------------------
Supports only 802.3 type of Emulated LANs.
Tested only with DIX Ethernet data frame.
Possibility for only one VLAN interface

