nwmgr(1M)nwmgr(1M)NAMEnwmgr - network interface management command for LAN and RDMA inter‐
faces
SYNOPSIS
[operation] [target] [operation-qualifiers] [target-qualifiers]
DESCRIPTION
The program is the unified command to administer all HP-UX LAN and RDMA
interfaces.
This manpage describes command features that can be supported by How‐
ever, each network interface driver (commonly referred to as a subsys‐
tem) might support a subset of these features. You can obtain informa‐
tion about features supported by a specific subsytem from the subsys‐
tem's individual manpage, named nwmgr_<subsystem>(1M).
To see the list of subsystems supported by on the system, enter:
You can use the 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 configuration information for a component simulta‐
neously
· Delete or erase components
All the operations other than display require the authorization. For
more information about authorizations and Role-Based Access Control,
see rbac(5).
The output for every operation is either in human-readable form (the
default output form) or in a script-friendly parsable form (with the or
option). The format for human-readable and script-friendly output is
described in the section below. Any change in the scriptable output
across releases will contain only additions, never modifications or
deletions, to ensure backward compatibility. The human-readable format
can change across releases, including modifications 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 and 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
A command line may contain the following options:
· operation
· target
· target qualifier
· operation qualifier
It is possible to specify multiple targets, target-qualifiers and oper‐
ation-qualifiers 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-qualifier, and operation-
qualifier 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‐
fied, must always be the first argument in the command line. The oper‐
ation (to get/display interface information) is the default, when no
operation option is specified.
The following operations are available:
Creates and sets configuration information for a component simultane‐
ously. The operation is subsystem specific. Any change done using the
operation can be runtime only, persistent or both.
Performs critical resource analysis (CRA) of network interfaces.
The CRA operation displays the users of the component or subsys‐
tem that will be impacted if a destructive operation is per‐
formed. HP recommends performing CRA operation prior to any
destructive operation.
Deletes or erases components, or modifies the attributes of a compo‐
nent.
The operation can be subsystem specific. The changes made using
the operation can be runtime only, persistent, or both.
Performs a diagnostic operation.
Diagnostic operations are subsystem specific. An example of
diagnostic operation is link connectivity check.
Suspends (or stops) a physical and virtual component.
Downloads firmware onto the physical device.
Dumps or reads registers, memory, and debug information of
controllers and devices
Resumes a suspended (or starts or restarts) a physical
device or a virtual component.
Displays system configuration information, component attribute
information, and subsystem specific information (for example,
statistics). You can also use this operation to view the cur‐
rent (runtime), saved (across reboots), and default configura‐
tion. This is the default operation if no operation is speci‐
fied.
Displays usage information and context dependent help for a
command or a subsystem.
Performs hard and soft reset of physical and virtual components.
Sets configuration information of the components and the
subsystems. Use this opperation to change the current (run‐
time), saved (across reboots), and default configuration.
Target
The target is the object on which an operation is performed. You must
specify a target for all operations except for and operations. The
choice to support multiple targets in a command is subsystem specific.
The following target options are supported:
Limits the scope of the operation to the classes provided.
Limits the scope of the
operation to the class instances provided.
Limits the operation
to the instances of the class/subsystem specified.
Limits the scope of the
operation to the names provided.
Limits the scope of the
operation to the subsystems provided.
Operation Qualifier
Operation qualifier is used to specify additional information to com‐
plete the requested operation.
The following operational qualifier options are supported:
Forces the operation even if errors are encountered during the opera‐
tion.
Specifies the configuration parameter values
to be used for the operation. The operation takes any one of or
as argument.
Specifies the time interval (in seconds) between consecutive
operations. If you do not specify a value, the default interval
is 1 second.
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.
Performs a locked operation, where future accesses to the
device is blocked.
Verifies if the operation can be performed without actually
executing the operation.
Displays the output in scriptable format.
Specifies the time or duration (in seconds) for which a specific
operation needs to be performed. If you do not specify a value,
the default time or duration is 1 second.
Unlocks the device that was previously locked.
Displays the output in verbose format.
Displays output beyond the 80 column default.
Target Qualifiers
The target qualifier provides additional information on the object(s)
the operation will act on.
The following target qualifier options are supported:
Specifies the parameter/attribute associated with a target whose value
can be retrieved or set.
Valid attributes for each interface is described in the section
of the subsystem manpage, such as nwmgr_vlan(1M).
Specifies that the operation applies to configuration
parameter current values in system memory. If none of or is
specified the command defaults to implicitly.
Specifies that the operation applies to configuration
parameter default values.
Specifies that the operation applies to configuration
parameter values saved in a persistent store.
Specifies that the operation applies to the statistics of
the target.
Specifies a generic target qualifier used
to specify a subsystem specific target qualifier. Refer to the
subsystem manpage for valid qualifiers for that particular sub‐
system, such as nwmgr_btlan(1M).
USAGE
The command without any arguments displays all the network interfaces
in the system, including physical LAN interfaces (NICs), virtual LAN
interfaces (VLANs and APA aggregates and failover groups), and RDMA
interfaces.
Use one of the following to view basic properties of one or more inter‐
faces:
The human-readable form displays a table, with one row for each inter‐
face. If an interface is specified as a target with the option, only
that interface is displayed. If the option is specified, all inter‐
faces for the subsystem are displayed.
For example:
# nwmgr--get
Name/ Interface Station Sub- Interface Related
ClassInstance State Address system Type Interface
============== ========= ============== ======== ============== =========
lan0 UP 0x00306EF4E07C igelan 1000Base-T
lan1 UP 0x000F202B92D4 igelan 1000Base-T
lan2 UP 0x0010837BDE00 btlan 100Base-TX
The parsable (script-friendly) output contains the same data as the
readable output for each subsystem. The format consists of four col‐
umns delimited with a number sign
For example:
# nwmgr--get --script
lan0#subsystem#current#igelan
lan0#if_type#current#1000Base-T
lan1#if_state#current#UP
lan1#mac#current#0x000F202B92D4
lan1#subsystem#current#igelan
lan1#if_type#current#1000Base-T
lan2#if_state#current#UP
lan2#mac#current#0x0010837BDE00
lan2#subsystem#current#btlan
lan2#if_type#current#100Base-TX
lan3#if_state#current#DOWN
Interface listing displays the following information about the LAN or
RDMA device that has software support on the system:
· Interface Name
· Interface State
· Interface Address. Indicates the primary unicast MAC address for
LAN interfaces and the GID for RDMA interfaces
· Subsystem
· Interface Type
· Association. Lists another interface that is associated with the
interface
Note that the operation is the default; you do not need to specify the
option.
Use one of the following commands to view help for or subsystem spe‐
cific usage.
subsystem ]
subsystem ]
When used with it displays the list of subsystems supported by
All other features are subsystem specific. You can obtain information
about features supported by a specific subsytem from the subsystem spe‐
cific manpages, using the nwmgr_<subsystem>(1M) name format.
RETURN VALUE
On success, returns
On failure, it returns one of the values described in the section.
ERRORS
If fails, it returns one of the following errors. The values of the
error codes are described in
Unable to access the interface.
One or more of the attributes or options is invalid for the operation.
I/O to the target interface failed.
Memory allocation failed.
This could be a transient condition.
Operation or feature is not supported.
The target interface does not exist.
The user lacks the
authorization required for this operation.
EXAMPLES
List all LAN and RDMA interfaces in the system:
or
Display usage information for command:
Display the list of subsystems:
Display subsystem specific usage:
AUTHOR
was developed by HP.
SEE ALSOnwmgr_btlan(1M), nwmgr_intl100(1M), nwmgr_vlan(1M), rbac(5).
Other subsystem manpages are available if the driver is installed on
your system. See nwmgr_<subsystem>(1M).
nwmgr(1M)