nwmgr man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

nwmgr(1M)							     nwmgr(1M)

       nwmgr  -	 network  interface management command for LAN and RDMA inter‐

       [operation] [target] [operation-qualifiers] [target-qualifiers]

       The program is the unified command to administer all HP-UX LAN and RDMA

       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‐

	 ·  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.

       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‐
	      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‐

       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.

       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‐

       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).

       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

       Use one of the following to view basic properties of one or more inter‐

       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

       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

       Note that the operation is the default; you do not need to specify  the

       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.

       On success, returns

       On failure, it returns one of the values described in the section.

       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.

       List all LAN and RDMA interfaces in the system:


       Display usage information for command:

       Display the list of subsystems:

       Display subsystem specific usage:

       was developed by HP.

       nwmgr_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).


List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net