4 * This program is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU General Public License
6 * as published by the Free Software Foundation; either version
7 * 2 of the License, or (at your option) any later version.
9 * Authors: Alexey Kuznetsov, <kuznet@ms2.inr.ac.ru>
20 #include <sys/socket.h>
22 #include <linux/if_packet.h>
23 #include <linux/if_ether.h>
24 #include <linux/sockios.h>
25 #include <netinet/in.h>
26 #include <arpa/inet.h>
28 #include <sys/ioctl.h>
29 #include <linux/sockios.h>
33 #include "ip_common.h"
35 #define IPLINK_IOCTL_COMPAT 1
37 #define LIBDIR "/usr/lib/"
40 static void usage(void) __attribute__((noreturn));
41 static int iplink_have_newlink(void);
43 void iplink_usage(void)
45 if (iplink_have_newlink()) {
46 fprintf(stderr, "Usage: ip link add [link DEV] [ name ] NAME\n");
47 fprintf(stderr, " [ txqueuelen PACKETS ]\n");
48 fprintf(stderr, " [ address LLADDR ]\n");
49 fprintf(stderr, " [ broadcast LLADDR ]\n");
50 fprintf(stderr, " [ mtu MTU ]\n");
51 fprintf(stderr, " type TYPE [ ARGS ]\n");
52 fprintf(stderr, " ip link delete DEV type TYPE [ ARGS ]\n");
53 fprintf(stderr, "\n");
54 fprintf(stderr, " ip link set { dev DEVICE | group DEVGROUP } [ { up | down } ]\n");
56 fprintf(stderr, "Usage: ip link set DEVICE [ { up | down } ]\n");
58 fprintf(stderr, " [ arp { on | off } ]\n");
59 fprintf(stderr, " [ dynamic { on | off } ]\n");
60 fprintf(stderr, " [ multicast { on | off } ]\n");
61 fprintf(stderr, " [ allmulticast { on | off } ]\n");
62 fprintf(stderr, " [ promisc { on | off } ]\n");
63 fprintf(stderr, " [ trailers { on | off } ]\n");
64 fprintf(stderr, " [ txqueuelen PACKETS ]\n");
65 fprintf(stderr, " [ name NEWNAME ]\n");
66 fprintf(stderr, " [ address LLADDR ]\n");
67 fprintf(stderr, " [ broadcast LLADDR ]\n");
68 fprintf(stderr, " [ mtu MTU ]\n");
69 fprintf(stderr, " [ netns PID ]\n");
70 fprintf(stderr, " [ netns NAME ]\n");
71 fprintf(stderr, " [ alias NAME ]\n");
72 fprintf(stderr, " [ vf NUM [ mac LLADDR ]\n");
73 fprintf(stderr, " [ vlan VLANID [ qos VLAN-QOS ] ]\n");
74 fprintf(stderr, " [ rate TXRATE ] ] \n");
75 fprintf(stderr, " [ master DEVICE ]\n");
76 fprintf(stderr, " [ nomaster ]\n");
77 fprintf(stderr, " ip link show [ DEVICE | group GROUP ]\n");
79 if (iplink_have_newlink()) {
80 fprintf(stderr, "\n");
81 fprintf(stderr, "TYPE := { vlan | veth | vcan | dummy | ifb | macvlan | can | bridge }\n");
86 static void usage(void)
91 static int on_off(char *msg)
93 fprintf(stderr, "Error: argument of \"%s\" must be \"on\" or \"off\"\n", msg);
97 static void *BODY; /* cached dlopen(NULL) handle */
98 static struct link_util *linkutil_list;
100 struct link_util *get_link_kind(const char *id)
106 for (l = linkutil_list; l; l = l->next)
107 if (strcmp(l->id, id) == 0)
110 snprintf(buf, sizeof(buf), LIBDIR "/ip/link_%s.so", id);
111 dlh = dlopen(buf, RTLD_LAZY);
113 /* look in current binary, only open once */
116 dlh = BODY = dlopen(NULL, RTLD_LAZY);
122 snprintf(buf, sizeof(buf), "%s_link_util", id);
127 l->next = linkutil_list;
132 #if IPLINK_IOCTL_COMPAT
133 static int have_rtnl_newlink = -1;
135 static int accept_msg(const struct sockaddr_nl *who,
136 struct nlmsghdr *n, void *arg)
138 struct nlmsgerr *err = (struct nlmsgerr *)NLMSG_DATA(n);
140 if (n->nlmsg_type == NLMSG_ERROR &&
141 (err->error == -EOPNOTSUPP || err->error == -EINVAL))
142 have_rtnl_newlink = 0;
144 have_rtnl_newlink = 1;
148 static int iplink_have_newlink(void)
156 if (have_rtnl_newlink < 0) {
157 memset(&req, 0, sizeof(req));
159 req.n.nlmsg_len = NLMSG_LENGTH(sizeof(struct ifinfomsg));
160 req.n.nlmsg_flags = NLM_F_REQUEST|NLM_F_ACK;
161 req.n.nlmsg_type = RTM_NEWLINK;
162 req.i.ifi_family = AF_UNSPEC;
164 rtnl_send(&rth, (char *)&req.n, req.n.nlmsg_len);
165 rtnl_listen(&rth, accept_msg, NULL);
167 return have_rtnl_newlink;
169 #else /* IPLINK_IOCTL_COMPAT */
170 static int iplink_have_newlink(void)
174 #endif /* ! IPLINK_IOCTL_COMPAT */
182 int iplink_parse_vf(int vf, int *argcp, char ***argvp,
183 struct iplink_req *req)
185 int len, argc = *argcp;
186 char **argv = *argvp;
187 struct rtattr *vfinfo;
189 vfinfo = addattr_nest(&req->n, sizeof(*req), IFLA_VF_INFO);
191 while (NEXT_ARG_OK()) {
193 if (matches(*argv, "mac") == 0) {
194 struct ifla_vf_mac ivm;
197 len = ll_addr_a2n((char *)ivm.mac, 32, *argv);
200 addattr_l(&req->n, sizeof(*req), IFLA_VF_MAC, &ivm, sizeof(ivm));
201 } else if (matches(*argv, "vlan") == 0) {
202 struct ifla_vf_vlan ivv;
204 if (get_unsigned(&ivv.vlan, *argv, 0)) {
205 invarg("Invalid \"vlan\" value\n", *argv);
211 if (matches(*argv, "qos") == 0) {
213 if (get_unsigned(&ivv.qos, *argv, 0)) {
214 invarg("Invalid \"qos\" value\n", *argv);
221 addattr_l(&req->n, sizeof(*req), IFLA_VF_VLAN, &ivv, sizeof(ivv));
222 } else if (matches(*argv, "rate") == 0) {
223 struct ifla_vf_tx_rate ivt;
225 if (get_unsigned(&ivt.rate, *argv, 0)) {
226 invarg("Invalid \"rate\" value\n", *argv);
229 addattr_l(&req->n, sizeof(*req), IFLA_VF_TX_RATE, &ivt, sizeof(ivt));
239 incomplete_command();
241 addattr_nest_end(&req->n, vfinfo);
249 int iplink_parse(int argc, char **argv, struct iplink_req *req,
250 char **name, char **type, char **link, char **dev, int *group)
263 if (strcmp(*argv, "up") == 0) {
264 req->i.ifi_change |= IFF_UP;
265 req->i.ifi_flags |= IFF_UP;
266 } else if (strcmp(*argv, "down") == 0) {
267 req->i.ifi_change |= IFF_UP;
268 req->i.ifi_flags &= ~IFF_UP;
269 } else if (strcmp(*argv, "name") == 0) {
272 } else if (matches(*argv, "link") == 0) {
275 } else if (matches(*argv, "address") == 0) {
277 len = ll_addr_a2n(abuf, sizeof(abuf), *argv);
280 addattr_l(&req->n, sizeof(*req), IFLA_ADDRESS, abuf, len);
281 } else if (matches(*argv, "broadcast") == 0 ||
282 strcmp(*argv, "brd") == 0) {
284 len = ll_addr_a2n(abuf, sizeof(abuf), *argv);
287 addattr_l(&req->n, sizeof(*req), IFLA_BROADCAST, abuf, len);
288 } else if (matches(*argv, "txqueuelen") == 0 ||
289 strcmp(*argv, "qlen") == 0 ||
290 matches(*argv, "txqlen") == 0) {
293 duparg("txqueuelen", *argv);
294 if (get_integer(&qlen, *argv, 0))
295 invarg("Invalid \"txqueuelen\" value\n", *argv);
296 addattr_l(&req->n, sizeof(*req), IFLA_TXQLEN, &qlen, 4);
297 } else if (strcmp(*argv, "mtu") == 0) {
300 duparg("mtu", *argv);
301 if (get_integer(&mtu, *argv, 0))
302 invarg("Invalid \"mtu\" value\n", *argv);
303 addattr_l(&req->n, sizeof(*req), IFLA_MTU, &mtu, 4);
304 } else if (strcmp(*argv, "netns") == 0) {
307 duparg("netns", *argv);
308 if ((netns = get_netns_fd(*argv)) >= 0)
309 addattr_l(&req->n, sizeof(*req), IFLA_NET_NS_FD, &netns, 4);
310 else if (get_integer(&netns, *argv, 0) == 0)
311 addattr_l(&req->n, sizeof(*req), IFLA_NET_NS_PID, &netns, 4);
313 invarg("Invalid \"netns\" value\n", *argv);
314 } else if (strcmp(*argv, "multicast") == 0) {
316 req->i.ifi_change |= IFF_MULTICAST;
317 if (strcmp(*argv, "on") == 0) {
318 req->i.ifi_flags |= IFF_MULTICAST;
319 } else if (strcmp(*argv, "off") == 0) {
320 req->i.ifi_flags &= ~IFF_MULTICAST;
322 return on_off("multicast");
323 } else if (strcmp(*argv, "allmulticast") == 0) {
325 req->i.ifi_change |= IFF_ALLMULTI;
326 if (strcmp(*argv, "on") == 0) {
327 req->i.ifi_flags |= IFF_ALLMULTI;
328 } else if (strcmp(*argv, "off") == 0) {
329 req->i.ifi_flags &= ~IFF_ALLMULTI;
331 return on_off("allmulticast");
332 } else if (strcmp(*argv, "promisc") == 0) {
334 req->i.ifi_change |= IFF_PROMISC;
335 if (strcmp(*argv, "on") == 0) {
336 req->i.ifi_flags |= IFF_PROMISC;
337 } else if (strcmp(*argv, "off") == 0) {
338 req->i.ifi_flags &= ~IFF_PROMISC;
340 return on_off("promisc");
341 } else if (strcmp(*argv, "trailers") == 0) {
343 req->i.ifi_change |= IFF_NOTRAILERS;
344 if (strcmp(*argv, "off") == 0) {
345 req->i.ifi_flags |= IFF_NOTRAILERS;
346 } else if (strcmp(*argv, "on") == 0) {
347 req->i.ifi_flags &= ~IFF_NOTRAILERS;
349 return on_off("trailers");
350 } else if (strcmp(*argv, "arp") == 0) {
352 req->i.ifi_change |= IFF_NOARP;
353 if (strcmp(*argv, "on") == 0) {
354 req->i.ifi_flags &= ~IFF_NOARP;
355 } else if (strcmp(*argv, "off") == 0) {
356 req->i.ifi_flags |= IFF_NOARP;
358 return on_off("noarp");
359 } else if (strcmp(*argv, "vf") == 0) {
360 struct rtattr *vflist;
362 if (get_integer(&vf, *argv, 0)) {
363 invarg("Invalid \"vf\" value\n", *argv);
365 vflist = addattr_nest(&req->n, sizeof(*req),
367 len = iplink_parse_vf(vf, &argc, &argv, req);
370 addattr_nest_end(&req->n, vflist);
371 } else if (matches(*argv, "master") == 0) {
374 ifindex = ll_name_to_index(*argv);
376 invarg("Device does not exist\n", *argv);
377 addattr_l(&req->n, sizeof(*req), IFLA_MASTER,
379 } else if (matches(*argv, "nomaster") == 0) {
381 addattr_l(&req->n, sizeof(*req), IFLA_MASTER,
383 } else if (matches(*argv, "dynamic") == 0) {
385 req->i.ifi_change |= IFF_DYNAMIC;
386 if (strcmp(*argv, "on") == 0) {
387 req->i.ifi_flags |= IFF_DYNAMIC;
388 } else if (strcmp(*argv, "off") == 0) {
389 req->i.ifi_flags &= ~IFF_DYNAMIC;
391 return on_off("dynamic");
392 } else if (matches(*argv, "type") == 0) {
397 } else if (matches(*argv, "alias") == 0) {
399 addattr_l(&req->n, sizeof(*req), IFLA_IFALIAS,
400 *argv, strlen(*argv));
403 } else if (strcmp(*argv, "group") == 0) {
406 duparg("group", *argv);
407 if (rtnl_group_a2n(group, *argv))
408 invarg("Invalid \"group\" value\n", *argv);
410 if (strcmp(*argv, "dev") == 0) {
413 if (matches(*argv, "help") == 0)
416 duparg2("dev", *argv);
425 static int iplink_modify(int cmd, unsigned int flags, int argc, char **argv)
433 struct link_util *lu = NULL;
434 struct iplink_req req;
437 memset(&req, 0, sizeof(req));
439 req.n.nlmsg_len = NLMSG_LENGTH(sizeof(struct ifinfomsg));
440 req.n.nlmsg_flags = NLM_F_REQUEST|flags;
441 req.n.nlmsg_type = cmd;
442 req.i.ifi_family = preferred_family;
444 ret = iplink_parse(argc, argv, &req, &name, &type, &link, &dev, &group);
453 addattr_l(&req.n, sizeof(req), IFLA_GROUP,
454 &group, sizeof(group));
457 fprintf(stderr, "Garbage instead of arguments "
458 "\"%s ...\". Try \"ip link "
462 if (flags & NLM_F_CREATE) {
463 fprintf(stderr, "group cannot be used when "
464 "creating devices.\n");
469 addattr32(&req.n, sizeof(req), IFLA_GROUP, group);
470 if (rtnl_talk(&rth, &req.n, 0, 0, NULL, NULL, NULL) < 0)
479 struct rtattr *linkinfo = NLMSG_TAIL(&req.n);
480 addattr_l(&req.n, sizeof(req), IFLA_LINKINFO, NULL, 0);
481 addattr_l(&req.n, sizeof(req), IFLA_INFO_KIND, type,
484 lu = get_link_kind(type);
486 struct rtattr * data = NLMSG_TAIL(&req.n);
487 addattr_l(&req.n, sizeof(req), IFLA_INFO_DATA, NULL, 0);
490 lu->parse_opt(lu, argc, argv, &req.n))
493 data->rta_len = (void *)NLMSG_TAIL(&req.n) - (void *)data;
495 if (matches(*argv, "help") == 0)
497 fprintf(stderr, "Garbage instead of arguments \"%s ...\". "
498 "Try \"ip link help\".\n", *argv);
501 linkinfo->rta_len = (void *)NLMSG_TAIL(&req.n) - (void *)linkinfo;
502 } else if (flags & NLM_F_CREATE) {
503 fprintf(stderr, "Not enough information: \"type\" argument "
508 if (!(flags & NLM_F_CREATE)) {
510 fprintf(stderr, "Not enough information: \"dev\" "
511 "argument is required.\n");
515 req.i.ifi_index = ll_name_to_index(dev);
516 if (req.i.ifi_index == 0) {
517 fprintf(stderr, "Cannot find device \"%s\"\n", dev);
521 /* Allow "ip link add dev" and "ip link add name" */
528 ifindex = ll_name_to_index(link);
530 fprintf(stderr, "Cannot find device \"%s\"\n",
534 addattr_l(&req.n, sizeof(req), IFLA_LINK, &ifindex, 4);
539 len = strlen(name) + 1;
541 invarg("\"\" is not a valid device identifier\n", "name");
543 invarg("\"name\" too long\n", name);
544 addattr_l(&req.n, sizeof(req), IFLA_IFNAME, name, len);
547 if (rtnl_talk(&rth, &req.n, 0, 0, NULL, NULL, NULL) < 0)
553 #if IPLINK_IOCTL_COMPAT
554 static int get_ctl_fd(void)
559 fd = socket(PF_INET, SOCK_DGRAM, 0);
563 fd = socket(PF_PACKET, SOCK_DGRAM, 0);
566 fd = socket(PF_INET6, SOCK_DGRAM, 0);
570 perror("Cannot create control socket");
574 static int do_chflags(const char *dev, __u32 flags, __u32 mask)
580 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
584 err = ioctl(fd, SIOCGIFFLAGS, &ifr);
586 perror("SIOCGIFFLAGS");
590 if ((ifr.ifr_flags^flags)&mask) {
591 ifr.ifr_flags &= ~mask;
592 ifr.ifr_flags |= mask&flags;
593 err = ioctl(fd, SIOCSIFFLAGS, &ifr);
595 perror("SIOCSIFFLAGS");
601 static int do_changename(const char *dev, const char *newdev)
607 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
608 strncpy(ifr.ifr_newname, newdev, IFNAMSIZ);
612 err = ioctl(fd, SIOCSIFNAME, &ifr);
614 perror("SIOCSIFNAME");
622 static int set_qlen(const char *dev, int qlen)
631 memset(&ifr, 0, sizeof(ifr));
632 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
634 if (ioctl(s, SIOCSIFTXQLEN, &ifr) < 0) {
635 perror("SIOCSIFXQLEN");
644 static int set_mtu(const char *dev, int mtu)
653 memset(&ifr, 0, sizeof(ifr));
654 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
656 if (ioctl(s, SIOCSIFMTU, &ifr) < 0) {
657 perror("SIOCSIFMTU");
666 static int get_address(const char *dev, int *htype)
669 struct sockaddr_ll me;
673 s = socket(PF_PACKET, SOCK_DGRAM, 0);
675 perror("socket(PF_PACKET)");
679 memset(&ifr, 0, sizeof(ifr));
680 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
681 if (ioctl(s, SIOCGIFINDEX, &ifr) < 0) {
682 perror("SIOCGIFINDEX");
687 memset(&me, 0, sizeof(me));
688 me.sll_family = AF_PACKET;
689 me.sll_ifindex = ifr.ifr_ifindex;
690 me.sll_protocol = htons(ETH_P_LOOP);
691 if (bind(s, (struct sockaddr*)&me, sizeof(me)) == -1) {
698 if (getsockname(s, (struct sockaddr*)&me, &alen) == -1) {
699 perror("getsockname");
704 *htype = me.sll_hatype;
708 static int parse_address(const char *dev, int hatype, int halen,
709 char *lla, struct ifreq *ifr)
713 memset(ifr, 0, sizeof(*ifr));
714 strncpy(ifr->ifr_name, dev, IFNAMSIZ);
715 ifr->ifr_hwaddr.sa_family = hatype;
716 alen = ll_addr_a2n(ifr->ifr_hwaddr.sa_data, 14, lla);
720 fprintf(stderr, "Wrong address (%s) length: expected %d bytes\n", lla, halen);
726 static int set_address(struct ifreq *ifr, int brd)
733 if (ioctl(s, brd?SIOCSIFHWBROADCAST:SIOCSIFHWADDR, ifr) < 0) {
734 perror(brd?"SIOCSIFHWBROADCAST":"SIOCSIFHWADDR");
743 static int do_set(int argc, char **argv)
750 char *newaddr = NULL;
752 struct ifreq ifr0, ifr1;
753 char *newname = NULL;
757 if (strcmp(*argv, "up") == 0) {
760 } else if (strcmp(*argv, "down") == 0) {
763 } else if (strcmp(*argv, "name") == 0) {
766 } else if (matches(*argv, "address") == 0) {
769 } else if (matches(*argv, "broadcast") == 0 ||
770 strcmp(*argv, "brd") == 0) {
773 } else if (matches(*argv, "txqueuelen") == 0 ||
774 strcmp(*argv, "qlen") == 0 ||
775 matches(*argv, "txqlen") == 0) {
778 duparg("txqueuelen", *argv);
779 if (get_integer(&qlen, *argv, 0))
780 invarg("Invalid \"txqueuelen\" value\n", *argv);
781 } else if (strcmp(*argv, "mtu") == 0) {
784 duparg("mtu", *argv);
785 if (get_integer(&mtu, *argv, 0))
786 invarg("Invalid \"mtu\" value\n", *argv);
787 } else if (strcmp(*argv, "multicast") == 0) {
789 mask |= IFF_MULTICAST;
790 if (strcmp(*argv, "on") == 0) {
791 flags |= IFF_MULTICAST;
792 } else if (strcmp(*argv, "off") == 0) {
793 flags &= ~IFF_MULTICAST;
795 return on_off("multicast");
796 } else if (strcmp(*argv, "allmulticast") == 0) {
798 mask |= IFF_ALLMULTI;
799 if (strcmp(*argv, "on") == 0) {
800 flags |= IFF_ALLMULTI;
801 } else if (strcmp(*argv, "off") == 0) {
802 flags &= ~IFF_ALLMULTI;
804 return on_off("allmulticast");
805 } else if (strcmp(*argv, "promisc") == 0) {
808 if (strcmp(*argv, "on") == 0) {
809 flags |= IFF_PROMISC;
810 } else if (strcmp(*argv, "off") == 0) {
811 flags &= ~IFF_PROMISC;
813 return on_off("promisc");
814 } else if (strcmp(*argv, "trailers") == 0) {
816 mask |= IFF_NOTRAILERS;
817 if (strcmp(*argv, "off") == 0) {
818 flags |= IFF_NOTRAILERS;
819 } else if (strcmp(*argv, "on") == 0) {
820 flags &= ~IFF_NOTRAILERS;
822 return on_off("trailers");
823 } else if (strcmp(*argv, "arp") == 0) {
826 if (strcmp(*argv, "on") == 0) {
828 } else if (strcmp(*argv, "off") == 0) {
831 return on_off("noarp");
832 } else if (matches(*argv, "dynamic") == 0) {
835 if (strcmp(*argv, "on") == 0) {
836 flags |= IFF_DYNAMIC;
837 } else if (strcmp(*argv, "off") == 0) {
838 flags &= ~IFF_DYNAMIC;
840 return on_off("dynamic");
842 if (strcmp(*argv, "dev") == 0) {
845 if (matches(*argv, "help") == 0)
848 duparg2("dev", *argv);
855 fprintf(stderr, "Not enough of information: \"dev\" argument is required.\n");
859 if (newaddr || newbrd) {
860 halen = get_address(dev, &htype);
864 if (parse_address(dev, htype, halen, newaddr, &ifr0) < 0)
868 if (parse_address(dev, htype, halen, newbrd, &ifr1) < 0)
873 if (newname && strcmp(dev, newname)) {
874 if (strlen(newname) == 0)
875 invarg("\"\" is not a valid device identifier\n", "name");
876 if (do_changename(dev, newname) < 0)
881 if (set_qlen(dev, qlen) < 0)
885 if (set_mtu(dev, mtu) < 0)
888 if (newaddr || newbrd) {
890 if (set_address(&ifr1, 1) < 0)
894 if (set_address(&ifr0, 0) < 0)
899 return do_chflags(dev, flags, mask);
902 #endif /* IPLINK_IOCTL_COMPAT */
904 int do_iplink(int argc, char **argv)
907 if (iplink_have_newlink()) {
908 if (matches(*argv, "add") == 0)
909 return iplink_modify(RTM_NEWLINK,
910 NLM_F_CREATE|NLM_F_EXCL,
912 if (matches(*argv, "set") == 0 ||
913 matches(*argv, "change") == 0)
914 return iplink_modify(RTM_NEWLINK, 0,
916 if (matches(*argv, "replace") == 0)
917 return iplink_modify(RTM_NEWLINK,
918 NLM_F_CREATE|NLM_F_REPLACE,
920 if (matches(*argv, "delete") == 0)
921 return iplink_modify(RTM_DELLINK, 0,
924 #if IPLINK_IOCTL_COMPAT
925 if (matches(*argv, "set") == 0)
926 return do_set(argc-1, argv+1);
929 if (matches(*argv, "show") == 0 ||
930 matches(*argv, "lst") == 0 ||
931 matches(*argv, "list") == 0)
932 return ipaddr_list_link(argc-1, argv+1);
933 if (matches(*argv, "help") == 0)
936 return ipaddr_list_link(0, NULL);
938 fprintf(stderr, "Command \"%s\" is unknown, try \"ip link help\".\n", *argv);