Platform Notes: The SunATM Driver Software

Editing the /etc/opt/SUNWconn/atm/laneconfig File

The /etc/opt/SUNWconn/atm/laneconfig file contains the required configuration information for each interface that uses LAN Emulation. One entry is required for each SunATM interface.

Each time you modify the /etc/opt/SUNWconn/atm/laneconfig file, run the LAN Emulation setup program (lanesetup). lanesetup is in the /etc/opt/SUNWconn/atm/bin directory.

Each /etc/opt/SUNWconn/atm/laneconfig entry follows this format:


Interface         MAC Address/      ATM Address  VCI  Flag
                  ELAN Name

These entry fields are described in Table 3-5.

Table 3-5 /etc/opt/SUNWconn/atm/laneconfig Entry Descriptions

Field 

Description 

Interface

Refers to the LAN Emulation interface, laneN.

MAC Address/ELAN Name

This field is for the 6-byte MAC address of the interface, or, in the case of an n entry, the name of the emulated LAN to join.

ATM Address

This field is for the 20-byte ATM address. The $myaddress variable assigns the local switch prefix, local MAC address, and default selector.

VCI

The VCI field is a positive decimal integer identifying a Permanent Virtual Circuit. Place a dash in this field if VCI is not used. 

Flag

This field identifies the type of entry. For a complete description of the laneconfig flags, see Table 3-6.

Table 3-6 describes the flags used in the /etc/opt/SUNWconn/atm/laneconfig file.

Table 3-6 /etc/opt/SUNWconn/atm/laneconfig Flag Descriptions

Flag 

Description 

l

This flag designates a local address entry. There must be an l entry for each interface running LAN Emulation. The interface and the ATM address must be included; the MAC address may be included (default is the MAC address assigned to the board).

t

This flag designates a table entry for the local MAC-ATM address resolution table. If you wish to avoid the address resolution process for a frequently accessed system, for instance, you may include a t entry for that system; you may also create PVCs with a t entry. The interface, MAC address, and either ATM address or VCI (for SVC or PVC connection, respectively) must be included.

n

This flag allows you to specify the name of an emulated LAN to join. By default, the SunATM implementation will use the name provided by the LECS. If you wish to specify a different name, or if your LECS requires that a user include a name in its requests, a name may be provided with this flag. Interface is required; the name should be entered in the second field. 

M

Notifies the system that a larger MTU size will be used in the ELAN which this lane instance will join. The default MTU size is 1500 bytes. With the M flag, you can set the MTU size to be either 4 Kbytes (4528 bytes) or 9 Kbytes (9218 bytes). 

a

Represents an address that may have access to this host. If no a entries appear in the laneconfig file, access to the host is unrestricted. Including a entries allows access to be restricted to known hosts. As an alternative to listing individual addresses, the ATM address field may contain a prefix, followed by the wildcard $anymacsel, which matches any 7-byte ESI/Selector combination following the given prefix. This allows access by any host connected to the switch specified by the given prefix. Mac Address and VCI should not appear; ATM Address is required. See Table 3-7.

c

This flag allows an alternate LECS address to be specified. By default, the SunATM software uses the well-known address specified in the LAN Emulation standard. If, however, your LECS has a different address, or you wish to connect to the LECS over a PVC, you may provide the alternate ATM address or VCI in a c entry. If you wish to make a PVC connection, the VCI must be 17, as required by the LAN Emulation standard. The interface and ATM address or VCI must be included. 

s

This flag specifies the LES address or VCI, and instructs the system to contact the LES directly, and to use default subnet configuration information. This flag should be used if your subnet does not have an LECS. Without this entry, the system first connects to the LECS, which provides the LES address and configuration information. 

m

Notifies the system that the entire ATM address, including the network prefix, must be configured manually on this interface. If your interface is connected to a switch that does not support ILMI address registration, you must include this option in your /etc/opt/SUNWconn/atm/aarconfig file. Note that the variables $myaddress, $prefix and $localswitch_server (which use the switch prefix obtained from the switch via ILMI) may not be used if ILMI address registration is disabled.

Table 3-7 describes the required, optional, and illegal fields for each flag type.

Table 3-7 laneconfig Flag Requirements and Options

Interface 

MAC Address/ELAN Name 

ATM Address 

VCI 

Flag 

required 

optional 

required 

illegal 

l

required 

required 

xor1

xor1

t

required 

Emulated LAN name 

illegal 

illegal 

n

required 

MTU Size in bytes 

illegal 

illegal 

M

required 

illegal 

required 

illegal 

a

required 

illegal 

xor1

xor 

c

required 

illegal 

xor1

xor 

s

required 

illegal 

illegal 

illegal 

m

1xor means that you can use either the ATM Address field or the VCI field, but not both.


Note -

Designate unused fields in the /etc/opt/SUNWconn/atm/laneconfig file with a dash.