1 /* vi: set sw=4 ts=4: */
3 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
5 * Authors: Alexey Kuznetsov, <kuznet@ms2.inr.ac.ru>
8 * Rani Assaf <rani@magic.metawire.com> 980929: resolve addresses
9 * Bernhard Reutner-Fischer rewrote to use index_in_substr_array
14 //config: select PLATFORM_LINUX
16 //config: The "ip" applet is a TCP/IP interface configuration and routing
17 //config: utility. You generally don't need "ip" to use busybox with
20 //config:config FEATURE_IP_ADDRESS
21 //config: bool "ip address"
23 //config: depends on IP
25 //config: Address manipulation support for the "ip" applet.
27 //config:config FEATURE_IP_LINK
28 //config: bool "ip link"
30 //config: depends on IP
32 //config: Configure network devices with "ip".
34 //config:config FEATURE_IP_ROUTE
35 //config: bool "ip route"
37 //config: depends on IP
39 //config: Add support for routing table management to "ip".
41 //config:config FEATURE_IP_ROUTE_DIR
42 //config: string "ip route configuration directory"
43 //config: default "/etc/iproute2"
44 //config: depends on FEATURE_IP_ROUTE
46 //config: Location of the "ip" applet routing configuration.
48 //config:config FEATURE_IP_TUNNEL
49 //config: bool "ip tunnel"
51 //config: depends on IP
53 //config: Add support for tunneling commands to "ip".
55 //config:config FEATURE_IP_RULE
56 //config: bool "ip rule"
58 //config: depends on IP
60 //config: Add support for rule commands to "ip".
62 //config:config FEATURE_IP_NEIGH
63 //config: bool "ip neighbor"
65 //config: depends on IP
67 //config: Add support for neighbor commands to "ip".
69 //config:config FEATURE_IP_SHORT_FORMS
70 //config: bool "Support short forms of ip commands"
72 //config: depends on IP
74 //config: Also support short-form of ip <OBJECT> commands:
75 //config: ip addr -> ipaddr
76 //config: ip link -> iplink
77 //config: ip route -> iproute
78 //config: ip tunnel -> iptunnel
79 //config: ip rule -> iprule
80 //config: ip neigh -> ipneigh
82 //config: Say N unless you desparately need the short form of the ip
83 //config: object commands.
85 //config:config FEATURE_IP_RARE_PROTOCOLS
86 //config: bool "Support displaying rarely used link types"
88 //config: depends on IP
90 //config: If you are not going to use links of type "frad", "econet",
91 //config: "bif" etc, you probably don't need to enable this.
92 //config: Ethernet, wireless, infrared, ppp/slip, ip tunnelling
93 //config: link types are supported without this option selected.
95 //config:config IPADDR
98 //config: depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ADDRESS
100 //config:config IPLINK
103 //config: depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_LINK
105 //config:config IPROUTE
108 //config: depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_ROUTE
110 //config:config IPTUNNEL
113 //config: depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_TUNNEL
115 //config:config IPRULE
118 //config: depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_RULE
120 //config:config IPNEIGH
123 //config: depends on FEATURE_IP_SHORT_FORMS && FEATURE_IP_NEIGH
125 //applet:#if ENABLE_FEATURE_IP_ADDRESS || ENABLE_FEATURE_IP_ROUTE || ENABLE_FEATURE_IP_LINK || ENABLE_FEATURE_IP_TUNNEL || ENABLE_FEATURE_IP_RULE
126 //applet:IF_IP(APPLET(ip, BB_DIR_SBIN, BB_SUID_DROP))
128 //applet:IF_IPADDR(APPLET(ipaddr, BB_DIR_SBIN, BB_SUID_DROP))
129 //applet:IF_IPLINK(APPLET(iplink, BB_DIR_SBIN, BB_SUID_DROP))
130 //applet:IF_IPROUTE(APPLET(iproute, BB_DIR_SBIN, BB_SUID_DROP))
131 //applet:IF_IPRULE(APPLET(iprule, BB_DIR_SBIN, BB_SUID_DROP))
132 //applet:IF_IPTUNNEL(APPLET(iptunnel, BB_DIR_SBIN, BB_SUID_DROP))
134 //kbuild:lib-$(CONFIG_IP) += ip.o
136 /* would need to make the " | " optional depending on more than one selected: */
137 //usage:#define ip_trivial_usage
138 //usage: "[OPTIONS] {"
139 //usage: IF_FEATURE_IP_ADDRESS("address | ")
140 //usage: IF_FEATURE_IP_ROUTE("route | ")
141 //usage: IF_FEATURE_IP_LINK("link | ")
142 //usage: IF_FEATURE_IP_TUNNEL("tunnel | ")
143 //usage: IF_FEATURE_IP_NEIGH("neigh | ")
144 //usage: IF_FEATURE_IP_RULE("rule")
145 //usage: "} {COMMAND}"
146 //usage:#define ip_full_usage "\n\n"
147 //usage: "ip [OPTIONS] OBJECT {COMMAND}\n"
148 //usage: "where OBJECT := {"
149 //usage: IF_FEATURE_IP_ADDRESS("address | ")
150 //usage: IF_FEATURE_IP_ROUTE("route | ")
151 //usage: IF_FEATURE_IP_LINK("link | ")
152 //usage: IF_FEATURE_IP_TUNNEL("tunnel | ")
153 //usage: IF_FEATURE_IP_NEIGH("neigh | ")
154 //usage: IF_FEATURE_IP_RULE("rule")
156 //usage: "OPTIONS := { -f[amily] { inet | inet6 | link } | -o[neline] }"
158 //usage:#define ipaddr_trivial_usage
159 //usage: "{ {add|del} IFADDR dev STRING | {show|flush}\n"
160 //usage: " [dev STRING] [to PREFIX] }"
161 //usage:#define ipaddr_full_usage "\n\n"
162 //usage: "ipaddr {add|change|replace|delete} IFADDR dev STRING\n"
163 //usage: "ipaddr {show|flush} [dev STRING] [scope SCOPE-ID]\n"
164 //usage: " [to PREFIX] [label PATTERN]\n"
165 //usage: " IFADDR := PREFIX | ADDR peer PREFIX\n"
166 //usage: " [broadcast ADDR] [anycast ADDR]\n"
167 //usage: " [label STRING] [scope SCOPE-ID]\n"
168 //usage: " SCOPE-ID := [host | link | global | NUMBER]"
170 //usage:#define iplink_trivial_usage
171 //usage: "{ set DEVICE { up | down | arp { on | off } | show [DEVICE] }"
172 //usage:#define iplink_full_usage "\n\n"
173 //usage: "iplink set DEVICE { up | down | arp | multicast { on | off } |\n"
174 //usage: " dynamic { on | off } |\n"
175 //usage: " mtu MTU }\n"
176 //usage: "iplink show [DEVICE]"
178 //usage:#define iproute_trivial_usage
179 //usage: "{ list | flush | add | del | change | append |\n"
180 //usage: " replace | test } ROUTE"
181 //usage:#define iproute_full_usage "\n\n"
182 //usage: "iproute { list | flush } SELECTOR\n"
183 //usage: "iproute get ADDRESS [from ADDRESS iif STRING]\n"
184 //usage: " [oif STRING] [tos TOS]\n"
185 //usage: "iproute { add | del | change | append | replace | test } ROUTE\n"
186 //usage: " SELECTOR := [root PREFIX] [match PREFIX] [proto RTPROTO]\n"
187 //usage: " ROUTE := [TYPE] PREFIX [tos TOS] [proto RTPROTO] [metric METRIC]"
189 //usage:#define iprule_trivial_usage
190 //usage: "{[list | add | del] RULE}"
191 //usage:#define iprule_full_usage "\n\n"
192 //usage: "iprule [list | add | del] SELECTOR ACTION\n"
193 //usage: " SELECTOR := [from PREFIX] [to PREFIX] [tos TOS] [fwmark FWMARK]\n"
194 //usage: " [dev STRING] [pref NUMBER]\n"
195 //usage: " ACTION := [table TABLE_ID] [nat ADDRESS]\n"
196 //usage: " [prohibit | reject | unreachable]\n"
197 //usage: " [realms [SRCREALM/]DSTREALM]\n"
198 //usage: " TABLE_ID := [local | main | default | NUMBER]"
200 //usage:#define iptunnel_trivial_usage
201 //usage: "{ add | change | del | show } [NAME]\n"
202 //usage: " [mode { ipip | gre | sit }]\n"
203 //usage: " [remote ADDR] [local ADDR] [ttl TTL]"
204 //usage:#define iptunnel_full_usage "\n\n"
205 //usage: "iptunnel { add | change | del | show } [NAME]\n"
206 //usage: " [mode { ipip | gre | sit }] [remote ADDR] [local ADDR]\n"
207 //usage: " [[i|o]seq] [[i|o]key KEY] [[i|o]csum]\n"
208 //usage: " [ttl TTL] [tos TOS] [[no]pmtudisc] [dev PHYS_DEV]"
210 //usage:#define ipneigh_trivial_usage
211 //usage: "{ show | flush} [ to PREFIX ] [ dev DEV ] [ nud STATE ]"
212 //usage:#define ipneigh_full_usage "\n\n"
213 //usage: "ipneigh { show | flush} [ to PREFIX ] [ dev DEV ] [ nud STATE ]"
217 #include "libiproute/utils.h"
218 #include "libiproute/ip_common.h"
220 #if ENABLE_FEATURE_IP_ADDRESS \
221 || ENABLE_FEATURE_IP_ROUTE \
222 || ENABLE_FEATURE_IP_LINK \
223 || ENABLE_FEATURE_IP_TUNNEL \
224 || ENABLE_FEATURE_IP_RULE \
225 || ENABLE_FEATURE_IP_NEIGH
227 static int FAST_FUNC ip_print_help(char **argv UNUSED_PARAM)
232 typedef int FAST_FUNC (*ip_func_ptr_t)(char**);
234 static int ip_do(ip_func_ptr_t ip_func, char **argv)
236 argv = ip_parse_common_args(argv + 1);
237 return ip_func(argv);
240 #if ENABLE_FEATURE_IP_ADDRESS
241 int ipaddr_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
242 int ipaddr_main(int argc UNUSED_PARAM, char **argv)
244 return ip_do(do_ipaddr, argv);
247 #if ENABLE_FEATURE_IP_LINK
248 int iplink_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
249 int iplink_main(int argc UNUSED_PARAM, char **argv)
251 return ip_do(do_iplink, argv);
254 #if ENABLE_FEATURE_IP_ROUTE
255 int iproute_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
256 int iproute_main(int argc UNUSED_PARAM, char **argv)
258 return ip_do(do_iproute, argv);
261 #if ENABLE_FEATURE_IP_RULE
262 int iprule_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
263 int iprule_main(int argc UNUSED_PARAM, char **argv)
265 return ip_do(do_iprule, argv);
268 #if ENABLE_FEATURE_IP_TUNNEL
269 int iptunnel_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
270 int iptunnel_main(int argc UNUSED_PARAM, char **argv)
272 return ip_do(do_iptunnel, argv);
275 #if ENABLE_FEATURE_IP_NEIGH
276 int ipneigh_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
277 int ipneigh_main(int argc UNUSED_PARAM, char **argv)
279 return ip_do(do_ipneigh, argv);
284 int ip_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
285 int ip_main(int argc UNUSED_PARAM, char **argv)
287 static const char keywords[] ALIGN1 =
288 IF_FEATURE_IP_ADDRESS("address\0")
289 IF_FEATURE_IP_ROUTE("route\0")
290 IF_FEATURE_IP_ROUTE("r\0")
291 IF_FEATURE_IP_LINK("link\0")
292 IF_FEATURE_IP_TUNNEL("tunnel\0")
293 IF_FEATURE_IP_TUNNEL("tunl\0")
294 IF_FEATURE_IP_RULE("rule\0")
295 IF_FEATURE_IP_NEIGH("neigh\0")
297 static const ip_func_ptr_t ip_func_ptrs[] = {
299 IF_FEATURE_IP_ADDRESS(do_ipaddr,)
300 IF_FEATURE_IP_ROUTE(do_iproute,)
301 IF_FEATURE_IP_ROUTE(do_iproute,)
302 IF_FEATURE_IP_LINK(do_iplink,)
303 IF_FEATURE_IP_TUNNEL(do_iptunnel,)
304 IF_FEATURE_IP_TUNNEL(do_iptunnel,)
305 IF_FEATURE_IP_RULE(do_iprule,)
306 IF_FEATURE_IP_NEIGH(do_ipneigh,)
308 ip_func_ptr_t ip_func;
311 argv = ip_parse_common_args(argv + 1);
312 key = *argv ? index_in_substrings(keywords, *argv++) : -1;
313 ip_func = ip_func_ptrs[key + 1];
315 return ip_func(argv);
318 #endif /* any of ENABLE_FEATURE_IP_xxx is 1 */