lan_config(8)lan_config(8)NAMElan_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
Changes the specified characteristics for interface_name. You must pro‐
vide an interface name. 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 renegoti‐
ate the interface's capability (when enabled) or to force the
interface at a certain configuration (when disabled). 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 cor‐
rect position. 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. 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 autonego‐
tiation, 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 implica‐
tion 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 exe‐
cuted 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
The lan_config command has the following restrictions: You cannot mod‐
ify the parameters of a reserved interface (RESERVED flag is set).
Instead, specify the reserving NetRAIN or Link Aggregation virtual
interface. VLAN interfaces cannot be modified.
You can configure only tu interfaces (DE5xx) by setting the appropriate
console environment variables.
EXAMPLES
To switch from aui or bnc to utp full-duplex operation on tu0, enter:
lan_config-i tu0 -m utp -x 1 To disable full-duplex operation on tu0,
enter: lan_config-i tu0 -x 0 To enable autonegotiation on tu1, limit‐
ing capability to 100 Mb/s, half-duplex operation, enter: lan_config-i
tu1 -a 1 -s 100 -x 0 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 dis‐
plays hardware information, low-level configuration settings, and sta‐
tistics 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 iden‐
tifier 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
lan_config(8)