nwmgr_iocxgbe.1m (2011 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M)

NAME

nwmgr_iocxgbe - network interface management command for iocxgbe driver

SYNOPSIS

nwmgr

nwmgr [-g][-v][

-c lanPPA | -S iocxgbe]

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 [-g] -q drv_coal -c lan

PPA

nwmgr [-g] -q drv_stats -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 -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 iocxgbe]

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 iocxgbe driver.

The

iocxgbe driver is the HP-UX driver that manages 10 Gigabit Ethernet interfaces based on the

Emulex BE2, BE3 chips. 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 running system

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

DLKM loads (its saved value) and an 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 iocxgbe 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 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 manual page nwmgr(1M). It is guaranteed that any change in the scriptable out-

put across releases will contain only additions, never modiﬁcations or deletions. The human-readable for-

mat can change across releases, including modiﬁcations and deletions, though the changes can be

expected to be incremental.

Operations

The

nwmgr command provides the following operations for the iocxgbe interface.

--diag | --diagnose Diagnose/test link connectivity.

-g | --get Get/display interface settings. This is the default operation when none is

speciﬁed.

-h | --help Display help information.

-r | --reset Reset interface or the statistics on the interface.

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

Summary of content (12 pages)

PAGE 1
nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M) NAME nwmgr_iocxgbe - network interface management command for iocxgbe driver SYNOPSIS nwmgr nwmgr [-g] [-v] [-c lanPPA | -S iocxgbe] 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 [-g] -q drv_coal -c lanPPA nwmgr [-g] -q drv_stats -c lanPPA nwmgr -s -A attr1 =value1 , attr2 =value2 , ...
PAGE 2
nwmgr_iocxgbe(1M) -s | --set nwmgr_iocxgbe(1M) Set the attributes of the interface. Options Beside operations, these options are valid for the iocxgbe interface: -A | --attribute Specifies attributes for an operation. For iocxgbe, this can be used with the add, set, get, and diagnose operations. See Attributes section below for valid attributes of iocxgbe interfaces. -c | --class_instance Specifies the target interface on which the operation is to be performed.
PAGE 3
nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M) Default: 5 (on primary functions 0,1), 1 (on additional functions) drv_pr TCP Packet Reassembly in Driver. This feature allows the driver to combine TCP segments and pass the large combined packet to the upper layers of the network stack in the receive path. This feature can lower CPU utilization. rx_cko must be on before turning on drv_pr. Jumbo receive must be off before turning on drv_pr.
PAGE 4
nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M) Default: On When configured, the adapter automatically generates a pause frame when the amount of data in the receive queue exceeds a threshold. tx_coal TX Interrupt Timer. For transmit interrupt coalescing, the minimum time between transmit interrupts. Units in microseconds. Setting to 0 disables the timer, the device will schedule an interrupt immediately after completing a packet transmit request. Min: 1 Max: 1000000 Default: 32 vmtu Virtual MTU.
PAGE 5
nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M) extmib The extended MIB statistics are displayed. This overrides the mib argument, if present. subsys Displays the subsystem-specific statistics, which can vary from one driver to another. all Displays both extended MIB statistics and subsystem-specific statistics, in other words, it is equivalent to extmib,subsys. It overrides any other arguments that may be present. It is possible to give more than one argument to the --stats option, as a comma-separated list.
PAGE 6
nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M) nwmgr --set [ --hp ] --attribute --saved --from cu[rrent] --class_instance lanPPA Save the current values of all attributes of an interface in the configuration file /etc/rc.config.d/hpiocxgbeconf. This form stores the current value of each attribute of an interface in the configuration file, so that the interface configuration is preserved across boots (and DLKM loads).
PAGE 7
nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M) processed per interrupt. The timer value is expressed in microseconds and can be in the range {0 - 3000}. When the value is zero, an interrupt will occur after the next transmit or receive completion. The timer values can be set with the following commands: nwmgr -s -A tx_coal=25 -c lan PPA nwmgr -s -A rx_coal=50 -c lan PPA RETURN VALUES 0 The command returns 0 on success. <>0 On failure, the command returns values described in the ERRORS section below.
PAGE 8
nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M) lanadmin lanadmin -m PPA nwmgr nwmgr [-g] -A mtu -c lanPPA lanadmin -a PPA nwmgr [-g] -A mac -c lanPPA landamin -s PPA nwmgr [-g] -A speed -c lanPPA lanadmin -m -a -s PPA nwmgr [-g] -A mtu,mac,speed -c lanPPA nwmgr [-g] -A all -c lanPPA Commands to Get NIC Statistics lanadmin lanadmin -g PPA nwmgr nwmgr -g --st mib -c lanPPA lanadmin -x stats drv PPA nwmgr -g --st subsys -c lanPPA nwmgr -g -st mib,subsys -c lanPPA lanadmin -g mibstats_ext PPA nwmgr -g --st
PAGE 9
nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M) Command to Set NIC Specific Attributes lanadmin lanadmin -X tx_fctrl {on|off} PPA nwmgr nwmgr -s -A tx_fctrl= {on|off} -c lanPPA lanadmin -X rx_fctrl {on|off} PPA nwmgr -s -A rx_fctrl= {on|off} -c lanPPA lanadmin -X send_cko_ {on|off} PPA nwmgr -s -A tx_cko={on|off} -c lanPPA lanadmin -X recv_cko_ {on|off} PPA nwmgr -s -A rx_cko={on|off} -c lanPPA lanadmin -X tx_coal value PPA nwmgr -s -A tx_coal=value -c lanPPA lanadmin -X rx_coal value PPA nwmgr -s -A rx_co
PAGE 10
nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M) 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 speed, mtu, mac, etc. Note: The nwmgr equivalent for displaying the usage information is not available. Note: The lanadmin options that support apa and vlan are covered in the nwmgr_apa (1M) and nwmgr_vlan (1M) manpages.
PAGE 11
nwmgr_iocxgbe(1M) nwmgr_iocxgbe(1M) Obsolescence 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. AUTHOR nwmgr was developed by HP. FILES /etc/rc.config.d/hpiocxgbeconf Contains the saved (persistent) configuration for iocxgbe interfaces. /sbin/rc2.
PAGE 12
(Notes) A (Notes) nA 12 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2011