atmelan(8)atmelan(8)NAMEatmelan - 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 supported: 1516,
4544, 9234, and 18190. When specified with the name option, the emu‐
lated 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-Emula‐
tion 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-Emula‐
tion 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 ifconfig
elanx up command to configure the interface. Specifies the physical
interface with which to associate the LEC. Specifies a LEC interface
unit number. This is the unit number that was previously detached.
Specifies an ELAN unit number. This is the unit number that was previ‐
ously 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 successful con‐
figuration 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-Emula‐
tion 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. Specifies the interface type. The following types are sup‐
ported: 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 emu‐
lated LAN must already be configured on the ATM switch to sup‐
port 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 speci‐
fied, 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: Connections
atmelan(8)