make --help texts smaller
[oweals/busybox.git] / networking / ip.c
1 /* vi: set sw=4 ts=4: */
2 /*
3  * Licensed under GPLv2 or later, see file LICENSE in this source tree.
4  *
5  * Authors: Alexey Kuznetsov, <kuznet@ms2.inr.ac.ru>
6  *
7  * Changes:
8  * Rani Assaf <rani@magic.metawire.com> 980929: resolve addresses
9  * Bernhard Reutner-Fischer rewrote to use index_in_substr_array
10  */
11 //config:config IP
12 //config:       bool "ip"
13 //config:       default y
14 //config:       select PLATFORM_LINUX
15 //config:       help
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
18 //config:         TCP/IP.
19 //config:
20 //config:config IPADDR
21 //config:       bool "ipaddr"
22 //config:       default y
23 //config:       select FEATURE_IP_ADDRESS
24 //config:       select PLATFORM_LINUX
25 //config:       help
26 //config:         Support short form of ip addr: ipaddr
27 //config:
28 //config:config IPLINK
29 //config:       bool "iplink"
30 //config:       default y
31 //config:       select FEATURE_IP_LINK
32 //config:       select PLATFORM_LINUX
33 //config:       help
34 //config:         Support short form of ip link: iplink
35 //config:
36 //config:config IPROUTE
37 //config:       bool "iproute"
38 //config:       default y
39 //config:       select FEATURE_IP_ROUTE
40 //config:       select PLATFORM_LINUX
41 //config:       help
42 //config:         Support short form of ip route: iproute
43 //config:
44 //config:config IPTUNNEL
45 //config:       bool "iptunnel"
46 //config:       default y
47 //config:       select FEATURE_IP_TUNNEL
48 //config:       select PLATFORM_LINUX
49 //config:       help
50 //config:         Support short form of ip tunnel: iptunnel
51 //config:
52 //config:config IPRULE
53 //config:       bool "iprule"
54 //config:       default y
55 //config:       select FEATURE_IP_RULE
56 //config:       select PLATFORM_LINUX
57 //config:       help
58 //config:         Support short form of ip rule: iprule
59 //config:
60 //config:config IPNEIGH
61 //config:       bool "ipneigh"
62 //config:       default y
63 //config:       select FEATURE_IP_NEIGH
64 //config:       select PLATFORM_LINUX
65 //config:       help
66 //config:         Support short form of ip neigh: ipneigh
67 //config:
68 //config:config FEATURE_IP_ADDRESS
69 //config:       bool "ip address"
70 //config:       default y
71 //config:       depends on IP || IPADDR
72 //config:       help
73 //config:         Address manipulation support for the "ip" applet.
74 //config:
75 //config:config FEATURE_IP_LINK
76 //config:       bool "ip link"
77 //config:       default y
78 //config:       depends on IP || IPLINK
79 //config:       help
80 //config:         Configure network devices with "ip".
81 //config:
82 //config:config FEATURE_IP_ROUTE
83 //config:       bool "ip route"
84 //config:       default y
85 //config:       depends on IP || IPROUTE
86 //config:       help
87 //config:         Add support for routing table management to "ip".
88 //config:
89 //config:config FEATURE_IP_ROUTE_DIR
90 //config:       string "ip route configuration directory"
91 //config:       default "/etc/iproute2"
92 //config:       depends on FEATURE_IP_ROUTE
93 //config:       help
94 //config:         Location of the "ip" applet routing configuration.
95 //config:
96 //config:config FEATURE_IP_TUNNEL
97 //config:       bool "ip tunnel"
98 //config:       default y
99 //config:       depends on IP || IPTUNNEL
100 //config:       help
101 //config:         Add support for tunneling commands to "ip".
102 //config:
103 //config:config FEATURE_IP_RULE
104 //config:       bool "ip rule"
105 //config:       default y
106 //config:       depends on IP || IPRULE
107 //config:       help
108 //config:         Add support for rule commands to "ip".
109 //config:
110 //config:config FEATURE_IP_NEIGH
111 //config:       bool "ip neighbor"
112 //config:       default y
113 //config:       depends on IP || IPNEIGH
114 //config:       help
115 //config:         Add support for neighbor commands to "ip".
116 //config:
117 //config:config FEATURE_IP_RARE_PROTOCOLS
118 //config:       bool "Support displaying rarely used link types"
119 //config:       default n
120 //config:       depends on IP || IPADDR || IPLINK || IPROUTE || IPTUNNEL || IPRULE || IPNEIGH
121 //config:       help
122 //config:         If you are not going to use links of type "frad", "econet",
123 //config:         "bif" etc, you probably don't need to enable this.
124 //config:         Ethernet, wireless, infrared, ppp/slip, ip tunnelling
125 //config:         link types are supported without this option selected.
126
127 //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))
133 //applet:IF_IPNEIGH(APPLET(ipneigh, BB_DIR_SBIN, BB_SUID_DROP))
134
135 //kbuild:lib-$(CONFIG_IP) += ip.o
136 //kbuild:lib-$(CONFIG_IPADDR) += ip.o
137 //kbuild:lib-$(CONFIG_IPLINK) += ip.o
138 //kbuild:lib-$(CONFIG_IPROUTE) += ip.o
139 //kbuild:lib-$(CONFIG_IPRULE) += ip.o
140 //kbuild:lib-$(CONFIG_IPTUNNEL) += ip.o
141 //kbuild:lib-$(CONFIG_IPNEIGH) += ip.o
142
143 /* would need to make the " | " optional depending on more than one selected: */
144 //usage:#define ip_trivial_usage
145 //usage:       "[OPTIONS] "
146 //usage:        IF_FEATURE_IP_ADDRESS("address|")
147 //usage:        IF_FEATURE_IP_ROUTE("route|")
148 //usage:        IF_FEATURE_IP_LINK("link|")
149 //usage:        IF_FEATURE_IP_TUNNEL("tunnel|")
150 //usage:        IF_FEATURE_IP_NEIGH("neigh|")
151 //usage:        IF_FEATURE_IP_RULE("rule")
152 //usage:       " [COMMAND]"
153 //usage:#define ip_full_usage "\n\n"
154 //usage:       "ip [OPTIONS] OBJECT [COMMAND]\n"
155 //usage:       "where OBJECT := "
156 //usage:        IF_FEATURE_IP_ADDRESS("address|")
157 //usage:        IF_FEATURE_IP_ROUTE("route|")
158 //usage:        IF_FEATURE_IP_LINK("link|")
159 //usage:        IF_FEATURE_IP_TUNNEL("tunnel|")
160 //usage:        IF_FEATURE_IP_NEIGH("neigh|")
161 //usage:        IF_FEATURE_IP_RULE("rule")
162 //usage:       "\n"
163 //usage:       "OPTIONS := -f[amily] inet|inet6|link | -o[neline]"
164 //usage:
165 //usage:#define ipaddr_trivial_usage
166 //usage:       "add|del IFADDR dev STRING | show|flush [dev STRING] [to PREFIX]"
167 //usage:#define ipaddr_full_usage "\n\n"
168 //usage:       "ipaddr add|change|replace|delete IFADDR dev STRING\n"
169 //usage:       "ipaddr show|flush [dev STRING] [scope SCOPE-ID]\n"
170 //usage:       "        [to PREFIX] [label PATTERN]\n"
171 //usage:       "        IFADDR := PREFIX | ADDR peer PREFIX\n"
172 //usage:       "        [broadcast ADDR] [anycast ADDR]\n"
173 //usage:       "        [label STRING] [scope SCOPE-ID]\n"
174 //usage:       "        SCOPE-ID := [host|link|global|NUMBER]"
175 //usage:
176 //usage:#define iplink_trivial_usage
177 //usage:       "{ set DEVICE [up|down] [arp on|off] } | show [DEVICE]"
178 //usage:#define iplink_full_usage "\n\n"
179 //usage:       "iplink set DEVICE [up|down]\n"
180 //usage:       "        [arp on|off]\n"
181 //usage:       "        [dynamic on|off]\n"
182 //usage:       "        [multicast on|off]\n"
183 //usage:       "        [mtu MTU]\n"
184 //usage:       "iplink show [DEVICE]"
185 //usage:
186 //usage:#define iproute_trivial_usage
187 //usage:       "list|flush|add|del|change|append|replace|test ROUTE"
188 //usage:#define iproute_full_usage "\n\n"
189 //usage:       "iproute list|flush SELECTOR\n"
190 //usage:       "iproute get ADDRESS [from ADDRESS iif STRING]\n"
191 //usage:       "        [oif STRING] [tos TOS]\n"
192 //usage:       "iproute add|del|change|append|replace|test ROUTE\n"
193 //usage:       "        SELECTOR := [root PREFIX] [match PREFIX] [proto RTPROTO]\n"
194 //usage:       "        ROUTE := [TYPE] PREFIX [tos TOS] [proto RTPROTO] [metric METRIC]"
195 //usage:
196 //usage:#define iprule_trivial_usage
197 //usage:       "[list|add|del] RULE"
198 //usage:#define iprule_full_usage "\n\n"
199 //usage:       "iprule [list|add|del] SELECTOR ACTION\n"
200 //usage:       "        SELECTOR := [from PREFIX] [to PREFIX] [tos TOS] [fwmark FWMARK]\n"
201 //usage:       "                        [dev STRING] [pref NUMBER]\n"
202 //usage:       "        ACTION := [table TABLE_ID] [nat ADDRESS]\n"
203 //usage:       "                        [prohibit | reject | unreachable]\n"
204 //usage:       "                        [realms [SRCREALM/]DSTREALM]\n"
205 //usage:       "        TABLE_ID := [local | main | default | NUMBER]"
206 //usage:
207 //usage:#define iptunnel_trivial_usage
208 //usage:       "add|change|del|show [NAME]\n"
209 //usage:       "        [mode ipip|gre|sit]\n"
210 //usage:       "        [remote ADDR] [local ADDR] [ttl TTL]"
211 //usage:#define iptunnel_full_usage "\n\n"
212 //usage:       "iptunnel add|change|del|show [NAME]\n"
213 //usage:       "        [mode ipip|gre|sit] [remote ADDR] [local ADDR]\n"
214 //usage:       "        [[i|o]seq] [[i|o]key KEY] [[i|o]csum]\n"
215 //usage:       "        [ttl TTL] [tos TOS] [[no]pmtudisc] [dev PHYS_DEV]"
216 //usage:
217 //usage:#define ipneigh_trivial_usage
218 //usage:       "show|flush [to PREFIX] [dev DEV] [nud STATE]"
219 //usage:#define ipneigh_full_usage "\n\n"
220 //usage:       "ipneigh show|flush [to PREFIX] [dev DEV] [nud STATE]"
221
222 #include "libbb.h"
223
224 #include "libiproute/utils.h"
225 #include "libiproute/ip_common.h"
226
227 typedef int FAST_FUNC (*ip_func_ptr_t)(char**);
228
229 #if ENABLE_IPADDR \
230  || ENABLE_IPLINK \
231  || ENABLE_IPROUTE \
232  || ENABLE_IPRULE \
233  || ENABLE_IPTUNNEL \
234  || ENABLE_IPNEIGH
235 static int ip_do(ip_func_ptr_t ip_func, char **argv)
236 {
237         argv = ip_parse_common_args(argv + 1);
238         return ip_func(argv);
239 }
240 #endif
241
242 #if ENABLE_IPADDR
243 int ipaddr_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
244 int ipaddr_main(int argc UNUSED_PARAM, char **argv)
245 {
246         return ip_do(do_ipaddr, argv);
247 }
248 #endif
249 #if ENABLE_IPLINK
250 int iplink_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
251 int iplink_main(int argc UNUSED_PARAM, char **argv)
252 {
253         return ip_do(do_iplink, argv);
254 }
255 #endif
256 #if ENABLE_IPROUTE
257 int iproute_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
258 int iproute_main(int argc UNUSED_PARAM, char **argv)
259 {
260         return ip_do(do_iproute, argv);
261 }
262 #endif
263 #if ENABLE_IPRULE
264 int iprule_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
265 int iprule_main(int argc UNUSED_PARAM, char **argv)
266 {
267         return ip_do(do_iprule, argv);
268 }
269 #endif
270 #if ENABLE_IPTUNNEL
271 int iptunnel_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
272 int iptunnel_main(int argc UNUSED_PARAM, char **argv)
273 {
274         return ip_do(do_iptunnel, argv);
275 }
276 #endif
277 #if ENABLE_IPNEIGH
278 int ipneigh_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
279 int ipneigh_main(int argc UNUSED_PARAM, char **argv)
280 {
281         return ip_do(do_ipneigh, argv);
282 }
283 #endif
284
285 #if ENABLE_IP
286 static int FAST_FUNC ip_print_help(char **argv UNUSED_PARAM)
287 {
288         bb_show_usage();
289 }
290
291 int ip_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
292 int ip_main(int argc UNUSED_PARAM, char **argv)
293 {
294         static const char keywords[] ALIGN1 = ""
295                 IF_FEATURE_IP_ADDRESS("address\0")
296                 IF_FEATURE_IP_ROUTE("route\0")
297                 IF_FEATURE_IP_ROUTE("r\0")
298                 IF_FEATURE_IP_LINK("link\0")
299                 IF_FEATURE_IP_TUNNEL("tunnel\0")
300                 IF_FEATURE_IP_TUNNEL("tunl\0")
301                 IF_FEATURE_IP_RULE("rule\0")
302                 IF_FEATURE_IP_NEIGH("neigh\0")
303                 ;
304         static const ip_func_ptr_t ip_func_ptrs[] = {
305                 ip_print_help,
306                 IF_FEATURE_IP_ADDRESS(do_ipaddr,)
307                 IF_FEATURE_IP_ROUTE(do_iproute,)
308                 IF_FEATURE_IP_ROUTE(do_iproute,)
309                 IF_FEATURE_IP_LINK(do_iplink,)
310                 IF_FEATURE_IP_TUNNEL(do_iptunnel,)
311                 IF_FEATURE_IP_TUNNEL(do_iptunnel,)
312                 IF_FEATURE_IP_RULE(do_iprule,)
313                 IF_FEATURE_IP_NEIGH(do_ipneigh,)
314         };
315         ip_func_ptr_t ip_func;
316         int key;
317
318         argv = ip_parse_common_args(argv + 1);
319         if (ARRAY_SIZE(ip_func_ptrs) > 1 && *argv)
320                 key = index_in_substrings(keywords, *argv++);
321         else
322                 key = -1;
323         ip_func = ip_func_ptrs[key + 1];
324
325         return ip_func(argv);
326 }
327 #endif