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:

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:

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