unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



atmelan(8)							   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]

  create
      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.

  driver=name
      Specifies	the physical interface with which to associate the new LEC.

  type=type
      Specifies	the interface type. The	following types	are supported: Ether-
      net/802.3.

  mtu=mtu
      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.

  name=elan_name
      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	con-
      figured 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.

  lecs=addr [,addr, addr, addr]
      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.

  les=addr
      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.

  unit=unit_number
      Specifies	a LEC interface	unit number.

  elan=unit_number
      Specifies	an ELAN	unit number.

  For example, to create an emulated LAN interface using Ethernet frame	for-
  mat 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

  detach
      Detaches a LEC interface specified by either unit	or elan	arguments
      from an ATM network.

  unit=unit_number
      Specifies	a LEC interface	unit number.  The unit_number is obtained by
      the netstat -i command.

  elan=unit_number
      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]

  attach
      Attaches the specified, previously detached LEC network interface	to an
      ATM network.  After the LEC interface is attached, issue the ifconfig
      elanx up command to configure the	interface.

  driver=name
      Specifies	the physical interface with which to associate the LEC.

  unit=unit_number
      Specifies	a LEC interface	unit number.  This is the unit number that
      was previously detached.

  elan=unit_number
      Specifies	an ELAN	unit number.  This is the unit number that was previ-
      ously detached.

  lecs=addr [,addr, addr, addr]
      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.

  les=addr
      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.

  name=elan_name
      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	con-
      figured on the ATM switch, the LEC joins the default emulated LAN.

  type=type
      Specifies	the interface type. The	following types	are supported:
      Ethernet/802.3.

  mtu=mtu
      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]

  show
      Shows the	state and counters for a LEC interface.	 If no unit number is
      specified, information for LEC unit 0 (elan0) is displayed.

  status
      Shows the	state and counters for a LEC interface.	 If no unit number is
      specified, information for LEC unit 0 (elan0) is displayed.

  unit=unit_number
      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: Connections