ifparse(1m) [sunos man page]
ifparse(1M) System Administration Commands ifparse(1M) NAME
ifparse - parse ifconfig command line SYNOPSIS
/sbin/ifparse [-fs] addr_family commands DESCRIPTION
Use the ifparse command to parse the ifconfig(1M) command line options and output substrings, one per line, as appropriate. If no options are specified, ifparse returns the entire ifconfig command line as a series of substrings, one per line. OPTIONS
The ifparse command supports the following options: -f Lists only substrings of the ifconfig command line that are relevant to IP network multipath failover -s Lists only substrings of the ifconfig command line that are not relevant to IP network multipath failover OPERANDS
The ifparse command does not support the interface operand of the ifconfig command. EXAMPLES
Example 1: Parsing Command Line Options Relevant to Failover The following example shows the use of the ifparse command to parse the command line options relevant to IP network multipath failover: example# ifparse -f inet 1.2.3.4 up group one addif 1.2.3.5 -failover up set 1.2.3.4 up Example 2: Parsing Command Line Options That Are Not Relevant to Failover The following example shows the use of the ifparse command to parse the command line options that are not relevant to IP network multipath failover: example# ifparse -s inet 1.2.3.4 up group one addif 1.2.3.5 -failover up group one addif 1.2.3.5 -failover up Example 3: Parsing the Command Line For All Options The following example shows the use of the ifparse command to parse the command line for all ifconfig options: example# ifparse inet 1.2.3.4 up group one addif 1.2.3.5 -failover up group one set 1.2.3.4 up addif 1.2.3.5 -failover up ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcsr | +-----------------------------+-----------------------------+ |Stability Level |Obsolete | +-----------------------------+-----------------------------+ SEE ALSO
ifconfig(1M), attributes(5) DIAGNOSTICS
usage: -fs <addr_family> <commands> This message indicates an invalid command line. ifparse: Not enough space This message indicates insufficient memory. ifparse: dhcp not supported for inet6 DHCP operations are not supported for the inet6 address family. ifparse: Operation <operation> not supported for <addr_family> Most operations cannot be used with all address families. For example, the broadcast operation is not supported on the inet6 address fam- ily. ifparse: no argument for <operation> Some operations, for example broadcast, require an argument. NOTES
The ifparse command is classified as an obsolete interface. It will likely be removed in a future release. You should not develop applica- tions that depend upon this interface. SunOS 5.10 9 May 2001 ifparse(1M)
Check Out this Related Man Page
if_mpadm(1M) System Administration Commands if_mpadm(1M) NAME
if_mpadm - change operational status of interfaces within a multipathing 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 operational, 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 original 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 network 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 ALSO
ifconfig(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)