Using the lanadmin Tool with Gigabit Ethernet

This section explains the options available in lanadmin to support the Gigabit Ethernet driver and how to use them. The lanadmin(1M) tool is used to display and set parameters, as specified by the following commands:

	NOTE: When your system is rebooted, settings that were made via the lanadmin(1M) command will be lost. To retain configuration settings permanently in the configuration file (/etc/rc.config.d/hpgelanconf or /etc/rc.config.d/hpigelanconf), use the SAM utility or manually edit the configuration file.

To display the card's station address, execute:

$ lanadmin -a nmid/ppa

To set the card's station address, execute:

$ lanadmin -A station_addr nmid/ppa

where nmid is the Network Management Identifier (NMID) (for HP-UX 10.20) and ppa is the Card Instance Number (also known as physical point of attachment or PPA) (for HP-UX 11.0 and later). Both the NMID and PPA may be obtained from the lanscan(1M) output.

To display the MTU, execute:

$ lanadmin -m nmid/ppa

To set the MTU, execute:

$ lanadmin -M mtu_size nmid/ppa

On HP-UX 10.20, the setting of the MTU should be followed by configuring the interface with the appropriate IP address using ifconfig(1M). See the ifconfig man page for details. The change in MTU should be verified, on all HP-UX operating systems, by executing:

$ netstat -rn

To display link parameters, execute:

$ lanadmin -x option nmid/ppa

To set link parameters, execute:

$ lanadmin -X option nmid/ppa

where option specifies the operation to be carried out.

Displaying Values

The command $ lanadmin -x (or -X) help nmid/ppa displays a list of valid options used to display values.

Option	Display
help	List of -x or -X options
speed	Speed and duplexity of the link
fctrl	Whether Receive Flow Control is enabled or not
send_max_bufs	Value of send buffer coalescing threshold
recv_max_bufs	Value of receive buffer coalescing threshold
send_coal_ticks	Value of send interrupt coalescing ticks
recv_coal_ticks	Value of receive interrupt coalescing ticks
stats drv	Driver and adapter statistics
card_info	Adapter and driver revision and settings

	NOTE: If option is not specified, then the speed, duplexity, and autonegotiation settings are displayed.

Examples

Card Information

To display the card information, execute:

$ lanadmin -x card_info nmid/ppa

*********** Version Information *********** Driver version: B.10.20.11 Firmware version: 12.4.5 Chip version: 0x6 PCI Sub-System ID: 0x106f (1000Base-SX) PCI Sub-Vendor ID: 0x103c Board revision: C Software Key: 6 Engineering Date Code: B-3845

*********** Card Setting *********** Driver State: GELAN_ONLINE Auto Negotiation: On Flow Control: On Send Max Buf Descriptors: 16 Recv Max Buf Descriptors: 1 Send Coalesced Ticks: 1000 Recv Coalesced Ticks: 0

Card Statistics

To display the card statistics, execute:

$ lanadmin -x stats drv nmid/ppa

	NOTE: See Appendix B for a sample output and explanation of the card statistics.

Send Buffer Coalescing

To display the send buffer coalescing threshold, execute:

$ lanadmin -x send_max_bufs nmid/ppa

Send buffer coalescing threshold = 16

Receive Interrupt Coalescing

To display the receive interrupt coalescing ticks, execute:

$ lanadmin -x recv_coal_ticks nmid/ppa

Receive interrupt coalescing ticks = 0

Flow Control

To display the flow control setting, execute:

$ lanadmin -x fctrl nmid/ppa

Flow control is enabled

Setting Values

The command $ lanadmin -X (or -x) help nmid/ppa displays a list of valid options used to set values.

Option	Setting
help	Lists -X or -x options
auto_on	Turns on auto-negotiation mode
auto_off	Turns off autonegotiation mode for a 1000Base-SX
fctrl on	Turns on receive flow control
fctrl off	Turns off receive flow control
10hd	Sets speed of a 1000Base-T to 10 Mbps half-duplex
10fd	Sets speed of a 1000Base-T to 10 Mbps full-duplex
100hd	Sets speed of a 1000Base-T to 100 Mbps half-duplex
100fd	Sets speed of a 1000Base-T to 100 Mbps full-duplex
send_max_bufs*	Sets send buffer coalescing threshold [1 - 128]
recv_max_bufs*	Sets receive buffer coalescing threshold [1 - 256]
send_coal_ticks*	Sets send interrupt coalescing ticks [0 - 10000000]
recv_coal_ticks*	Sets receive interrupt coalescing ticks [0 - 10000000]
stats clear	Clears all driver and adapter statistics
* These options require the desired value to be specified after the option name.

Examples

Speed

To set the speed to 100 Mbps full-duplex on 1000Base-T, execute:

$ lanadmin -X 100fd nmid/ppa

	NOTE: The lanadmin -S option to set the speed is not supported on Gigabit Ethernet.

Stats Clear

To clear all driver and card statistics, execute:

$ lanadmin -X stats clear nmid/ppa

Buffer Coalescing Threshold

To set the send buffer coalescing threshold, execute:

$ lanadmin -X send_max_bufs 32 nmid/ppa

Note that the tuning option send_max_bufs requires the additional option 32 (the coalescing threshold).

Interrupt Coalescing Ticks

To set the send interrupt coalescing ticks, execute:

$ lanadmin -X send_coal_ticks 2000 nmid/ppa

Note that the tuning option send_coal_ticks requires the additional option 2000 (the number of coalescing ticks).