ifparse(1m) - osol9

1ifparse(1M)             System Administration Commands             ifparse(1M)
2
3
4

NAME

6       ifparse - parse ifconfig command line
7

SYNOPSIS

9       /sbin/ifparse [-fs] addr_family commands
10
11

DESCRIPTION

13       Use  the ifparse command to parse the ifconfig(1M) command line options
14       and output substrings, one per line, as appropriate. If no options  are
15       specified, ifparse returns the entire ifconfig command line as a series
16       of substrings, one per line.
17

OPTIONS

19       The ifparse command supports the following options:
20
21       -f    Lists only substrings of the ifconfig command line that are rele‐
22             vant to IP network multipath failover
23
24
25       -s     Lists  only substrings of the ifconfig command line that are not
26             relevant to IP network multipath failover
27
28

OPERANDS

30       The ifparse command does not  support  the  interface  operand  of  the
31       ifconfig command.
32

EXAMPLES

34       Example 1 Parsing Command Line Options Relevant to Failover
35
36
37       The following example shows the use of the ifparse command to parse the
38       command line options relevant to IP network multipath failover:
39
40
41         example# ifparse -f inet 1.2.3.4 up group one addif 1.2.3.5 -failover up
42         set 1.2.3.4 up
43
44
45
46       Example 2 Parsing  Command  Line  Options  That  Are  Not  Relevant  to
47       Failover
48
49
50       The following example shows the use of the ifparse command to parse the
51       command line options that are not  relevant  to  IP  network  multipath
52       failover:
53
54
55         example# ifparse -s inet 1.2.3.4 up group one addif 1.2.3.5 -failover up
56         group one
57         addif 1.2.3.5 -failover up
58
59
60
61       Example 3 Parsing the Command Line For All Options
62
63
64       The following example shows the use of the ifparse command to parse the
65       command line for all ifconfig options:
66
67
68         example# ifparse inet 1.2.3.4 up group one addif 1.2.3.5 -failover up
69         group one
70         set 1.2.3.4 up
71         addif 1.2.3.5 -failover up
72
73
74

ATTRIBUTES

76       See attributes(5) for descriptions of the following attributes:
77
78
79
80
81       ┌─────────────────────────────┬─────────────────────────────┐
82       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
83       ├─────────────────────────────┼─────────────────────────────┤
84       │Availability                 │SUNWcsr                      │
85       ├─────────────────────────────┼─────────────────────────────┤
86       │Stability Level              │Obsolete                     │
87       └─────────────────────────────┴─────────────────────────────┘
88

DIAGNOSTICS

93       usage: -fs <addr_family> <commands>
94           Description:
95
96
97           This message indicates an invalid command line.
98
99
100
101       ifparse: Not enough space
102           Description:
103
104
105           This message indicates insufficient memory.
106
107
108
109       ifparse: dhcp not supported for inet6
110           Description:
111
112
113           DHCP operations are not supported for the inet6 address family.
114
115
116
117       ifparse: Operation <operation> not supported for <addr_family>
118           Description:
119
120
121           Most operations cannot be used with all address families. For exam‐
122           ple,  the broadcast operation is not supported on the inet6 address
123           family.
124
125
126
127       ifparse: no argument for <operation>
128           Description:
129
130
131           Some operations, for example broadcast, require an argument.
132
133

NOTES

135       The ifparse command is classified as an  obsolete  interface.  It  will
136       likely  be removed in a future release. You should not develop applica‐
137       tions that depend upon this interface.
138
139
140
141SunOS 5.11                        9 May 2001                       ifparse(1M)