System Administration Commands                        ifparse(1M)



NAME
     ifparse - parse ifconfig command line

SYNOPSIS
     /sbin/ifparse [-fs] addrfamily 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:





SunOS 5.11           Last change: 9 May 2001                    1






System Administration Commands                        ifparse(1M)



       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



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsr                     
    
     Stability Level              Obsolete                    
    


SEE ALSO
     ifconfig(1M), attributes(5)

DIAGNOSTICS
     usage: -fs  
         Description:


         This message indicates an invalid command line.



     ifparse: Not enough space
         Description:






SunOS 5.11           Last change: 9 May 2001                    2






System Administration Commands                        ifparse(1M)



         This message indicates insufficient memory.



     ifparse: dhcp not supported for inet6
         Description:


         DHCP operations are not supported for the inet6  address
         family.



     ifparse:   Operation      not    supported    for
     
         Description:


         Most operations cannot be used with  all  address  fami-
         lies.  For  example, the broadcast operation is not sup-
         ported on the inet6 address family.



     ifparse: no argument for 
         Description:


         Some operations, for example broadcast, require an argu-
         ment.


NOTES
     The ifparse command is classified as an obsolete  interface.
     It  will  likely  be removed in a future release. You should
     not develop applications that depend upon this interface.



















SunOS 5.11           Last change: 9 May 2001                    3