Configuration Parameters for the ATM LANE Device Driver

Edit online

The ATM LANE device driver supports the following configuration parameters for each LE Client:

Item Description
addl_drvr Specifies the CDLI demultiplexer being used by the LE Client. The value set by the ATM LANE device driver is /usr/lib/methods/cfgdmxtok for Token Ring emulation and /usr/lib/methods/cfgdmxeth for Ethernet. This is not an operator-configurable attribute.
addl_stat Specifies the routine being used by the LE client to generate device-specific statistics for the entstat and tokstat commands. The values set by the ATM LANE device driver are:
  • /usr/sbin/atmle_ent_stat
  • /usr/sbin/atmle_tok_stat

The addl_stat attribute is not operator-configurable.
arp_aging_time Specifies the maximum timeout period (in seconds) that the LE Client maintains an LE_ARP cache entry without verification (ATM Forum LE Client parameter C17). The default value is 300 seconds.
arp_cache_size Specifies the maximum number of LE_ARP cache entries that are held by the LE Client before removing the least recently used entry. The default value is 128 entries.
arp_response_timeout Specifies the maximum timeout period (in seconds) for LE_ARP request/response exchanges (ATM Forum LE Client parameter C20). The default value is 1 second.
atm_device Specifies the logical name of the physical ATM device driver that this LE Client is to operate with, as specified in the CuDv database (for example, atm0, atm1, atm2, ...). The default is atm0.
auto_cfg Specifies whether the LE Client is to be automatically configured. Select Yes if the LAN Emulation Configuration Server (LECS) is to be used by the LE Client to obtain the ATM address of the LE ARP Server, as well as any additional configuration parameters provided by the LECS. The default value is No (manual configuration). The attribute values are:
Yes
auto configuration
No
manual configuration
Note: Configuration parameters provided by LECS override configuration values provided by the operator.
debug_trace Specifies whether this LE Client should keep a real time debug log within the kernel and allow full system trace capability. Select Yes to enable full tracing capability for this LE Client. Select No for optimal performance when minimal tracing is desired. The default is Yes (full tracing capability).
elan_name Specifies the name of the Emulated LAN this LE Client wishes to join (ATM Forum LE Client parameter C5). This is an SNMPv2 DisplayString of 1-32 characters, or it might be left blank (unused). See RFC1213 for a definition of an SNMPv2 DisplayString.
Note:
  1. Any operator configured elan_name should match exactly what is expected at the LECS/LES server when attempting to join an ELAN. Some servers can alias the ELAN name and allow the operator to specify a logical name that correlates to the actual name. Other servers might require the exact name to be specified.

    Previous versions of LANE would accept any elan_name from the server, even when configured differently by the operator. However, with multiple LECS/LES now possible, it is desirable that only the ELAN identified by the network administrator is joined. Use the force_elan_name attribute below to ensure that the name you have specified is the only ELAN joined.

    If no elan_name attribute is configured at the LEC, or the force_elan_name attribute is disabled, the server can stipulate whatever elan_name is available.

    Failure to use an ELAN name that is identical to the server's when specifying the elan_name and force_elan_name attributes causes the LEC to fail the join process, with entstat/tokstat status indicating Driver Flag Limbo.

  2. Blanks can be inserted within an elan_name by typing a tilde (~) character whenever a blank character is desired. This allows a network administrator to specify an ELAN name with imbedded blanks as in the default of some servers.

    Any tilde (~) character that occupies the first character position of the elan_name remains unchanged (that is, the resulting name can start with a tilde (~) but all remaining tilde characters are converted to blanks).
