if_mpadm(1M) System Administration Commands if_mpadm(1M)NAMEif_mpadm - change operational status of interfaces within a multi‐
pathing group
SYNOPSIS
/usr/sbin/if_mpadm -d interface_name
/usr/sbin/if_mpadm -r interface_name
DESCRIPTION
Use the if_mpadm utility to change the operational status of interfaces
that are part of an IP multipathing group. If the interface is opera‐
tional, you can use if_mpadm-d to detach or off-line the interface. If
the interface is off-lined, use if_mpadm-r to revert it to its origi‐
nal state.
When a network interface is off-lined, all network access fails over to
a different interface in the IP multipathing group. Any addresses that
do not failover are brought down. Network access includes unicast,
broadcast, and multicast for IPv4 and unicast and multicast for IPv6.
Addresses marked with IFF_NOFAILOVER do not failover. They are marked
down. After an interface is off-lined, the system will not use the
interface for any outbound or inbound traffic, and the interface can be
safely removed from the system without any loss of network access.
The if_mpadm utility can be applied only to interfaces that are part of
an IP multipathing group.
OPTIONS
The if_mpadm utility supports the following options:
-d interface_name Detach or off-line the interface specified by
interface_name.
-r interface_name Reattach or undo the previous detach or off-
line operation on the interface specified by
interface_name. Unless the -d option was used
to detach or off-line the interface, this
option will fail.
EXAMPLES
Example 1: Detaching an Interface
Use the following command to off-line or detach the interface. All net‐
work access will failover from hme0 to other interfaces in the same IP
multipathing group. If no other interfaces are in the same group, the
operation will fail.
example% if_mpadm-d hme0
Example 2: Reattaching an Off-line Interface
Use the following command to undo the previous operation. Network
access will failback to hme0.
example% if_mpdadm -r hme0
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWcsu │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │Unstable │
└─────────────────────────────┴─────────────────────────────┘
SEE ALSOifconfig(1M), in.mpathd(1M), attributes(5)DIAGNOSTICS
off-line failed as there is no other functional interface available in
the multipathing group for failing over the network access.
This message means that other interfaces in the group are failed over
already or the multipathing configuration was not suitable for com‐
pleting a failover.
off-line cannot be undone because multipathing configuration is not
consistent across all the interfaces in the group.
This message means that some interfaces in the IP multipathing group
are not configured consistently with other interfaces in the group,
for example, one of the interfaces in the group does not have an
IFF_NOFAILOVER address.
SunOS 5.10 3 Sep 2002 if_mpadm(1M)