HP-UX Reference (11i v3 07/02) - 1M System Administration Commands N-Z (vol 4)
n
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 statis-
tics. 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 to see if the interface is data-critical; that is, 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 possible for an interface to be system-critical; that is, 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 of an Interface
The following command can be used to reset statistics of an interface.
nwmgr -r --st -c lan_instance
nwmgr --reset --stats --class_instance
lan_instance
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
The following command can be used to diagnose link connectivity.
nwmgr --diag [link] -A dest=mac_addr [--it number][-A pktsize=bytes]
[
-A timeout=seconds] -c lan_instance
nwmgr --diagnose [link] --attribute dest=mac_addr [--iterations number]
[--attribute pktsize=bytes][--attribute timeout=seconds]
--class_instance
lan_instance
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 value is 1.
The pktsize attribute specifies the size of each test frame. The default value is 100 bytes.
The timeout attribute specifies how many seconds to wait for the acknowledgement of each test
frame. The default value is 5 seconds.
RETURN VALUES
0 On success
<>0 On failure, the command returns values described in ERRORS below.
ERRORS
Below are the errors generated by
nwmgr on failure.
[EACCES] Attempt to set a read-only attribute.
[EBUSY] The interface is currently 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 operation.
[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.
[ERANGE] The specified values of one or more attributes is less than the minimum or more than
the maximum.
94 Hewlett-Packard Company − 5 − HP-UX 11i Version 3: February 2007