Index Index for
Section 8
Index Alphabetical
listing for L
Bottom of page Bottom of
page

lan_config(8)

NAME

lan_config - Modifies low-level configuration parameters for a given LAN interface

SYNOPSIS

/usr/sbin/lan_config -i interface_name [-a [0 | 1]] [-m [aui | bnc | utp | fiber]] [-s [10 | 100 | 1000]] [-x [0 | 1]]

OPTIONS

-i interface_name Changes the specified characteristics for interface_name. You must provide an interface name. -a [0|1] Enables (1) or disables (0) IEEE 802.3u autonegotiation. This option applies only to those devices that are capable of autonegotiation (for example, DE500-AA and DE500-BA). When enabled, the interface automatically negotiates the link speed (10, 100, or 1000 Mb/s) and the mode (half-duplex or full-duplex) with the remote interface. Note The interface initiates the autonegotiation process only if and when it is up and running. See ifconfig(8) for information on how the interface is marked up. For DE5xx devices, the interface initially advertises the speed and mode previously selected at the console level or with the -s and -x options. The -s and -x options may also be specified on the same command line as the -a option to redefine and renegotiate the interface's capability (when enabled) or to force the interface at a certain configuration (when disabled). -m [aui|bnc|utp|fiber] Changes the type of medium. The following table lists the supported types: ___________________________________________________________ Type Meaning ___________________________________________________________ aui 10Base5, or thick wire bnc 10Base2, or ThinWire utp 10BaseT (if speed is 10 Mb/s) or 100BaseT (if speed is 100 Mb/s), or twisted-pair fiber 100BaseFX only ___________________________________________________________ On some devices, for example, DE435 and DE425, bnc selection is done by means of an on-board gang jumper. When specifying aui or bnc for these devices, be sure that the jumper is in the correct position. -s [10|100|1000] Changes the medium speed, if the interface is capable of operating at both regular (10 Mb/s), fast (100 Mb/s), and gigabit (1000 Mb/s) Ethernet speeds. The default is 10 Mb/s. The fast and gigabit speeds cannot be selected for the aui and bnc media. -x [1|0] Enables (1) or disables (0) full-duplex operation when the utp medium is specified. The default is to disable full-duplex operation.

DESCRIPTION

The lan_config command allows you to modify the type of medium, speed, and mode of operation (half- or full-duplex). You can also use the lan_config command to enable or disable autonegotiation, if the underlying device has this capability. Autonegotiation is a hardware and software (driver) process that allows determination of the highest common speed and duplex (half or full) configuration. The permitted combinations of speed and mode of operation in descending order of precedence, from the highest to the lowest, are: _______________________ Speed Mode _______________________ 1000 Mb/s full-duplex 1000 Mb/s half-duplex 100 Mb/s full-duplex 100 Mb/s half-duplex 10 Mb/s full-duplex 10 Mb/s half-duplex _______________________ During autonegotiation, for example, if the local interface advertises that it is capable of 100 Mb/s half-duplex operation, it is by implication also capable of 10 Mb/s, full-duplex and 10 Mb/s, half-duplex operation. If the remote interface advertises that it is capable of 10 Mb/s, full-duplex operation only, the link is established at 10 Mb/s, full-duplex. The autonegotiation process can take several seconds to complete. For DE5xx devices (tu), the characteristics managed with the lan_config command are ordinarily set from the console level via the EWx0_MODE environment variable. The lan_config command allows you to override this default and configure the interface as needed after the system is up and running. For all other devices, you must use the lan_config command to configure the interface. Modifications you make with the lan_config command do not persist across reboots of the operating system. To configure the interface or modify the parameters automatically each time the system is booted, edit the inet.local file and add the lan_config command entries to it. You can also use the ifconfig command to set the speed and mode (half- or full-duplex) either from the command line or in the inet.local file. If you specify the command in the inet.local file, the command is executed each time the system is booted. When you are finished making low-level configuration changes with either the lan_config command or the ifconfig command, you can use the hwmgr utility to verify these changes. See the EXAMPLES section of this reference page for more information.

RESTRICTIONS

You can configure only tu interfaces (DE5xx) by setting the appropriate console environment variables.

EXAMPLES

1. To switch from aui or bnc to utp full-duplex operation on tu0, enter: lan_config -i tu0 -m utp -x 1 2. To disable full-duplex operation on tu0, enter: lan_config -i tu0 -x 0 3. To enable autonegotiation on tu1, limiting capability to 100 Mb/s, half-duplex operation, enter: lan_config -i tu1 -a 1 -s 100 -x 0 4. To disable autonegotiation on tu1, forcing 10 Mb/s, half-duplex operation, enter: lan_config -i tu1 -a 0 -s 10 -x 0 You can use the hwmgr utility to verify the parameters that you change with the lan_config and ifconfig commands. The following command displays hardware information, low-level configuration settings, and statistics counters for all of the physical network adapters installed on your system: # hwmgr get attribute -category network 18: name = ee0 category = network sub_category = Ethernet model = Intel 82558 . . 19: name = ee1 category = network sub_category = Ethernet model = Intel 82558 . . 56: name = ee2 category = network sub_category = Ethernet model = Intel 82559 . . Each adapter is preceded by a unique hardware identifier, such as 18, 19, or 56 in the previous example. If necessary, you can use this identifier to display information for a specific card, as follows: # hwmgr get attribute -id 18 18: name = ee0 category = network sub_category = Ethernet model = Intel 82558 hardware_rev = 5 firmware_rev = MAC_address = 00-08-02-3E-C5-A5 MTU_size = 1500 media_speed = 10 media_selection = Automatic media_type = Unshielded Twisted Pair (UTP) loopback_mode = 0 promiscuous_mode = 0 full_duplex = 0 multicast_address_list = CF-00-00-00-00-00 01-00-5E-00-00-01 \ 33-33-FF-3E-C5-A5 33-33-00-00-00-01 \ 09-00-2B-00-00-0F 09-00-2B-02-01-04 interface_number = 1 link = Up autoneg_enable = 1 . . For more information about the hwmgr utility, see Hardware Management and hwmgr(8).

SEE ALSO

Commands: hwmgr(8), ifconfig(8) Files: inet.local(4) Interfaces: alt(7), bcm(7), ee(7), fza(7), le(7), ln(7), tra(7), tu(7) Network Administration: Connections Hardware Management

Index Index for
Section 8
Index Alphabetical
listing for L
Top of page Top of
page