failsafe_time Specifies the maximum timeout period (in seconds) that the LE Client attempts to recover from a network outage. A value of zero indicates that you should continue recovery attempts unless a nonrecoverable error is encountered. The default value is 0 (unlimited).
flush_timeout Specifies the maximum timeout period (in seconds) for FLUSH request/response exchanges (ATM Forum LE Client parameter C21). The default value is 4 seconds.
force_elan_name Specifies that the Emulated LAN Name returned from the LECS or LES servers must exactly match the name entered in the elan_name attribute above. Select Yes if the elan_name field must match the server configuration and join parameters. This allows a specific ELAN to be joined when multiple LECS and LES servers are available on the network. The default value is No, which allows the server to specify the ELAN Name.
fwd_delay_time Specifies the maximum timeout period (in seconds) that the LE Client maintains an entry for a non-local MAC address in its LE_ARP cache without verification, when the Topology Change flag is True (ATM Forum LE Client parameter C18). The default value is 15 seconds.
fwd_dsc_timeout Specifies the timeout period (in seconds) that can elapse without an active Multicast Forward VCC from the BUS. (ATM Forum LE Client parameter C33). If the timer expires without an active Multicast Forward VCC, the LE Client attempts recovery by re-establishing its Multicast Send VCC to the BUS. The default value is 60 seconds.
init_ctl_time Specifies the initial control timeout period (in seconds) for most request/response control frame interactions (ATM Forum LE Client parameter C7i). This timeout is increased by its initial value after each timeout expiration without a response, but does not exceed the value specified by the Maximum Control Timeout attribute (max_ctl_time). The default value is 5 seconds.
lan_type Identifies the type of local area network being emulated (ATM Forum LE Client parameter C2). Both Ethernet/IEEE 802.3 and Token Ring LANs can be emulated using ATM Forum LANE. The attribute values are:
  • Ethernet/IEEE802.3
  • TokenRing
lecs_atm_addr If you are doing auto configuration using the LE Configuration Server (LECS), this field specifies the ATM address of LECS. It can remain blank if the address of LECS is not known and the LECS is connected by way of PVC (VPI=0, VCI=17) or the well-known address, or is registered by way of ILMI. If the 20-byte address of the LECS is known, it must be entered as hexadecimal numbers using a period (.) as the delimiter between bytes. Leading zeros of each byte can be omitted, for example: 

47.0.79.0.0.0.0.0.0.0.0.0.0.0.0.a0.3.0.0.1

(the LECS well-known address)
les_atm_addr If you are doing manual configuration (without the aid of an LECS), this field specifies the ATM address of the LE ARP Server (LES) (ATM Forum LE Client parameter C9). This 20-byte address must be entered as hexadecimal numbers using a period (.) as the delimiter between bytes. Leading zeros of each byte can be omitted, for example: 

39.11.ff.22.99.99.99.0.0.0.0.1.49.10.0.5a.68.0.a.1
local_lan_addrs Specifies the local unicast LAN MAC address that is represented by this LE Client and registered with the LE Server (ATM Forum LE Client parameter C6). This 6-byte address must be entered as hexadecimal numbers using a period (.) as the delimiter between bytes. Leading zeros of each byte can be omitted. 

