netmgr_iether.1m (2011 09)

n
nwmgr_iether(1M) nwmgr_iether(1M)
rolling all the changes made to an interface since the time the system booted.
Reset an Interface
These commands reset an interface.
nwmgr -r -c lanPPA
nwmgr --reset --class_instance lan
PPA
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. So, the command
automatically performs a Critical Resource Analysis (CRA) to see if the interface is data-critical; in
other words, any other resource depends for its functionality on the availability of the interface. If
so, the reset is not performed.
The reset can be forced, even if the interface is data-critical, by using the
--force option. It is pos-
sible for an interface to be system-critical; in other words, the health of the system depends on the
availability of the interface. In that case, the reset will not be performed even if the
--force
option is specified.
Reset Statistics for an Interface
The following commands resets the statistics for an interface.
nwmgr -r --st -c lanPPA
nwmgr --reset --stats --class_instance lan
PPA
The data traffic statistics for an interface are cleared to zero. This includes the byte count and
packet count for inbound and outbound traffic. Other aspects of the interface are left unmodified.
Diagnose Link Connectivity
This command is run to diagnose link connectivity.
nwmgr --diag [link] -A dest=mac_addr [--it number][-A pktsize=bytes]
[
-A timeout=seconds] -c lanPPA
nwmgr --diagnose [link] --attribute dest=mac_addr [--iterations number]
[--attribute pktsize=bytes][--attribute timeout=seconds]
--class_instance lan
PPA
Link connectivity at the data link layer is checked by sending IEEE XID test frames to the specified
destination MAC address and counting the replies.
The
--iterations option specifies how many test frames to send; the default is 1.
The
pktsize attribute specifies the size of each test frame; the default is 100 bytes.
The
timeout attribute specifies how many seconds to wait for the acknowledgement of each test
frame; the default is 5 seconds.
RETURN VALUES
0 The command returns 0 on success.
<>0 On failure, the command returns values described in the ERRORS section below. ERRORS section
below.
ERRORS
[EACCES] Attempt to set a read-only attribute.
[EBUSY] The interface is presently inaccessible. This is usually because the interface is part of an
APA aggregate, which prevents setting attributes on the interface.
[EINVAL] One or more of the attributes or options is invalid for the task.
[ENOMEM] Memory allocation failed. This could be a transient condition.
[ENOTSUP] Operation or feature is not supported.
[ENXIO] The target interface could not be accessed.
[EPERM] The user lacks the authorization
hpux.network.config, which is required for this
operation.
HP-UX 11i Version 3: September 2011 − 7 − Hewlett-Packard Company 7