nwmgr.1m (2010 09)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

nwmgr(1M) nwmgr(1M)

NAME

nwmgr - network interface management command for LAN and RDMA interfaces

SYNOPSIS

/usr/sbin/nwmgr

[-h|--help|-?

][operation ][target ][operation-qualiﬁers]

[target-quali ﬁers]

DESCRIPTION

The

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

This manpage describes command features that can be supported by

nwmgr. However, each network

interface driver (commonly referred to as a subsystem) might support a subset of these features. You can

obtain information about features supported by a speciﬁc subsytem from the subsystem’s individual man-

page, named nwmgr_<subsystem>(1M).

To see the list of subsystems supported by

nwmgr on the system, enter:

nwmgr -h -S all

You can use the nwmgr

command on LAN or RDMA interfaces to:

• Display information of an interface

• Modify settings of an interface

• Reset the interface or its statistics

• Diagnose link connectivity

• Create and set conﬁguration information for a component simultaneously

• Delete or erase components

All the operations other than display require the

hpux.network.config

authorization. For more

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

The

nwmgr output for every operation is either in human-readable form (the default output form) or in a

script-friendly parsable form (with the

--sc or --script option). The format for human-readable and

script-friendly output is described in the USAGE section below. Any change in the scriptable output

across releases will contain only additions, never modiﬁcations or deletions, to ensure backward compati-

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

The command 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.

Obsolescence Warning

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.

Structure of nwmgr Command Line

nwmgr command line may contain the following options:

• operation

• target

• target qualiﬁer

• operation qualiﬁer

It is possible to specify multiple targets, target-qualiﬁers and operation-qualiﬁers in the same command

line. In addition, you can also specify multiple arguments for these command options (when applicable)

on a single command line. The target, target-qualiﬁer, and operation-qualiﬁer can appear in any order,

but must follow the operation.

Operation

An operation is a key part of the command line. An operation is a way to specify how a subsystem has to

be managed. The operation, if speciﬁed, must always be the ﬁrst argument in the command line. The

--get operation (to get/display interface information) is the default, when no operation option is

speciﬁed.

The following operations are available:

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

Summary of content (6 pages)

PAGE 1
nwmgr(1M) nwmgr(1M) NAME nwmgr - network interface management command for LAN and RDMA interfaces SYNOPSIS /usr/sbin/nwmgr [-h|--help|-?] [operation ] [target ] [operation-qualifiers ] [target-quali fiers ] DESCRIPTION The nwmgr program is the unified command to administer all HP-UX LAN and RDMA interfaces. This manpage describes command features that can be supported by nwmgr. However, each network interface driver (commonly referred to as a subsystem) might support a subset of these features.
PAGE 2
nwmgr(1M) A nA nwmgr(1M) --add | -a Creates and sets configuration information for a component simultaneously. The add operation is subsystem specific. Any change done using the add operation can be runtime only, persistent or both. --cra Performs critical resource analysis (CRA) of network interfaces. The CRA operation displays the users of the component or subsystem that will be impacted if a destructive operation is performed.
PAGE 3
nwmgr(1M) nwmgr(1M) {--interval | --int} value Specifies the time interval (in seconds) between consecutive operations. If you do not specify a value, the default interval is 1 second. {--iterations | --it} value Specifies the number of iterations a specific operation needs to be performed. If you specify a value of 0, infinite iterations are performed. If you do not specify a value, the default is 1 iteration. --lock | --lo Performs a locked operation, where future accesses to the device is blocked.
PAGE 4
nwmgr(1M) nwmgr(1M) For example: # nwmgr --get Name/ ClassInstance ============== lan0 lan1 lan2 Interface State ========= UP UP UP Station Address ============== 0x00306EF4E07C 0x000F202B92D4 0x0010837BDE00 Subsystem ======== igelan igelan btlan Interface Related Type Interface ============== ========= 1000Base-T 1000Base-T 100Base-TX The parsable (script-friendly) output contains the same data as the readable output for each subsystem.
PAGE 5
nwmgr(1M) nwmgr(1M) [EIO] I/O to the target interface failed. [ENOMEM] Memory allocation failed. This could be a transient condition. [ENOTSUP] Operation or feature is not supported. [ENXIO] The target interface does not exist. [EPERM] The user lacks the hpux.network.config authorization required for this operation.
PAGE 6
(Notes) A (Notes) nA 6 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010