Ethernet Example: 2.60.8C.2C.D2.DC
Token Ring Example: 10.0.5A.4F.4B.C4
max_arp_retries Specifies the maximum number of times an LE_ARP request can be retried (ATM Forum LE Client parameter C13). The default value is 1.
max_config_retries Specifies the number of times a configuration control frame such as LE_JOIN_REQUEST should be retried. Duration (in seconds) between retries is derived from the init_ctl_time and max_ctl_time attributes. The default is 1.
max_ctl_time Specifies the maximum timeout period (in seconds) for most request and response control frame interactions (ATM Forum LE Client parameter C7). The default value is 30 seconds.
max_frame_size Specifies the maximum AAL-5 send data-unit size of data frames for this LE Client. In general, this value should coincide with the LAN type and speed as follows:
Unspecified
for auto LECS configuration
1516 bytes
for Ethernet and IEEE 802.3 networks
4544 bytes
for 4 Mbps Token Rings or Ethernet jumbo frames
9234 bytes
for 16 Mbps Token Rings or Ethernet jumbo frames
18190 bytes
for 16 Mbps Token Rings or Ethernet jumbo frames
max_queued_frames Specifies the maximum number of outbound packets that are held for transmission per LE_ARP cache entry. This queueing occurs when the Maximum Unknown Frame Count (max_unknown_fct) has been reached, or when flushing previously transmitted packets while switching to a new virtual channel. The default value is 60 packets.
max_rdy_retries Specifies the maximum number of READY_QUERY packets sent in response to an incoming call that has not yet received data or a READY_IND packet. The default value is 2 retries.
max_unknown_fct Specifies the maximum number of frames for a given unicast LAN MAC address that can be sent to the Broadcast and Unknown Server (BUS) within time period Maximum Unknown Frame Time (max_unknown_ftm) (ATM Forum LE Client parameter C10). The default value is 1.
max_unknown_ftm Specifies the maximum timeout period (in seconds) that a given unicast LAN address can be sent to the Broadcast and Unknown Server (BUS). The LE Client sends no more than Maximum Unknown Frame Count (max_unknown_fct) packets to a given unicast LAN destination within this timeout period (ATM Forum LE Client parameter C11). The default value is 1 second.
mpoa_enabled Specifies whether Forum MPOA and LANE-2 functions should be enabled for this LE Client. Select Yes if MPOA will be operational on the LE Client. Select No when traditional LANE-1 functionality is required. The default is No (LANE-1).
mpoa_primary Specifies whether this LE Client is to be the primary configurator for MPOA using LAN Emulation Configuration Server (LECS). Select Yes if this LE Client will be obtaining configuration information from the LECS for the MPOA Client. This attribute is only meaningful if running auto config with an LECS, and indicates that the MPOA configuration TLVs from this LEC is available to the MPC. Only one LE Client can be active as the MPOA primary configurator. The default is No.
path_sw_delay Specifies the maximum timeout period (in seconds) that frames sent on any path in the network take to be delivered (ATM Forum LE Client parameter C22). The default value is 6 seconds.
peak_rate Specifies the forward and backward peak bit rate in K-bits per second that are used by this LE Client to set up virtual channels. Specify a value that is compatible with the lowest speed remote device with which you expect this LE Client to be communicating. Higher values might cause congestion in the network. A value of zero allows the LE Client to adjust its peak_rate to the actual speed of the adapter. If the adapter does not provide its maximum peak rate value, the LE Client defaults its peak_rate to 25600. Any non-zero value specified is accepted and used by the LE Client up to the maximum value allowed by the adapter. The default value is 0, which uses the adapter's maximum peak rate.
ready_timeout Specifies the maximum timeout period (in seconds) in which data or a READY_IND message is expected from a calling party (ATM Forum LE Client parameter C28). The default value is 4 seconds.
ring_speed Specifies the Token Ring speed as viewed by the ifnet layer. The value set by the ATM LANE device driver is 16 Mbps for Token Ring emulation and ignored for Ethernet. This is not an operator-configurable attribute.
rx_checksum Specifies whether this LE Client should offload TCP receive checksums to the ATM hardware. Select Yes if TCP checksums should be handled in hardware. Select No if TCP checksums should be handled in software. The default is Yes (enable hardware receive checksum).
Note: The ATM adapter must also have receive checksum enabled to be functional.
soft_restart Specifies whether active data virtual circuits (VCs) are to be maintained during connection loss of ELAN services such as the LE ARP Server (LES) or Broadcast and Unknown Server (BUS). Normal ATM Forum operation forces a disconnect of data VCs when LES/BUS connections are lost. This option to maintain active data VCs might be advantageous when server backup capabilities are available. The default value is No.
vcc_activity_timeout Specifies the maximum timeout period (in seconds) for inactive Data Direct Virtual Channel Connections (VCCs). Any switched Data Direct VCC that does not transmit or receive data frames in this timeout period is terminated (ATM Forum LE Client parameter C12). The default value is 1200 seconds (20 minutes).