atmelan(8)						      System Manager's Manual							atmelan(8)

NAME

       atmelan - Configures LAN-Emulation clients as network interfaces.

SYNOPSIS

       /usr/sbin/atmelan command arguments

OPTIONS

       This  section is organized by the tasks you can perform with the atmelan command.  Each task subsection provides the atmelan command syntax
       and the arguments to use to complete the tasks.

   Creating a LAN-Emulation Client
       Syntax:

       /usr/sbin/atmelan create driver=name [type=type] [mtu=mtu] [name=elan_name]

       [lecs=addr [,addr, addr, addr] | les=addr]

       [unit=unit_number | elan=unit_number]

       Creates a new LAN-Emulation Client (LEC) and configures it as a network interface.  If no additional arguments are specified, the  defaults
       are  802.3  type  and an MTU of 1516 bytes.  Specifies the physical interface with which to associate the new LEC.  Specifies the interface
       type. The following types are supported: Ethernet/802.3.  Specifies the message transfer unit (MTU) size. The following MTU sizes are  sup-
       ported: 1516, 4544, 9234, and 18190.  When specified with the name option, the emulated LAN must already be configured on the ATM switch to
       support the specified MTU size.	If it is not configured for the specified MTU size, the request is ignored.  Specifies	the  name  of  the
       emulated  LAN  to  join.   The  emulated  LAN  name must already be configured on the ATM switch.  If the name is not configured on the ATM
       switch, the LEC joins the default emulated LAN.

									      Note

	      You can join an emulated LAN on a switch only once for each adapter; do not join the same elan multiple times from the same adapter.
	      If  you  want  to join the same emulated LAN on the same switch, you must install another adapter and join the emulated LAN from it.
	      Specifies that the LEC connect to the LAN-Emulation Configuration Server (LECS) at the ATM address specified by the  addr  arguments
	      for  the	emulated  LAN  configuration.  You can specify up to 4 addresses.  The LEC tries the addresses in order until a successful
	      configuration has been completed. If all addresses fail, the "well known address" is tried before the process begins again.

	      If no lecs option is specified (default), the LEC connects to the LECS at the "well known address".

	      Do not use the lecs option with the les option.  Specifies that the LEC go directly to the LAN-Emulation Server  (LES)  at  the  ATM
	      address specified by addr argument and bypass the configuration phase.

	      If this argument is not specified, the LEC contacts a LAN-Emulation Configuration Server (LECS) to obtain a LES address.

	      Do not use the les option with the lecs option.  Specifies a LEC interface unit number.  Specifies an ELAN unit number.

       For  example,  to  create  an  emulated	LAN interface using Ethernet frame format and Fiber Distributed Data Interface (FDDI) frame sizes,
       enter: # atmelan create driver=lta0 mtu=4544

       To create an emulated LAN interface that bypasses the configuration phase and directly contacts a  LAN-Emulation  Server  (LES),  enter:  #
       atmelan create les=LES_A

       The ATM address is an alias that is in the /etc/atmhosts file.

   Detaching a LEC Interface from an ATM Network
       Syntax:

       /usr/sbin/atmelan detach

       unit=unit_number | elan=unit_number

       Detaches  a  LEC  interface  specified  by  either unit or elan arguments from an ATM network.  Specifies a LEC interface unit number.  The
       unit_number is obtained by the netstat -i command.  Specifies an ELAN unit number.  The unit_number is obtained by the netstat -i command.

   Attaching a LEC Interface to an ATM Network
       Syntax:

       /usr/sbin/atmelan attach driver=name

       unit=unit_number | elan=unit_number

       [lecs=addr [,addr, addr, addr] | les=addr]

       [name=elan_name] [type=type] [mtu=mtu]

       Attaches the specified, previously detached LEC network interface to an ATM network.  After the LEC interface is attached, issue the ifcon-
       fig elanx up command to configure the interface.  Specifies the physical interface with which to associate the LEC.  Specifies a LEC inter-
       face unit number.  This is the unit number that was previously detached.  Specifies an ELAN unit number.  This is the unit number that  was
       previously  detached.   Specifies that the LEC connect to the LAN-Emulation Configuration Server (LECS) at the ATM address specified by the
       addr arguments for the emulated LAN configuration.  You can specify up to 4 addresses.  The LEC tries the addresses in order until  a  suc-
       cessful configuration has been completed. If all addresses fail, the "well known address" is tried before the process begins again.

	      If no lecs option is specified (default), the LEC connects to the LECS at the "well known address".

	      Do  not  use  the  lecs option with the les option.  Specifies that the LEC go directly to the LAN-Emulation Server (LES) at the ATM
	      address specified by addr argument and bypass the configuration phase.

	      If this argument is not specified, the LEC contacts a LAN-Emulation Configuration Server (LECS) to obtain a LES address.

	      Do not use the les option with the lecs option.  Specifies the name of the emulated LAN to join.	The emulated LAN name must already
	      be  configured  on the ATM switch.  If the name is not configured on the ATM switch, the LEC joins the default emulated LAN.  Speci-
	      fies the interface type. The following types are supported: Ethernet/802.3.  Specifies the message transfer  unit  (MTU)	size.  The
	      following  MTU sizes are supported: 1516, 4544, 9234, and 18190.	When specified with the name option, the emulated LAN must already
	      be configured on the ATM switch to support the specified MTU size.  If it is not configured for the specified MTU size, the  request
	      is ignored.

   Displaying State and Counters for an LEC Interface
       Syntax:

       /usr/sbin/atmelan show | status [unit=unit_number]

       Shows  the state and counters for a LEC interface.  If no unit number is specified, information for LEC unit 0 (elan0) is displayed.  Shows
       the state and counters for a LEC interface.  If no unit number is specified, information for LEC unit 0 (elan0) is displayed.  Specifies  a
       LEC  interface  unit  number,  if  you  want to display LEC information for LEC unit numbers other than unit 0 (elan0).	The unit_number is
       obtained by the netstat -i command.  For example, unit 0 is elan0, unit 1 is elan1, and so on.

DESCRIPTION

       The atmelan command creates and configures LAN-Emulation Clients (LEC) as network interfaces.   The  first  interface  created  appears	as
       elan0, the second as elan1, and so on.  The atmelan command can also show counters, parameters, and the state of each LEC.

SEE ALSO

       Commands: atmconfig(8), atmsig(8), learp(8)

       Files: atmhosts(4)

       Asynchronous Transfer Mode

       Network Administration

																	atmelan(8)