netmgr_iether.1m (2011 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

nwmgr_iether(1M) nwmgr_iether(1M)

NAME

nwmgr_iether: nwmgr - network interface management command for iether driver

SYNOPSIS

nwmgr

nwmgr [-g][-v][

-c lanPPA | -S iether]

nwmgr [-g] --st [mib

| extmib | subsys | all] -c lanPPA

nwmgr [-g] -A {all | attr1

, attr2, ...} -c lanPPA

nwmgr [-g] -q info -c lan

PPA

nwmgr [-g] -q vpd -c lan

PPA

nwmgr -s -A attr1=value1, attr2

=value2, ... -c lanPPA

nwmgr -s -A all --sa --fr cu[

rrent] -c lanPPA

nwmgr -s -A {all | attr1,

attr2, ...} [--cu] --fr de[fault] -c lanPPA

nwmgr -s -q asset_tag=value -c lan

PPA

nwmgr -r -c lanPPA

nwmgr -r --st -c lanPPA

nwmgr --diag [link] -A dest=mac_addr [--it number][-A pktsize=bytes]

[

-A timeout=seconds] -c lanPPA

nwmgr -h [-g | -s | -r | --diag][-c lanPPA |

-S iether]

Remarks

The

lanadmin, lanscan, and linkloop commands are deprecated. These commands will be

removed in a future HP-UX release. HP recommends the use of replacement command nwmgr(1M) to

perform all network interface-related tasks.

DESCRIPTION

The

nwmgr program is the uniﬁed command to administer all LAN and RDMA-based interfaces of HP-

UX. General information about the command as a whole can be found in the manual page nwmgr(1M).

This manual page describes

nwmgr as applied to the iether driver.

The

iether driver is one of the HP-UX drivers that manages Gigabit Ethernet interfaces, both copper

(1000Base-T) and ﬁber (1000Base-SX). Each interface has several attributes. Some, such as MTU, are

conﬁgurable while others are read-only. In general, each attribute can have a certain value in the run-

ning system (which is its current value), another value in the conﬁguration ﬁle that stores data across

boots (its saved value) and a HP-supplied value that is applied by the driver after boot (its default value)

before the saved value is applied. The list of attributes is documented in the section named Attributes

below.

The

nwmgr command can be used on iether interfaces to display information (with the -g option,

which is the default), modify settings (the -s option), reset the interface or its statistics (the -r option),

and to diagnose link connectivity (the --diag option).

Operations other than

get require the hpux.network.config authorization. For more information

about authorizations and Role-based Access Control, see rbac(5).

The settings of the

iether interfaces on the system can be saved to the conﬁguration ﬁle

/etc/rc.config.d/hpietherconf, so that these settings will take effect across reboots.

The output in each case can be obtained in either human-readable form (which is the default) or in a

script-friendly parseable form (with the

--sc or --script option). The format for script-friendly out-

put is described in the manpage nwmgr(1M).

It is guaranteed that any change in the scriptable output across releases will contain only additions,

never modiﬁcations or deletions. The human-readable format can change across releases, including

modiﬁcations and deletions, though the changes can be expected to be incremental.

The usage is explained in greater detail below. The output format that is described is the human-

readable one; references to the scriptable output are made as necessary.

HP-UX 11i Version 3: September 2011 − 1 − Hewlett-Packard Company 1

Summary of content (12 pages)

PAGE 1
nwmgr_iether(1M) nwmgr_iether(1M) NAME nwmgr_iether: nwmgr - network interface management command for iether driver SYNOPSIS nwmgr nwmgr [-g] [-v] [-c lanPPA | -S iether] nwmgr [-g] --st [mib | extmib | subsys | all] -c lanPPA nwmgr [-g] -A {all | attr1 , attr2 , ...} -c lanPPA nwmgr [-g] -q info -c lanPPA nwmgr [-g] -q vpd -c lanPPA nwmgr -s -A attr1 =value1 , attr2 =value2 , ... -c lanPPA nwmgr -s -A all --sa --fr cu[rrent] -c lanPPA nwmgr -s -A {all | attr1 , attr2 , ...
PAGE 2
nwmgr_iether(1M) nwmgr_iether(1M) Operations The nwmgr command provides the following operations for the iether interface. --cra Operation to perform Critical Resource Analysis on the interface. --diag | --diagnose Operation to diagnose/test link connectivity. -g | --get Operation to get/display interface settings. -h | --help Operation to display help information. -r | --reset Operation to reset interface or statistics. -s | --set Operation to set the attributes of the interface.
PAGE 3
nwmgr_iether(1M) diag_thresh nwmgr_iether(1M) Diagnostics Threshold: Inbound packet rate threshold below which CKO diagnostics are run. 0 A value of zero indicates the diagnostics are disabled. -1 A value of -1 means that the driver chooses an appropriate threshold. Minimum: -1 Maximum: 100000 Default: 0 ifadmin Administration Status: The Administration Status of a link. The default value will be UP (1) if the card is claimed succussfully.
PAGE 4
nwmgr_iether(1M) nwmgr_iether(1M) Default: On (case insensitive). send_coal_ticks Max Send Coalesce Ticks: Maximum time for the NIC to wait after sending a frame before it raises an interrupt. NOTE: Modifying this configuration parameter to non-default values is no longer recommended for PCI-X cards and IS NOT supported for PCIe cards. Minimum: 0 Maximum: 65535 Default: 150 send_max_bufs Max Send Buffers: Maximum number of send descriptors for the NIC to coalesce before it raises an interrupt.
PAGE 5
nwmgr_iether(1M) nwmgr_iether(1M) Note that speeds below 1 Gbps are allowed only if MTU is 1500 bytes or less. tx_cko Transmit Checksum Offload: Hardware TCP/UDP (IPv4) transmit checksum offload. Values: Off, On Default: Off vmtu Virtual MTU for TCP Segmentation Offload (TSO). Setting it to zero disables TSO. Setting it to a non-zero value enables TSO. Values: 0, 32160 Default: 0 tx512_bufs Use this option to limit the transmit buffer size limit to 512 bytes.
PAGE 6
nwmgr_iether(1M) nwmgr_iether(1M) View Interface Attributes These commands can be used to view interface attributes. nwmgr [-g] -A {all | attr1 , attr2 , ...} -c lanPPA nwmgr [--get] --attribute {all | attr1 , attr2 , ...} --class_instance lanPPA These commands display the current value of either all the attributes of the interface (when the all keyword is specified) or the specified attributes (when they are listed by name). Each attribute is listed on a separate line as a name-value pair.
PAGE 7
nwmgr_iether(1M) nwmgr_iether(1M) rolling all the changes made to an interface since the time the system booted. Reset an Interface These commands reset an interface. nwmgr -r -c lanPPA nwmgr --reset --class_instance lanPPA The interface is subjected to a PCI reset, which clears all previous state, including the interface statistics. The interface is then re-programmed with the attribute values that were current before the reset. Promiscuous mode and multicast addresses are preserved across the reset.
PAGE 8
nwmgr_iether(1M) [ERANGE] nwmgr_iether(1M) The specified values of one or more attributes was less than the minimum or more than the maximum.
PAGE 9
nwmgr_iether(1M) nwmgr_iether(1M) Commands to Set Generic NIC Attributes lanadmin nwmgr lanadmin -M mtu_size PPA nwmgr -s -A mtu=mtu_size-c lanPPA lanadmin -A MAC_Address PPA nwmgr -s -A mac=MAC_Address -c lanPPA landmin -X speed_value PPA nwmgr -s -A speed=speed_value -c lanPPA Fiber NICS: lanadmin -X auto_on PPA nwmgr -s -A speed=auto_on -c lanPPA Command to Display NIC Specific Attributes lanadmin nwmgr lanadmin -x fctrl PPA nwmgr [-g] -A rx_fctrl -c lanPPA lanadmin -x send_max_bufs PPA nwmgr [-
PAGE 10
nwmgr_iether(1M) nwmgr_iether(1M) Command to Reset a NIC lanadmin nwmgr lanadmin -r PPA nwmgr -r -c lanPPA Command to Reset Statistics of a NIC lanadmin nwmgr lanadmin -c PPA nwmgr -r --st -c lanPPA Command to Reset MTU to the Default Value lanadmin nwmgr lanadmin -R PPA nwmgr -s -A mtu -from default -c lanPPA Command to Set to Default Configurations lanadmin nwmgr lanadmin -A DEFAULT nwmgr -s -A mac -from default PPA -c lanPPA NOTE: Similarly default configuration can be set for the other attributes like
PAGE 11
nwmgr_iether(1M) nwmgr_iether(1M) Command To Display Interface Names Only lanscan nwmgr lanscan -i nwmgr -g -v -c lanPPA nwmgr -C lan -sc | awk -F# ’/if_state/ {print $1}’ Command To Display MAC Types Only lanscan nwmgr lanscan -m nwmgr -g -v -c lanPPA NOTE: nwmgr reports only on Ethernet links Command To Display NMIDs Only lanscan nwmgr lanscan -n nwmgr -g -v -c lanPPA Command To Display the PPAs Only lanscan nwmgr lanscan -p nwmgr -g -v -c lanPPA nwmgr -C lan --sc | awk -F# ’/if_state/ {print substr($1,
PAGE 12
(Notes) A (Notes) nA 12 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2011