1 /* vi: set sw=4 ts=4: */
4 * Similar to the standard Unix ifconfig, but with only the necessary
5 * parts for AF_INET, and without any printing of if info (for now).
7 * Bjorn Wesen, Axis Communications AB
10 * Authors of the original ifconfig was:
11 * Fred N. van Kempen, <waltje@uwalt.nl.mugnet.org>
13 * Licensed under GPLv2 or later, see file LICENSE in this source tree.
17 * Heavily modified by Manuel Novoa III Mar 6, 2001
19 * From initial port to busybox, removed most of the redundancy by
20 * converting to a table-driven approach. Added several (optional)
21 * args missing from initial port.
23 * Still missing: media, tunnel.
26 * IPV6 support added by Bart Visscher <magick@linux-fan.com>
28 //config:config IFCONFIG
29 //config: bool "ifconfig"
31 //config: select PLATFORM_LINUX
33 //config: Ifconfig is used to configure the kernel-resident network interfaces.
35 //config:config FEATURE_IFCONFIG_STATUS
36 //config: bool "Enable status reporting output (+7k)"
38 //config: depends on IFCONFIG
40 //config: If ifconfig is called with no arguments it will display the status
41 //config: of the currently active interfaces.
43 //config:config FEATURE_IFCONFIG_SLIP
44 //config: bool "Enable slip-specific options \"keepalive\" and \"outfill\""
46 //config: depends on IFCONFIG
48 //config: Allow "keepalive" and "outfill" support for SLIP. If you're not
49 //config: planning on using serial lines, leave this unchecked.
51 //config:config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
52 //config: bool "Enable options \"mem_start\", \"io_addr\", and \"irq\""
54 //config: depends on IFCONFIG
56 //config: Allow the start address for shared memory, start address for I/O,
57 //config: and/or the interrupt line used by the specified device.
59 //config:config FEATURE_IFCONFIG_HW
60 //config: bool "Enable option \"hw\" (ether only)"
62 //config: depends on IFCONFIG
64 //config: Set the hardware address of this interface, if the device driver
65 //config: supports this operation. Currently, we only support the 'ether'
68 //config:config FEATURE_IFCONFIG_BROADCAST_PLUS
69 //config: bool "Set the broadcast automatically"
71 //config: depends on IFCONFIG
73 //config: Setting this will make ifconfig attempt to find the broadcast
74 //config: automatically if the value '+' is used.
76 //applet:IF_IFCONFIG(APPLET(ifconfig, BB_DIR_SBIN, BB_SUID_DROP))
78 //kbuild:lib-$(CONFIG_IFCONFIG) += ifconfig.o interface.o
80 //usage:#define ifconfig_trivial_usage
81 //usage: IF_FEATURE_IFCONFIG_STATUS("[-a]") " interface [address]"
82 //usage:#define ifconfig_full_usage "\n\n"
83 //usage: "Configure a network interface\n"
85 //usage: IF_FEATURE_IPV6(
86 //usage: " [add ADDRESS[/PREFIXLEN]]\n")
87 //usage: IF_FEATURE_IPV6(
88 //usage: " [del ADDRESS[/PREFIXLEN]]\n")
89 //usage: " [[-]broadcast [ADDRESS]] [[-]pointopoint [ADDRESS]]\n"
90 //usage: " [netmask ADDRESS] [dstaddr ADDRESS]\n"
91 //usage: IF_FEATURE_IFCONFIG_SLIP(
92 //usage: " [outfill NN] [keepalive NN]\n")
93 //usage: " " IF_FEATURE_IFCONFIG_HW("[hw ether" IF_FEATURE_HWIB("|infiniband")" ADDRESS] ") "[metric NN] [mtu NN]\n"
94 //usage: " [[-]trailers] [[-]arp] [[-]allmulti]\n"
95 //usage: " [multicast] [[-]promisc] [txqueuelen NN] [[-]dynamic]\n"
96 //usage: IF_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ(
97 //usage: " [mem_start NN] [io_addr NN] [irq NN]\n")
98 //usage: " [up|down] ..."
101 #include "inet_common.h"
103 #include <net/if_arp.h>
104 #include <netinet/in.h>
105 #ifdef HAVE_NET_ETHERNET_H
106 # include <net/ethernet.h>
109 #if ENABLE_FEATURE_IFCONFIG_SLIP
110 # include <linux/if_slip.h>
113 /* I don't know if this is needed for busybox or not. Anyone? */
114 #define QUESTIONABLE_ALIAS_CASE
117 /* Defines for glibc2.0 users. */
118 #ifndef SIOCSIFTXQLEN
119 # define SIOCSIFTXQLEN 0x8943
120 # define SIOCGIFTXQLEN 0x8942
123 /* ifr_qlen is ifru_ivalue, but it isn't present in 2.0 kernel headers */
125 # define ifr_qlen ifr_ifru.ifru_mtu
129 # define IFF_DYNAMIC 0x8000 /* dialup device with changing addresses */
132 #if ENABLE_FEATURE_IPV6
134 struct in6_addr ifr6_addr;
135 uint32_t ifr6_prefixlen;
141 * Here are the bit masks for the "flags" member of struct options below.
142 * N_ signifies no arg prefix; M_ signifies arg prefixed by '-'.
143 * CLR clears the flag; SET sets the flag; ARG signifies (optional) arg.
152 #define M_MASK (M_CLR | M_SET | M_ARG)
153 #define N_MASK (N_CLR | N_SET | N_ARG)
154 #define SET_MASK (N_SET | M_SET)
155 #define CLR_MASK (N_CLR | M_CLR)
156 #define SET_CLR_MASK (SET_MASK | CLR_MASK)
157 #define ARG_MASK (M_ARG | N_ARG)
160 * Here are the bit masks for the "arg_flags" member of struct options below.
167 * 02 HOST_COPY in_ether
168 * 03 HOST_COPY INET_resolve
170 #define A_CAST_TYPE 0x03
173 * 00 not a map type (mem_start, io_addr, irq)
174 * 04 memstart (unsigned long)
175 * 08 io_addr (unsigned short)
176 * 0C irq (unsigned char)
178 #define A_MAP_TYPE 0x0C
179 #define A_ARG_REQ 0x10 /* Set if an arg is required. */
180 #define A_NETMASK 0x20 /* Set if netmask (check for multiple sets). */
181 #define A_SET_AFTER 0x40 /* Set a flag at the end. */
182 #define A_COLON_CHK 0x80 /* Is this needed? See below. */
183 #if ENABLE_FEATURE_IFCONFIG_BROADCAST_PLUS
184 #define A_HOSTNAME 0x100 /* Set if it is ip addr. */
185 #define A_BROADCAST 0x200 /* Set if it is broadcast addr. */
188 #define A_BROADCAST 0
192 * These defines are for dealing with the A_CAST_TYPE field.
194 #define A_CAST_CHAR_PTR 0x01
195 #define A_CAST_RESOLVE 0x01
196 #define A_CAST_HOST_COPY 0x02
197 #define A_CAST_HOST_COPY_IN_ETHER A_CAST_HOST_COPY
198 #define A_CAST_HOST_COPY_RESOLVE (A_CAST_HOST_COPY | A_CAST_RESOLVE)
201 * These defines are for dealing with the A_MAP_TYPE field.
203 #define A_MAP_ULONG 0x04 /* memstart */
204 #define A_MAP_USHORT 0x08 /* io_addr */
205 #define A_MAP_UCHAR 0x0C /* irq */
208 * Define the bit masks signifying which operations to perform for each arg.
211 #define ARG_METRIC (A_ARG_REQ /*| A_CAST_INT*/)
212 #define ARG_MTU (A_ARG_REQ /*| A_CAST_INT*/)
213 #define ARG_TXQUEUELEN (A_ARG_REQ /*| A_CAST_INT*/)
214 #define ARG_MEM_START (A_ARG_REQ | A_MAP_ULONG)
215 #define ARG_IO_ADDR (A_ARG_REQ | A_MAP_ULONG)
216 #define ARG_IRQ (A_ARG_REQ | A_MAP_UCHAR)
217 #define ARG_DSTADDR (A_ARG_REQ | A_CAST_HOST_COPY_RESOLVE)
218 #define ARG_NETMASK (A_ARG_REQ | A_CAST_HOST_COPY_RESOLVE | A_NETMASK)
219 #define ARG_BROADCAST (A_ARG_REQ | A_CAST_HOST_COPY_RESOLVE | A_SET_AFTER | A_BROADCAST)
220 #define ARG_HW (A_ARG_REQ | A_CAST_HOST_COPY_IN_ETHER)
221 #define ARG_POINTOPOINT (A_ARG_REQ | A_CAST_HOST_COPY_RESOLVE | A_SET_AFTER)
222 #define ARG_KEEPALIVE (A_ARG_REQ | A_CAST_CHAR_PTR)
223 #define ARG_OUTFILL (A_ARG_REQ | A_CAST_CHAR_PTR)
224 #define ARG_HOSTNAME (A_CAST_HOST_COPY_RESOLVE | A_SET_AFTER | A_COLON_CHK | A_HOSTNAME)
225 #define ARG_ADD_DEL (A_CAST_HOST_COPY_RESOLVE | A_SET_AFTER)
230 unsigned short selector;
231 unsigned short ifr_offset;
236 #if ENABLE_FEATURE_IFCONFIG_BROADCAST_PLUS
237 const unsigned int flags:6;
238 const unsigned int arg_flags:10;
240 const unsigned char flags;
241 const unsigned char arg_flags;
243 const unsigned short selector;
246 #define ifreq_offsetof(x) offsetof(struct ifreq, x)
249 * Set up the tables. Warning! They must have corresponding order!
252 static const struct arg1opt Arg1Opt[] = {
253 { "SIFMETRIC", SIOCSIFMETRIC, ifreq_offsetof(ifr_metric) },
254 { "SIFMTU", SIOCSIFMTU, ifreq_offsetof(ifr_mtu) },
255 { "SIFTXQLEN", SIOCSIFTXQLEN, ifreq_offsetof(ifr_qlen) },
256 { "SIFDSTADDR", SIOCSIFDSTADDR, ifreq_offsetof(ifr_dstaddr) },
257 { "SIFNETMASK", SIOCSIFNETMASK, ifreq_offsetof(ifr_netmask) },
258 { "SIFBRDADDR", SIOCSIFBRDADDR, ifreq_offsetof(ifr_broadaddr) },
259 #if ENABLE_FEATURE_IFCONFIG_HW
260 { "SIFHWADDR", SIOCSIFHWADDR, ifreq_offsetof(ifr_hwaddr) },
262 { "SIFDSTADDR", SIOCSIFDSTADDR, ifreq_offsetof(ifr_dstaddr) },
263 #ifdef SIOCSKEEPALIVE
264 { "SKEEPALIVE", SIOCSKEEPALIVE, ifreq_offsetof(ifr_data) },
267 { "SOUTFILL", SIOCSOUTFILL, ifreq_offsetof(ifr_data) },
269 #if ENABLE_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
270 { "SIFMAP", SIOCSIFMAP, ifreq_offsetof(ifr_map.mem_start) },
271 { "SIFMAP", SIOCSIFMAP, ifreq_offsetof(ifr_map.base_addr) },
272 { "SIFMAP", SIOCSIFMAP, ifreq_offsetof(ifr_map.irq) },
274 #if ENABLE_FEATURE_IPV6
275 { "SIFADDR", SIOCSIFADDR, ifreq_offsetof(ifr_addr) }, /* IPv6 version ignores the offset */
276 { "DIFADDR", SIOCDIFADDR, ifreq_offsetof(ifr_addr) }, /* IPv6 version ignores the offset */
278 /* Last entry is for unmatched (assumed to be hostname/address) arg. */
279 { "SIFADDR", SIOCSIFADDR, ifreq_offsetof(ifr_addr) },
282 static const struct options OptArray[] = {
283 { "metric", N_ARG, ARG_METRIC, 0 },
284 { "mtu", N_ARG, ARG_MTU, 0 },
285 { "txqueuelen", N_ARG, ARG_TXQUEUELEN, 0 },
286 { "dstaddr", N_ARG, ARG_DSTADDR, 0 },
287 { "netmask", N_ARG, ARG_NETMASK, 0 },
288 { "broadcast", N_ARG | M_CLR, ARG_BROADCAST, IFF_BROADCAST },
289 #if ENABLE_FEATURE_IFCONFIG_HW
290 { "hw", N_ARG, ARG_HW, 0 },
292 { "pointopoint", N_ARG | M_CLR, ARG_POINTOPOINT, IFF_POINTOPOINT },
293 #ifdef SIOCSKEEPALIVE
294 { "keepalive", N_ARG, ARG_KEEPALIVE, 0 },
297 { "outfill", N_ARG, ARG_OUTFILL, 0 },
299 #if ENABLE_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
300 { "mem_start", N_ARG, ARG_MEM_START, 0 },
301 { "io_addr", N_ARG, ARG_IO_ADDR, 0 },
302 { "irq", N_ARG, ARG_IRQ, 0 },
304 #if ENABLE_FEATURE_IPV6
305 { "add", N_ARG, ARG_ADD_DEL, 0 },
306 { "del", N_ARG, ARG_ADD_DEL, 0 },
308 { "arp", N_CLR | M_SET, 0, IFF_NOARP },
309 { "trailers", N_CLR | M_SET, 0, IFF_NOTRAILERS },
310 { "promisc", N_SET | M_CLR, 0, IFF_PROMISC },
311 { "multicast", N_SET | M_CLR, 0, IFF_MULTICAST },
312 { "allmulti", N_SET | M_CLR, 0, IFF_ALLMULTI },
313 { "dynamic", N_SET | M_CLR, 0, IFF_DYNAMIC },
314 { "up", N_SET, 0, (IFF_UP | IFF_RUNNING) },
315 { "down", N_CLR, 0, IFF_UP },
316 { NULL, 0, ARG_HOSTNAME, (IFF_UP | IFF_RUNNING) }
319 int ifconfig_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
320 int ifconfig_main(int argc UNUSED_PARAM, char **argv)
323 struct sockaddr_in sai;
324 #if ENABLE_FEATURE_IFCONFIG_HW
327 const struct arg1opt *a1op;
328 const struct options *op;
329 int sockfd; /* socket fd we use to manipulate stuff with */
331 #if ENABLE_FEATURE_IFCONFIG_BROADCAST_PLUS
333 unsigned int did_flags;
334 unsigned int sai_hostname, sai_netmask;
337 unsigned char did_flags;
341 const char *host = NULL; /* make gcc happy */
344 #if ENABLE_FEATURE_IFCONFIG_BROADCAST_PLUS
352 #if ENABLE_FEATURE_IFCONFIG_STATUS
353 if (argv[0] && (argv[0][0] == '-' && argv[0][1] == 'a' && !argv[0][2])) {
359 if (!argv[0] || !argv[1]) { /* one or no args */
360 #if ENABLE_FEATURE_IFCONFIG_STATUS
361 return display_interfaces(argv[0] /* can be NULL */);
363 bb_error_msg_and_die("no support for status display");
367 /* Create a channel to the NET kernel. */
368 sockfd = xsocket(AF_INET, SOCK_DGRAM, 0);
370 /* get interface name */
371 strncpy_IFNAMSIZ(ifr.ifr_name, *argv);
373 /* Process the remaining arguments. */
374 while (*++argv != NULL) {
377 if (*p == '-') { /* If the arg starts with '-'... */
378 ++p; /* advance past it and */
379 mask = M_MASK; /* set the appropriate mask. */
381 for (op = OptArray; op->name; op++) { /* Find table entry. */
382 if (strcmp(p, op->name) == 0) { /* If name matches... */
384 if (mask) /* set the mask and go. */
386 /* If we get here, there was a valid arg with an */
387 /* invalid '-' prefix. */
388 bb_error_msg_and_die("bad: '%s'", p-1);
392 /* We fell through, so treat as possible hostname. */
393 a1op = Arg1Opt + ARRAY_SIZE(Arg1Opt) - 1;
394 mask = op->arg_flags;
398 if (mask & ARG_MASK) {
399 mask = op->arg_flags;
400 if (mask & A_NETMASK & did_flags)
402 a1op = Arg1Opt + (op - OptArray);
403 if (*++argv == NULL) {
404 if (mask & A_ARG_REQ)
407 mask &= A_SET_AFTER; /* just for broadcast */
408 } else { /* got an arg so process it */
410 did_flags |= (mask & (A_NETMASK|A_HOSTNAME));
411 if (mask & A_CAST_HOST_COPY) {
412 #if ENABLE_FEATURE_IFCONFIG_HW
413 if (mask & A_CAST_RESOLVE) {
416 if (strcmp(host, "inet") == 0)
417 continue; /* compat stuff */
418 sai.sin_family = AF_INET;
420 if (strcmp(host, "default") == 0) {
421 /* Default is special, meaning 0.0.0.0. */
422 sai.sin_addr.s_addr = INADDR_ANY;
424 #if ENABLE_FEATURE_IFCONFIG_BROADCAST_PLUS
425 else if ((host[0] == '+' && !host[1])
426 && (mask & A_BROADCAST)
427 && (did_flags & (A_NETMASK|A_HOSTNAME)) == (A_NETMASK|A_HOSTNAME)
429 /* + is special, meaning broadcast is derived. */
430 sai.sin_addr.s_addr = (~sai_netmask) | (sai_hostname & sai_netmask);
434 len_and_sockaddr *lsa;
435 #if ENABLE_FEATURE_IPV6
438 prefix = strchr(host, '/');
440 prefix_len = xatou_range(prefix + 1, 0, 128);
445 lsa = xhost2sockaddr(host, 0);
446 #if ENABLE_FEATURE_IPV6
447 if (lsa->u.sa.sa_family != AF_INET6 && prefix) {
448 /* TODO: we do not support "ifconfig eth0 up 1.2.3.4/17".
449 * For now, just make it fail instead of silently ignoring "/17" part:
454 if (lsa->u.sa.sa_family == AF_INET6) {
456 struct in6_ifreq ifr6;
458 sockfd6 = xsocket(AF_INET6, SOCK_DGRAM, 0);
459 xioctl(sockfd6, SIOCGIFINDEX, &ifr);
460 ifr6.ifr6_ifindex = ifr.ifr_ifindex;
461 ifr6.ifr6_prefixlen = prefix_len;
462 memcpy(&ifr6.ifr6_addr,
463 &lsa->u.sin6.sin6_addr,
464 sizeof(struct in6_addr));
465 ioctl_or_perror_and_die(sockfd6, a1op->selector, &ifr6, "SIOC%s", a1op->name);
466 if (ENABLE_FEATURE_CLEAN_UP)
471 sai.sin_addr = lsa->u.sin.sin_addr;
472 if (ENABLE_FEATURE_CLEAN_UP)
475 #if ENABLE_FEATURE_IFCONFIG_BROADCAST_PLUS
476 if (mask & A_HOSTNAME)
477 sai_hostname = sai.sin_addr.s_addr;
478 if (mask & A_NETMASK)
479 sai_netmask = sai.sin_addr.s_addr;
482 #if ENABLE_FEATURE_IFCONFIG_HW
483 } else { /* A_CAST_HOST_COPY_IN_ETHER */
484 /* This is the "hw" arg case. */
485 smalluint hw_class = index_in_substrings("ether\0"
486 IF_FEATURE_HWIB("infiniband\0"), *argv) + 1;
487 if (!hw_class || !*++argv)
490 if (hw_class == 1 ? in_ether(host, &sa) : in_ib(host, &sa))
491 bb_error_msg_and_die("invalid hw-addr %s", host);
495 memcpy( ((char *)&ifr) + a1op->ifr_offset,
496 p, sizeof(struct sockaddr));
498 /* FIXME: error check?? */
499 unsigned long i = strtoul(*argv, NULL, 0);
500 p = ((char *)&ifr) + a1op->ifr_offset;
501 #if ENABLE_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
502 if (mask & A_MAP_TYPE) {
503 xioctl(sockfd, SIOCGIFMAP, &ifr);
504 if ((mask & A_MAP_UCHAR) == A_MAP_UCHAR)
505 *(unsigned char *) p = i;
506 else if (mask & A_MAP_USHORT)
507 *(unsigned short *) p = i;
509 *(unsigned long *) p = i;
512 if (mask & A_CAST_CHAR_PTR)
513 *(caddr_t *) p = (caddr_t) i;
514 else /* A_CAST_INT */
518 ioctl_or_perror_and_die(sockfd, a1op->selector, &ifr, "SIOC%s", a1op->name);
519 #ifdef QUESTIONABLE_ALIAS_CASE
520 if (mask & A_COLON_CHK) {
522 * Don't do the set_flag() if the address is an alias with
523 * a '-' at the end, since it's deleted already! - Roman
525 * Should really use regex.h here, not sure though how well
526 * it'll go with the cross-platform support etc.
529 short int found_colon = 0;
530 for (ptr = ifr.ifr_name; *ptr; ptr++)
533 if (found_colon && ptr[-1] == '-')
538 if (!(mask & A_SET_AFTER))
541 } /* if (mask & ARG_MASK) */
543 xioctl(sockfd, SIOCGIFFLAGS, &ifr);
544 selector = op->selector;
546 ifr.ifr_flags |= selector;
548 ifr.ifr_flags &= ~selector;
549 xioctl(sockfd, SIOCSIFFLAGS, &ifr);
552 if (ENABLE_FEATURE_CLEAN_UP)