unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



lan_config(8)							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 pro-
      vide 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 automati-
      cally 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	com-
      mand line	as the -a option to redefine and renegotiate the interface's
      capability (when enabled)	or to force the	interface at a certain confi-
      guration (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 autonegotia-
  tion,	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 permit-
  ted combinations of speed and	mode of	operation in descending	order of pre-
  cedence, 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	made 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.








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 opera-
       tion, enter:
	    lan_config -i tu1 -a 0 -s 10 -x 0



SEE ALSO

  Commands: ifconfig(8)

  Files: inet.local(4)

  Interfaces: alt(7), ee(7), el(7), fza(7), le(7), ln(7), tra(7), tu(7)