1 /* vi: set sw=4 ts=4: */
5 * Similar to the standard Unix ifconfig, but with only the necessary
6 * parts for AF_INET, and without any printing of if info (for now).
8 * 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.
16 * Heavily modified by Manuel Novoa III Mar 6, 2001
18 * From initial port to busybox, removed most of the redundancy by
19 * converting to a table-driven approach. Added several (optional)
20 * args missing from initial port.
22 * Still missing: media, tunnel.
25 * IPV6 support added by Bart Visscher <magick@linux-fan.com>
27 //config:config IFCONFIG
28 //config: bool "ifconfig (12 kb)"
31 //config: Ifconfig is used to configure the kernel-resident network interfaces.
33 //config:config FEATURE_IFCONFIG_STATUS
34 //config: bool "Enable status reporting output (+7k)"
36 //config: depends on IFCONFIG
38 //config: If ifconfig is called with no arguments it will display the status
39 //config: of the currently active interfaces.
41 //config:config FEATURE_IFCONFIG_SLIP
42 //config: bool "Enable slip-specific options \"keepalive\" and \"outfill\""
44 //config: depends on IFCONFIG
46 //config: Allow "keepalive" and "outfill" support for SLIP. If you're not
47 //config: planning on using serial lines, leave this unchecked.
49 //config:config FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
50 //config: bool "Enable options \"mem_start\", \"io_addr\", and \"irq\""
52 //config: depends on IFCONFIG
54 //config: Allow the start address for shared memory, start address for I/O,
55 //config: and/or the interrupt line used by the specified device.
57 //config:config FEATURE_IFCONFIG_HW
58 //config: bool "Enable option \"hw\" (ether only)"
60 //config: depends on IFCONFIG
62 //config: Set the hardware address of this interface, if the device driver
63 //config: supports this operation. Currently, we only support the 'ether'
66 //config:config FEATURE_IFCONFIG_BROADCAST_PLUS
67 //config: bool "Set the broadcast automatically"
69 //config: depends on IFCONFIG
71 //config: Setting this will make ifconfig attempt to find the broadcast
72 //config: automatically if the value '+' is used.
74 //applet:IF_IFCONFIG(APPLET(ifconfig, BB_DIR_SBIN, BB_SUID_DROP))
76 //kbuild:lib-$(CONFIG_IFCONFIG) += ifconfig.o interface.o
78 //usage:#define ifconfig_trivial_usage
79 //usage: IF_FEATURE_IFCONFIG_STATUS("[-a]") " [IFACE] [ADDRESS]"
80 //usage:#define ifconfig_full_usage "\n\n"
81 //usage: "Configure a network interface\n"
83 //usage: IF_FEATURE_IPV6(
84 //usage: " [add ADDRESS[/PREFIXLEN]]\n")
85 //usage: IF_FEATURE_IPV6(
86 //usage: " [del ADDRESS[/PREFIXLEN]]\n")
87 //usage: " [[-]broadcast [ADDRESS]] [[-]pointopoint [ADDRESS]]\n"
88 //usage: " [netmask ADDRESS] [dstaddr ADDRESS]\n"
89 //usage: IF_FEATURE_IFCONFIG_SLIP(
90 //usage: " [outfill NN] [keepalive NN]\n")
91 //usage: " " IF_FEATURE_IFCONFIG_HW("[hw ether" IF_FEATURE_HWIB("|infiniband")" ADDRESS] ") "[metric NN] [mtu NN]\n"
92 //usage: " [[-]trailers] [[-]arp] [[-]allmulti]\n"
93 //usage: " [multicast] [[-]promisc] [txqueuelen NN] [[-]dynamic]\n"
94 //usage: IF_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ(
95 //usage: " [mem_start NN] [io_addr NN] [irq NN]\n")
96 //usage: " [up|down] ..."
99 #include "inet_common.h"
101 #include <net/if_arp.h>
102 #include <netinet/in.h>
103 #ifdef HAVE_NET_ETHERNET_H
104 # include <net/ethernet.h>
107 #if ENABLE_FEATURE_IFCONFIG_SLIP
108 # include <linux/if_slip.h>
111 /* I don't know if this is needed for busybox or not. Anyone? */
112 #define QUESTIONABLE_ALIAS_CASE
115 /* Defines for glibc2.0 users. */
116 #ifndef SIOCSIFTXQLEN
117 # define SIOCSIFTXQLEN 0x8943
118 # define SIOCGIFTXQLEN 0x8942
121 /* ifr_qlen is ifru_ivalue, but it isn't present in 2.0 kernel headers */
123 # define ifr_qlen ifr_ifru.ifru_mtu
127 # define IFF_DYNAMIC 0x8000 /* dialup device with changing addresses */
130 #if ENABLE_FEATURE_IPV6
132 struct in6_addr ifr6_addr
;
133 uint32_t ifr6_prefixlen
;
139 * Here are the bit masks for the "flags" member of struct options below.
140 * N_ signifies no arg prefix; M_ signifies arg prefixed by '-'.
141 * CLR clears the flag; SET sets the flag; ARG signifies (optional) arg.
150 #define M_MASK (M_CLR | M_SET | M_ARG)
151 #define N_MASK (N_CLR | N_SET | N_ARG)
152 #define SET_MASK (N_SET | M_SET)
153 #define CLR_MASK (N_CLR | M_CLR)
154 #define SET_CLR_MASK (SET_MASK | CLR_MASK)
155 #define ARG_MASK (M_ARG | N_ARG)
158 * Here are the bit masks for the "arg_flags" member of struct options below.
165 * 02 HOST_COPY in_ether
166 * 03 HOST_COPY INET_resolve
168 #define A_CAST_TYPE 0x03
171 * 00 not a map type (mem_start, io_addr, irq)
172 * 04 memstart (unsigned long)
173 * 08 io_addr (unsigned short)
174 * 0C irq (unsigned char)
176 #define A_MAP_TYPE 0x0C
177 #define A_ARG_REQ 0x10 /* Set if an arg is required. */
178 #define A_NETMASK 0x20 /* Set if netmask (check for multiple sets). */
179 #define A_SET_AFTER 0x40 /* Set a flag at the end. */
180 #define A_COLON_CHK 0x80 /* Is this needed? See below. */
181 #if ENABLE_FEATURE_IFCONFIG_BROADCAST_PLUS
182 #define A_HOSTNAME 0x100 /* Set if it is ip addr. */
183 #define A_BROADCAST 0x200 /* Set if it is broadcast addr. */
186 #define A_BROADCAST 0
190 * These defines are for dealing with the A_CAST_TYPE field.
192 #define A_CAST_CHAR_PTR 0x01
193 #define A_CAST_RESOLVE 0x01
194 #define A_CAST_HOST_COPY 0x02
195 #define A_CAST_HOST_COPY_IN_ETHER A_CAST_HOST_COPY
196 #define A_CAST_HOST_COPY_RESOLVE (A_CAST_HOST_COPY | A_CAST_RESOLVE)
199 * These defines are for dealing with the A_MAP_TYPE field.
201 #define A_MAP_ULONG 0x04 /* memstart */
202 #define A_MAP_USHORT 0x08 /* io_addr */
203 #define A_MAP_UCHAR 0x0C /* irq */
206 * Define the bit masks signifying which operations to perform for each arg.
209 #define ARG_METRIC (A_ARG_REQ /*| A_CAST_INT*/)
210 #define ARG_MTU (A_ARG_REQ /*| A_CAST_INT*/)
211 #define ARG_TXQUEUELEN (A_ARG_REQ /*| A_CAST_INT*/)
212 #define ARG_MEM_START (A_ARG_REQ | A_MAP_ULONG)
213 #define ARG_IO_ADDR (A_ARG_REQ | A_MAP_ULONG)
214 #define ARG_IRQ (A_ARG_REQ | A_MAP_UCHAR)
215 #define ARG_DSTADDR (A_ARG_REQ | A_CAST_HOST_COPY_RESOLVE)
216 #define ARG_NETMASK (A_ARG_REQ | A_CAST_HOST_COPY_RESOLVE | A_NETMASK)
217 #define ARG_BROADCAST (A_ARG_REQ | A_CAST_HOST_COPY_RESOLVE | A_SET_AFTER | A_BROADCAST)
218 #define ARG_HW (A_ARG_REQ | A_CAST_HOST_COPY_IN_ETHER)
219 #define ARG_POINTOPOINT (A_ARG_REQ | A_CAST_HOST_COPY_RESOLVE | A_SET_AFTER)
220 #define ARG_KEEPALIVE (A_ARG_REQ | A_CAST_CHAR_PTR)
221 #define ARG_OUTFILL (A_ARG_REQ | A_CAST_CHAR_PTR)
222 #define ARG_HOSTNAME (A_CAST_HOST_COPY_RESOLVE | A_SET_AFTER | A_COLON_CHK | A_HOSTNAME)
223 #define ARG_ADD_DEL (A_CAST_HOST_COPY_RESOLVE | A_SET_AFTER)
228 unsigned short selector
;
229 unsigned short ifr_offset
;
234 #if ENABLE_FEATURE_IFCONFIG_BROADCAST_PLUS
235 const unsigned int flags
:6;
236 const unsigned int arg_flags
:10;
238 const unsigned char flags
;
239 const unsigned char arg_flags
;
241 const unsigned short selector
;
244 #define ifreq_offsetof(x) offsetof(struct ifreq, x)
247 * Set up the tables. Warning! They must have corresponding order!
250 static const struct arg1opt Arg1Opt
[] ALIGN_PTR
= {
251 { "SIFMETRIC", SIOCSIFMETRIC
, ifreq_offsetof(ifr_metric
) },
252 { "SIFMTU", SIOCSIFMTU
, ifreq_offsetof(ifr_mtu
) },
253 { "SIFTXQLEN", SIOCSIFTXQLEN
, ifreq_offsetof(ifr_qlen
) },
254 { "SIFDSTADDR", SIOCSIFDSTADDR
, ifreq_offsetof(ifr_dstaddr
) },
255 { "SIFNETMASK", SIOCSIFNETMASK
, ifreq_offsetof(ifr_netmask
) },
256 { "SIFBRDADDR", SIOCSIFBRDADDR
, ifreq_offsetof(ifr_broadaddr
) },
257 #if ENABLE_FEATURE_IFCONFIG_HW
258 { "SIFHWADDR", SIOCSIFHWADDR
, ifreq_offsetof(ifr_hwaddr
) },
260 { "SIFDSTADDR", SIOCSIFDSTADDR
, ifreq_offsetof(ifr_dstaddr
) },
261 #ifdef SIOCSKEEPALIVE
262 { "SKEEPALIVE", SIOCSKEEPALIVE
, ifreq_offsetof(ifr_data
) },
265 { "SOUTFILL", SIOCSOUTFILL
, ifreq_offsetof(ifr_data
) },
267 #if ENABLE_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
268 { "SIFMAP", SIOCSIFMAP
, ifreq_offsetof(ifr_map
.mem_start
) },
269 { "SIFMAP", SIOCSIFMAP
, ifreq_offsetof(ifr_map
.base_addr
) },
270 { "SIFMAP", SIOCSIFMAP
, ifreq_offsetof(ifr_map
.irq
) },
272 #if ENABLE_FEATURE_IPV6
273 { "SIFADDR", SIOCSIFADDR
, ifreq_offsetof(ifr_addr
) }, /* IPv6 version ignores the offset */
274 { "DIFADDR", SIOCDIFADDR
, ifreq_offsetof(ifr_addr
) }, /* IPv6 version ignores the offset */
276 /* Last entry is for unmatched (assumed to be hostname/address) arg. */
277 { "SIFADDR", SIOCSIFADDR
, ifreq_offsetof(ifr_addr
) },
280 static const struct options OptArray
[] ALIGN_PTR
= {
281 { "metric", N_ARG
, ARG_METRIC
, 0 },
282 { "mtu", N_ARG
, ARG_MTU
, 0 },
283 { "txqueuelen", N_ARG
, ARG_TXQUEUELEN
, 0 },
284 { "dstaddr", N_ARG
, ARG_DSTADDR
, 0 },
285 { "netmask", N_ARG
, ARG_NETMASK
, 0 },
286 { "broadcast", N_ARG
| M_CLR
, ARG_BROADCAST
, IFF_BROADCAST
},
287 #if ENABLE_FEATURE_IFCONFIG_HW
288 { "hw", N_ARG
, ARG_HW
, 0 },
290 { "pointopoint", N_ARG
| M_CLR
, ARG_POINTOPOINT
, IFF_POINTOPOINT
},
291 #ifdef SIOCSKEEPALIVE
292 { "keepalive", N_ARG
, ARG_KEEPALIVE
, 0 },
295 { "outfill", N_ARG
, ARG_OUTFILL
, 0 },
297 #if ENABLE_FEATURE_IFCONFIG_MEMSTART_IOADDR_IRQ
298 { "mem_start", N_ARG
, ARG_MEM_START
, 0 },
299 { "io_addr", N_ARG
, ARG_IO_ADDR
, 0 },
300 { "irq", N_ARG
, ARG_IRQ
, 0 },
302 #if ENABLE_FEATURE_IPV6
303 { "add", N_ARG
, ARG_ADD_DEL
, 0 },
304 { "del", N_ARG
, ARG_ADD_DEL
, 0 },
306 { "arp", N_CLR
| M_SET
, 0, IFF_NOARP
},
307 { "trailers", N_CLR
| M_SET
, 0, IFF_NOTRAILERS
},
308 { "promisc", N_SET
| M_CLR
, 0, IFF_PROMISC
},
309 { "multicast", N_SET
| M_CLR
, 0, IFF_MULTICAST
},
310 { "allmulti", N_SET
| M_CLR
, 0, IFF_ALLMULTI
},
311 { "dynamic", N_SET
| M_CLR
, 0, IFF_DYNAMIC
},
312 { "up", N_SET
, 0, (IFF_UP
| IFF_RUNNING
) },
313 { "down", N_CLR
, 0, IFF_UP
},
314 { NULL
, 0, ARG_HOSTNAME
, (IFF_UP
| IFF_RUNNING
) }
317 int ifconfig_main(int argc
, char **argv
) MAIN_EXTERNALLY_VISIBLE
;
318 int ifconfig_main(int argc UNUSED_PARAM
, char **argv
)
321 struct sockaddr_in sai
;
322 #if ENABLE_FEATURE_IFCONFIG_HW
325 const struct arg1opt
*a1op
;
326 const struct options
*op
;
327 int sockfd
; /* socket fd we use to manipulate stuff with */
329 #if ENABLE_FEATURE_IFCONFIG_BROADCAST_PLUS
331 unsigned int did_flags
;
332 unsigned int sai_hostname
, sai_netmask
;
335 unsigned char did_flags
;
339 const char *host
= NULL
; /* make gcc happy */
340 IF_FEATURE_IFCONFIG_STATUS(char *show_all_param
;)
343 #if ENABLE_FEATURE_IFCONFIG_BROADCAST_PLUS
351 #if ENABLE_FEATURE_IFCONFIG_STATUS
352 show_all_param
= NULL
;
353 if (argv
[0] && argv
[0][0] == '-' && argv
[0][1] == 'a' && !argv
[0][2]) {
355 show_all_param
= IFNAME_SHOW_DOWNED_TOO
;
359 if (!argv
[0] || !argv
[1]) { /* one or no args */
360 #if ENABLE_FEATURE_IFCONFIG_STATUS
361 return display_interfaces(argv
[0] ? argv
[0] : show_all_param
);
363 bb_simple_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
)