nwmgr_btlan.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

nwmgr_btlan(1M) nwmgr_btlan(1M)

NAME

nwmgr_btlan: nwmgr - network interface management command for btlan driver

SYNOPSIS

nwmgr

nwmgr [-g][-v][

-c lan_instance | -S btlan ]

nwmgr [-g] --st [all |

extmib | mib] -c lan_instance

nwmgr [-g] -A {all

| attr1, attr2, ...} -c lan_instance

nwmgr [-g] -q info -c lan_instance

nwmgr -s -A attr1 =value1 , attr2

=value2 ,... -c lan_instance

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

[rrent] -c lan_instance

nwmgr -s -A {all | attr1 ,

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

nwmgr -r -c lan_instance

nwmgr -r --st -c lan_instance

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

[-A timeout=seconds] -c lan_instance

nwmgr -h [-g | -s | -r | --diag][-c lan_instance | -S btlan

]

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 the replacement command nwmgr(1M) to

perform all network interface-related tasks.

DESCRIPTION

The

nwmgr program is a uniﬁed command to administer all Local Area Network (LAN) and RDMA inter-

faces of HP-UX. See nwmgr(1M) for general information about the command. This manpage describes

nwmgr when working with the btlan driver.

The

btlan driver is one of the HP-UX drivers that manages the 100BT Ethernet interfaces, both copper

(100Base-T) and ﬁber (100Base-FX). Each interface has several attributes. Some attributes (for exam-

ple, MTU) are conﬁgurable while others are read-only. In general, each attribute can have certain value

during run time (which is its current value), another value in the conﬁguration ﬁle that stores data across

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

value) but before the saved value is applied. See the Attributes section for a list of attributes.

For

btlan interfaces, use the nwmgr command to display information (with the -g option, which is the

default), to modify the settings (the -s option), to 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 (the default form) or in a script-

friendly parseable form (with the

--sc or --script option). The format for script-friendly output is

described in the nwmgr(1M) manpage.

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

not modiﬁcations or deletions. The human-readable form 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 in the following section. The output format that is described is

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

Operations

The

nwmgr command provides the following operations for the btlan interface.

--cra Operation to perform Critical Resource Analysis on the interface.

--diag | --diagnose Operation to diagnose/test link connectivity.

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

Summary of content (8 pages)

PAGE 1
nwmgr_btlan(1M) nwmgr_btlan(1M) NAME nwmgr_btlan: nwmgr - network interface management command for btlan driver SYNOPSIS nwmgr nwmgr [-g] [-v] [-c lan_instance | -S btlan ] nwmgr [-g] --st [all | extmib | mib] -c lan_instance nwmgr [-g] -A {all | attr1 , attr2 , ...} -c lan_instance nwmgr [-g] -q info -c lan_instance nwmgr -s -A attr1 =value1 , attr2 =value2 ,... -c lan_instance nwmgr -s -A all --sa --fr cu[rrent] -c lan_instance nwmgr -s -A {all | attr1 , attr2 ,...
PAGE 2
nwmgr_btlan(1M) nwmgr_btlan(1M) -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. Options The nwmgr command provides the following options for the btlan interface. For more information about these options, refer to nwmgr(1M). -A | --attribute Operation to assign attributes for the operation.
PAGE 3
nwmgr_btlan(1M) nwmgr_btlan(1M) For 100Base-T, it is essential that the link partner has the same speed, duplex and auto-negotiation settings as the NIC being configured. The speed can be forced to 10 or 100 Mbps, with Full or Half Duplex, with auto-negotiation off. This is done by setting speed to one of 10HD, 10FD, 100HD, or 100FD (case insensitive). The valid values allowed for speed in the command line for 100Base-T are: 10HD, 10FD, 100HD, 100FD, and auto_on.
PAGE 4
nwmgr_btlan(1M) nwmgr_btlan(1M) View Interface Statistics The following command can be used to display interface statistics. nwmgr [-g] --st [all | extmib | mib] -c lan_instance nwmgr [--get] --stats [all | extmib | mib] --class_instance lan_instance The arguments all, extmib, and mib are the only valid arguments for --stats for btlan drivers. all is the default if no argument is provided with --stats. It displays the same information as extmib which displays extended MIB statistics.
PAGE 5
nwmgr_btlan(1M) nwmgr_btlan(1M) nwmgr -r -c lan_instance nwmgr --reset --class_instance lan_instance 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. While the reset is in progress, the data traffic through the interface is interrupted.
PAGE 6
nwmgr_btlan(1M) nwmgr_btlan(1M) EXAMPLES List all LAN interfaces in the system. nwmgr -C lan Display the speed and MTU of the btlan interface lan1. nwmgr -A speed,mtu -c lan1 Display all attributes of the btlan interface lan1. nwmgr -A all -c lan1 Set MTU to 1400 and speed to auto-negotiation on lan1. nwmgr -s -A mtu=1400,speed=auto_on -c lan1 Restore MTU and the MAC address to their defaults on lan1.
PAGE 7
nwmgr_btlan(1M) nwmgr_btlan(1M) Command To Reset Statistics of a NIC lanadmin nwmgr lanadmin -c PPA nwmgr -r -st -c lan PPA Command To Reset MTU To the Default Value lanadmin nwmgr lanadmin -R PPA nwmgr -s -A mtu -from default -c lan PPA Command To Set To Default Configurations lanadmin nwmgr lanadmin -A DEFAULT PPA nwmgr -s -A mac -from default -c lan PPA NOTE: Similarly default configuration can be set for the other attributes like speed,mtu, mac etc.
PAGE 8
nwmgr_btlan(1M) nwmgr_btlan(1M) Command To Display MAC Types Only lanscan nwmgr lanscan -m nwmgr -g -v -c lan PPA NOTE: nwmgr reports only on Ethernet links Command To Display NMIDs Only lanscan nwmgr lanscan -n nwmgr -g -v -c lan PPA Command To Display the PPAs Only lanscan nwmgr lanscan -p nwmgr -g -v -c lan PPA nwmgr -C lan --sc | awk -F# ’/if_state/ {print substr($1,4)}’ Command To Display All Mac Addresses lanscan nwmgr lanscan -a nwmgr -g -v -c lan PPA A nA Note: nwmgr displays the NIC attribu