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 (34 kb)"
  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.
  18 //config:       Short forms (enabled below) are busybox-specific extensions.
  19 //config:       The standard "ip" utility does not provide them. If you are
  20 //config:       trying to be portable, it's better to use "ip CMD" forms.
  21 //config:
  22 //config:config IPADDR
  23 //config:       bool "ipaddr (14 kb)"
  24 //config:       default y
  25 //config:       select FEATURE_IP_ADDRESS
  26 //config:       select PLATFORM_LINUX
  27 //config:       help
  28 //config:       Short form of "ip addr"
  29 //config:
  30 //config:config IPLINK
  31 //config:       bool "iplink (16 kb)"
  32 //config:       default y
  33 //config:       select FEATURE_IP_LINK
  34 //config:       select PLATFORM_LINUX
  35 //config:       help
  36 //config:       Short form of "ip link"
  37 //config:
  38 //config:config IPROUTE
  39 //config:       bool "iproute (15 kb)"
  40 //config:       default y
  41 //config:       select FEATURE_IP_ROUTE
  42 //config:       select PLATFORM_LINUX
  43 //config:       help
  44 //config:       Short form of "ip route"
  45 //config:
  46 //config:config IPTUNNEL
  47 //config:       bool "iptunnel (9.6 kb)"
  48 //config:       default y
  49 //config:       select FEATURE_IP_TUNNEL
  50 //config:       select PLATFORM_LINUX
  51 //config:       help
  52 //config:       Short form of "ip tunnel"
  53 //config:
  54 //config:config IPRULE
  55 //config:       bool "iprule (10 kb)"
  56 //config:       default y
  57 //config:       select FEATURE_IP_RULE
  58 //config:       select PLATFORM_LINUX
  59 //config:       help
  60 //config:       Short form of "ip rule"
  61 //config:
  62 //config:config IPNEIGH
  63 //config:       bool "ipneigh (8.3 kb)"
  64 //config:       default y
  65 //config:       select FEATURE_IP_NEIGH
  66 //config:       select PLATFORM_LINUX
  67 //config:       help
  68 //config:       Short form of "ip neigh"
  69 //config:
  70 //config:config FEATURE_IP_ADDRESS
  71 //config:       bool "ip address"
  72 //config:       default y
  73 //config:       depends on IP || IPADDR
  74 //config:       help
  75 //config:       Address manipulation support for the "ip" applet.
  76 //config:
  77 //config:config FEATURE_IP_LINK
  78 //config:       bool "ip link"
  79 //config:       default y
  80 //config:       depends on IP || IPLINK
  81 //config:       help
  82 //config:       Configure network devices with "ip".
  83 //config:
  84 //config:config FEATURE_IP_ROUTE
  85 //config:       bool "ip route"
  86 //config:       default y
  87 //config:       depends on IP || IPROUTE
  88 //config:       help
  89 //config:       Add support for routing table management to "ip".
  90 //config:
  91 //config:config FEATURE_IP_ROUTE_DIR
  92 //config:       string "ip route configuration directory"
  93 //config:       default "/etc/iproute2"
  94 //config:       depends on FEATURE_IP_ROUTE
  95 //config:       help
  96 //config:       Location of the "ip" applet routing configuration.
  97 //config:
  98 //config:config FEATURE_IP_TUNNEL
  99 //config:       bool "ip tunnel"
 100 //config:       default y
 101 //config:       depends on IP || IPTUNNEL
 102 //config:       help
 103 //config:       Add support for tunneling commands to "ip".
 104 //config:
 105 //config:config FEATURE_IP_RULE
 106 //config:       bool "ip rule"
 107 //config:       default y
 108 //config:       depends on IP || IPRULE
 109 //config:       help
 110 //config:       Add support for rule commands to "ip".
 111 //config:
 112 //config:config FEATURE_IP_NEIGH
 113 //config:       bool "ip neighbor"
 114 //config:       default y
 115 //config:       depends on IP || IPNEIGH
 116 //config:       help
 117 //config:       Add support for neighbor commands to "ip".
 118 //config:
 119 //config:config FEATURE_IP_RARE_PROTOCOLS
 120 //config:       bool "Support displaying rarely used link types"
 121 //config:       default n
 122 //config:       depends on IP || IPADDR || IPLINK || IPROUTE || IPTUNNEL || IPRULE || IPNEIGH
 123 //config:       help
 124 //config:       If you are not going to use links of type "frad", "econet",
 125 //config:       "bif" etc, you probably don't need to enable this.
 126 //config:       Ethernet, wireless, infrared, ppp/slip, ip tunnelling
 127 //config:       link types are supported without this option selected.
 128
 129 //applet:IF_IP(      APPLET_NOEXEC(ip      , ip      , BB_DIR_SBIN, BB_SUID_DROP, ip      ))
 130 //applet:IF_IPADDR(  APPLET_NOEXEC(ipaddr  , ipaddr  , BB_DIR_SBIN, BB_SUID_DROP, ipaddr  ))
 131 //applet:IF_IPLINK(  APPLET_NOEXEC(iplink  , iplink  , BB_DIR_SBIN, BB_SUID_DROP, iplink  ))
 132 //applet:IF_IPROUTE( APPLET_NOEXEC(iproute , iproute , BB_DIR_SBIN, BB_SUID_DROP, iproute ))
 133 //applet:IF_IPRULE(  APPLET_NOEXEC(iprule  , iprule  , BB_DIR_SBIN, BB_SUID_DROP, iprule  ))
 134 //applet:IF_IPTUNNEL(APPLET_NOEXEC(iptunnel, iptunnel, BB_DIR_SBIN, BB_SUID_DROP, iptunnel))
 135 //applet:IF_IPNEIGH( APPLET_NOEXEC(ipneigh , ipneigh , BB_DIR_SBIN, BB_SUID_DROP, ipneigh ))
 136
 137 //kbuild:lib-$(CONFIG_IP) += ip.o
 138 //kbuild:lib-$(CONFIG_IPADDR) += ip.o
 139 //kbuild:lib-$(CONFIG_IPLINK) += ip.o
 140 //kbuild:lib-$(CONFIG_IPROUTE) += ip.o
 141 //kbuild:lib-$(CONFIG_IPRULE) += ip.o
 142 //kbuild:lib-$(CONFIG_IPTUNNEL) += ip.o
 143 //kbuild:lib-$(CONFIG_IPNEIGH) += ip.o
 144
 145 //--------------123456789.123456789.123456789.123456789.123456789.123456789.123456789.123....79
 146 //usage:#define ipaddr_trivial_usage
 147 //usage:       "add|del IFADDR dev IFACE | show|flush [dev IFACE] [to PREFIX]"
 148 //usage:#define ipaddr_full_usage "\n\n"
 149 //usage:       "ipaddr add|change|replace|delete dev IFACE IFADDR\n"
 150 //usage:       "        IFADDR := PREFIX | ADDR peer PREFIX [broadcast ADDR|+|-]\n"
 151 //usage:       "                [anycast ADDR] [label STRING] [scope SCOPE]\n"
 152 //usage:       "        PREFIX := ADDR[/MASK]\n"
 153 //usage:       "        SCOPE := [host|link|global|NUMBER]\n"
 154 //usage:       "ipaddr show|flush [dev IFACE] [scope SCOPE] [to PREFIX] [label PATTERN]"
 155 //usage:
 156 //--------------123456789.123456789.123456789.123456789.123456789.123456789.123456789.123....79
 157 //usage:#define iplink_trivial_usage
 158 //usage:       "set IFACE [up|down] [arp on|off] | show [IFACE]"
 159 //usage:#define iplink_full_usage "\n\n"
 160 //usage:       "iplink set IFACE [up|down] [arp on|off] [multicast on|off] [promisc on|off]\n"
 161 //usage:       "        [mtu NUM] [name NAME] [qlen NUM] [address MAC]\n"
 162 //usage:       "iplink show [IFACE]"
 163 //usage:
 164 //--------------123456789.123456789.123456789.123456789.123456789.123456789.123456789.123....79
 165 //usage:#define iproute_trivial_usage
 166 //usage:       "list|flush|add|del|change|append|replace|test ROUTE"
 167 //usage:#define iproute_full_usage "\n\n"
 168 //usage:       "iproute list|flush SELECTOR\n"
 169 //usage:       "        SELECTOR := [root PREFIX] [match PREFIX] [proto RTPROTO]\n"
 170 //usage:       "        PREFIX := default|ADDR[/MASK]\n"
 171 //usage:       "iproute get ADDR [from ADDR iif IFACE]\n"
 172 //usage:       "        [oif IFACE] [tos TOS]\n"
 173 //usage:       "iproute add|del|change|append|replace|test ROUTE\n"
 174 //usage:       "        ROUTE := NODE_SPEC [INFO_SPEC]\n"
 175 //usage:       "        NODE_SPEC := PREFIX"IF_FEATURE_IP_RULE(" [table TABLE_ID]")" [proto RTPROTO] [scope SCOPE] [metric METRIC]\n"
 176 //usage:       "        INFO_SPEC := NH OPTIONS\n"
 177 //usage:       "        NH := [via [inet|inet6] ADDR] [dev IFACE] [src ADDR] [onlink]\n"
 178 //usage:       "        OPTIONS := [mtu [lock] NUM] [advmss [lock] NUM]"
 179 //upstream man ip-route:
 180 //======================
 181 //ip route { show | flush } SELECTOR
 182 //ip route save SELECTOR
 183 //ip route restore
 184 //ip route get ADDRESS [ from ADDRESS iif STRING  ] [ oif STRING ] [ tos TOS ]
 185 //ip route { add | del | change | append | replace } ROUTE
 186 //SELECTOR := [ root PREFIX ] [ match PREFIX ] [ exact PREFIX ] [ table TABLE_ID ] [ proto RTPROTO ] [ type TYPE ] [ scope SCOPE ]
 187 //ROUTE := NODE_SPEC [ INFO_SPEC ]
 188 //NODE_SPEC := [ TYPE ] PREFIX [ tos TOS ] [ table TABLE_ID ] [ proto RTPROTO ] [ scope SCOPE ] [ metric METRIC ]
 189 //INFO_SPEC := NH OPTIONS FLAGS [ nexthop NH ] ...
 190 //NH := [ encap ENCAP ] [ via [ FAMILY ] ADDRESS ] [ dev STRING ] [ weight NUMBER ] NHFLAGS
 191 // ..............................................................^ I guess [src ADDRESS] should be here
 192 //FAMILY := [ inet | inet6 | ipx | dnet | mpls | bridge | link ]
 193 //OPTIONS := FLAGS [ mtu NUMBER ] [ advmss NUMBER ] [ as [ to ] ADDRESS ] rtt TIME ] [ rttvar TIME ] [ reordering NUMBER ] [ window NUMBER ] [ cwnd NUMBER ] [ ssthresh REALM ] [ realms REALM ]
 194 //        [ rto_min TIME ] [ initcwnd NUMBER ] [ initrwnd NUMBER ] [ features FEATURES ] [ quickack BOOL ] [ congctl NAME ] [ pref PREF ] [ expires TIME ]
 195 //TYPE := [ unicast | local | broadcast | multicast | throw | unreachable | prohibit | blackhole | nat ]
 196 //TABLE_ID := [ local | main | default | all | NUMBER ]
 197 //SCOPE := [ host | link | global | NUMBER ]
 198 //NHFLAGS := [ onlink | pervasive ]
 199 //RTPROTO := [ kernel | boot | static | NUMBER ]
 200 //FEATURES := [ ecn | ]
 201 //PREF := [ low | medium | high ]
 202 //ENCAP := [ MPLS | IP ]
 203 //ENCAP_MPLS := mpls [ LABEL ]
 204 //ENCAP_IP := ip id TUNNEL_ID dst REMOTE_IP [ tos TOS ] [ ttl TTL ]
 205 //usage:
 206 //--------------123456789.123456789.123456789.123456789.123456789.123456789.123456789.123....79
 207 //usage:#define iprule_trivial_usage
 208 //usage:       "[list] | add|del SELECTOR ACTION"
 209 //usage:#define iprule_full_usage "\n\n"
 210 //usage:       "        SELECTOR := [from PREFIX] [to PREFIX] [tos TOS] [fwmark FWMARK]\n"
 211 //usage:       "                        [dev IFACE] [pref NUMBER]\n"
 212 //usage:       "        ACTION := [table TABLE_ID] [nat ADDR]\n"
 213 //usage:       "                        [prohibit|reject|unreachable]\n"
 214 //usage:       "                        [realms [SRCREALM/]DSTREALM]\n"
 215 //usage:       "        TABLE_ID := [local|main|default|NUMBER]"
 216 //usage:
 217 //--------------123456789.123456789.123456789.123456789.123456789.123456789.123456789.123....79
 218 //usage:#define iptunnel_trivial_usage
 219 //usage:       "add|change|del|show [NAME]\n"
 220 //usage:       "        [mode ipip|gre|sit]\n"
 221 //usage:       "        [remote ADDR] [local ADDR] [ttl TTL]"
 222 //usage:#define iptunnel_full_usage "\n\n"
 223 //usage:       "iptunnel add|change|del|show [NAME]\n"
 224 //usage:       "        [mode ipip|gre|sit] [remote ADDR] [local ADDR]\n"
 225 //usage:       "        [[i|o]seq] [[i|o]key KEY] [[i|o]csum]\n"
 226 //usage:       "        [ttl TTL] [tos TOS] [[no]pmtudisc] [dev PHYS_DEV]"
 227 //usage:
 228 //usage:#define ipneigh_trivial_usage
 229 //usage:       "show|flush [to PREFIX] [dev DEV] [nud STATE]"
 230 //usage:#define ipneigh_full_usage ""
 231 //usage:
 232 //usage:#if ENABLE_FEATURE_IP_ADDRESS || ENABLE_FEATURE_IP_ROUTE
 233 //usage:# define IP_BAR_LINK   "|"
 234 //usage:#else
 235 //usage:# define IP_BAR_LINK   ""
 236 //usage:#endif
 237 //usage:#if ENABLE_FEATURE_IP_ADDRESS || ENABLE_FEATURE_IP_ROUTE || ENABLE_FEATURE_IP_LINK
 238 //usage:# define IP_BAR_TUNNEL "|"
 239 //usage:#else
 240 //usage:# define IP_BAR_TUNNEL ""
 241 //usage:#endif
 242 //usage:#if ENABLE_FEATURE_IP_ADDRESS || ENABLE_FEATURE_IP_ROUTE || ENABLE_FEATURE_IP_LINK || ENABLE_FEATURE_IP_TUNNEL
 243 //usage:# define IP_BAR_NEIGH  "|"
 244 //usage:#else
 245 //usage:# define IP_BAR_NEIGH  ""
 246 //usage:#endif
 247 //usage:#if ENABLE_FEATURE_IP_ADDRESS || ENABLE_FEATURE_IP_ROUTE || ENABLE_FEATURE_IP_LINK || ENABLE_FEATURE_IP_TUNNEL || ENABLE_FEATURE_IP_NEIGH
 248 //usage:# define IP_BAR_RULE   "|"
 249 //usage:#else
 250 //usage:# define IP_BAR_RULE   ""
 251 //usage:#endif
 252 //usage:
 253 //usage:#define ip_trivial_usage
 254 //usage:       "[OPTIONS] "
 255 //usage:        IF_FEATURE_IP_ADDRESS("address")
 256 //usage:        IF_FEATURE_IP_ROUTE(  IF_FEATURE_IP_ADDRESS("|")"route")
 257 //usage:        IF_FEATURE_IP_LINK(   IP_BAR_LINK  "link")
 258 //usage:        IF_FEATURE_IP_TUNNEL( IP_BAR_TUNNEL"tunnel")
 259 //usage:        IF_FEATURE_IP_NEIGH(  IP_BAR_NEIGH "neigh")
 260 //usage:        IF_FEATURE_IP_RULE(   IP_BAR_RULE  "rule")
 261 //usage:       " [COMMAND]"
 262 //usage:#define ip_full_usage "\n\n"
 263 //usage:       "OPTIONS := -f[amily] inet|inet6|link | -o[neline]\n"
 264 //usage:       "COMMAND :="
 265 //usage:        IF_FEATURE_IP_ADDRESS("\n"
 266 //usage:        "ip addr "ipaddr_trivial_usage)
 267 //usage:        IF_FEATURE_IP_ROUTE("\n"
 268 //usage:        "ip route "iproute_trivial_usage)
 269 //usage:        IF_FEATURE_IP_LINK("\n"
 270 //usage:        "ip link "iplink_trivial_usage)
 271 //usage:        IF_FEATURE_IP_TUNNEL("\n"
 272 //usage:        "ip tunnel "iptunnel_trivial_usage)
 273 //usage:        IF_FEATURE_IP_NEIGH("\n"
 274 //usage:        "ip neigh "ipneigh_trivial_usage)
 275 //usage:        IF_FEATURE_IP_RULE("\n"
 276 //usage:        "ip rule "iprule_trivial_usage)
 277
 278 #include "libbb.h"
 279
 280 #include "libiproute/utils.h"
 281 #include "libiproute/ip_common.h"
 282
 283 typedef int FAST_FUNC (*ip_func_ptr_t)(char**);
 284
 285 #if ENABLE_IPADDR \
 286  || ENABLE_IPLINK \
 287  || ENABLE_IPROUTE \
 288  || ENABLE_IPRULE \
 289  || ENABLE_IPTUNNEL \
 290  || ENABLE_IPNEIGH
 291 static int ip_do(ip_func_ptr_t ip_func, char **argv)
 292 {
 293         argv = ip_parse_common_args(argv + 1);
 294         return ip_func(argv);
 295 }
 296 #endif
 297
 298 #if ENABLE_IPADDR
 299 int ipaddr_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 300 int ipaddr_main(int argc UNUSED_PARAM, char **argv)
 301 {
 302         return ip_do(do_ipaddr, argv);
 303 }
 304 #endif
 305 #if ENABLE_IPLINK
 306 int iplink_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 307 int iplink_main(int argc UNUSED_PARAM, char **argv)
 308 {
 309         return ip_do(do_iplink, argv);
 310 }
 311 #endif
 312 #if ENABLE_IPROUTE
 313 int iproute_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 314 int iproute_main(int argc UNUSED_PARAM, char **argv)
 315 {
 316         return ip_do(do_iproute, argv);
 317 }
 318 #endif
 319 #if ENABLE_IPRULE
 320 int iprule_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 321 int iprule_main(int argc UNUSED_PARAM, char **argv)
 322 {
 323         return ip_do(do_iprule, argv);
 324 }
 325 #endif
 326 #if ENABLE_IPTUNNEL
 327 int iptunnel_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 328 int iptunnel_main(int argc UNUSED_PARAM, char **argv)
 329 {
 330         return ip_do(do_iptunnel, argv);
 331 }
 332 #endif
 333 #if ENABLE_IPNEIGH
 334 int ipneigh_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 335 int ipneigh_main(int argc UNUSED_PARAM, char **argv)
 336 {
 337         return ip_do(do_ipneigh, argv);
 338 }
 339 #endif
 340
 341 #if ENABLE_IP
 342 static int FAST_FUNC ip_print_help(char **argv UNUSED_PARAM)
 343 {
 344         bb_show_usage();
 345 }
 346
 347 int ip_main(int argc, char **argv) MAIN_EXTERNALLY_VISIBLE;
 348 int ip_main(int argc UNUSED_PARAM, char **argv)
 349 {
 350         static const char keywords[] ALIGN1 = ""
 351                 IF_FEATURE_IP_ADDRESS("address\0")
 352                 IF_FEATURE_IP_ROUTE("route\0")
 353                 IF_FEATURE_IP_ROUTE("r\0")
 354                 IF_FEATURE_IP_LINK("link\0")
 355                 IF_FEATURE_IP_TUNNEL("tunnel\0")
 356                 IF_FEATURE_IP_TUNNEL("tunl\0")
 357                 IF_FEATURE_IP_RULE("rule\0")
 358                 IF_FEATURE_IP_NEIGH("neigh\0")
 359                 ;
 360         static const ip_func_ptr_t ip_func_ptrs[] = {
 361                 ip_print_help,
 362                 IF_FEATURE_IP_ADDRESS(do_ipaddr,)
 363                 IF_FEATURE_IP_ROUTE(do_iproute,)
 364                 IF_FEATURE_IP_ROUTE(do_iproute,)
 365                 IF_FEATURE_IP_LINK(do_iplink,)
 366                 IF_FEATURE_IP_TUNNEL(do_iptunnel,)
 367                 IF_FEATURE_IP_TUNNEL(do_iptunnel,)
 368                 IF_FEATURE_IP_RULE(do_iprule,)
 369                 IF_FEATURE_IP_NEIGH(do_ipneigh,)
 370         };
 371         ip_func_ptr_t ip_func;
 372         int key;
 373
 374         argv = ip_parse_common_args(argv + 1);
 375         if (ARRAY_SIZE(ip_func_ptrs) > 1 && *argv)
 376                 key = index_in_substrings(keywords, *argv++);
 377         else
 378                 key = -1;
 379         ip_func = ip_func_ptrs[key + 1];
 380
 381         return ip_func(argv);
 382 }
 383 #endif