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, " [ alias NAME ]\n");
71 fprintf(stderr, " [ vf NUM [ mac LLADDR ]\n");
72 fprintf(stderr, " [ vlan VLANID [ qos VLAN-QOS ] ]\n");
73 fprintf(stderr, " [ rate TXRATE ] ] \n");
74 fprintf(stderr, " [ master DEVICE ]\n");
75 fprintf(stderr, " [ nomaster ]\n");
76 fprintf(stderr, " ip link show [ DEVICE | group GROUP ]\n");
78 if (iplink_have_newlink()) {
79 fprintf(stderr, "\n");
80 fprintf(stderr, "TYPE := { vlan | veth | vcan | dummy | ifb | macvlan | can }\n");
85 static void usage(void)
90 static int on_off(char *msg)
92 fprintf(stderr, "Error: argument of \"%s\" must be \"on\" or \"off\"\n", msg);
96 static void *BODY; /* cached dlopen(NULL) handle */
97 static struct link_util *linkutil_list;
99 struct link_util *get_link_kind(const char *id)
105 for (l = linkutil_list; l; l = l->next)
106 if (strcmp(l->id, id) == 0)
109 snprintf(buf, sizeof(buf), LIBDIR "/ip/link_%s.so", id);
110 dlh = dlopen(buf, RTLD_LAZY);
112 /* look in current binary, only open once */
115 dlh = BODY = dlopen(NULL, RTLD_LAZY);
121 snprintf(buf, sizeof(buf), "%s_link_util", id);
126 l->next = linkutil_list;
131 #if IPLINK_IOCTL_COMPAT
132 static int have_rtnl_newlink = -1;
134 static int accept_msg(const struct sockaddr_nl *who,
135 struct nlmsghdr *n, void *arg)
137 struct nlmsgerr *err = (struct nlmsgerr *)NLMSG_DATA(n);
139 if (n->nlmsg_type == NLMSG_ERROR &&
140 (err->error == -EOPNOTSUPP || err->error == -EINVAL))
141 have_rtnl_newlink = 0;
143 have_rtnl_newlink = 1;
147 static int iplink_have_newlink(void)
155 if (have_rtnl_newlink < 0) {
156 memset(&req, 0, sizeof(req));
158 req.n.nlmsg_len = NLMSG_LENGTH(sizeof(struct ifinfomsg));
159 req.n.nlmsg_flags = NLM_F_REQUEST|NLM_F_ACK;
160 req.n.nlmsg_type = RTM_NEWLINK;
161 req.i.ifi_family = AF_UNSPEC;
163 rtnl_send(&rth, (char *)&req.n, req.n.nlmsg_len);
164 rtnl_listen(&rth, accept_msg, NULL);
166 return have_rtnl_newlink;
168 #else /* IPLINK_IOCTL_COMPAT */
169 static int iplink_have_newlink(void)
173 #endif /* ! IPLINK_IOCTL_COMPAT */
181 int iplink_parse_vf(int vf, int *argcp, char ***argvp,
182 struct iplink_req *req)
184 int len, argc = *argcp;
185 char **argv = *argvp;
186 struct rtattr *vfinfo;
188 vfinfo = addattr_nest(&req->n, sizeof(*req), IFLA_VF_INFO);
190 while (NEXT_ARG_OK()) {
192 if (matches(*argv, "mac") == 0) {
193 struct ifla_vf_mac ivm;
196 len = ll_addr_a2n((char *)ivm.mac, 32, *argv);
199 addattr_l(&req->n, sizeof(*req), IFLA_VF_MAC, &ivm, sizeof(ivm));
200 } else if (matches(*argv, "vlan") == 0) {
201 struct ifla_vf_vlan ivv;
203 if (get_unsigned(&ivv.vlan, *argv, 0)) {
204 invarg("Invalid \"vlan\" value\n", *argv);
210 if (matches(*argv, "qos") == 0) {
212 if (get_unsigned(&ivv.qos, *argv, 0)) {
213 invarg("Invalid \"qos\" value\n", *argv);
220 addattr_l(&req->n, sizeof(*req), IFLA_VF_VLAN, &ivv, sizeof(ivv));
221 } else if (matches(*argv, "rate") == 0) {
222 struct ifla_vf_tx_rate ivt;
224 if (get_unsigned(&ivt.rate, *argv, 0)) {
225 invarg("Invalid \"rate\" value\n", *argv);
228 addattr_l(&req->n, sizeof(*req), IFLA_VF_TX_RATE, &ivt, sizeof(ivt));
238 incomplete_command();
240 addattr_nest_end(&req->n, vfinfo);
248 int iplink_parse(int argc, char **argv, struct iplink_req *req,
249 char **name, char **type, char **link, char **dev, int *group)
262 if (strcmp(*argv, "up") == 0) {
263 req->i.ifi_change |= IFF_UP;
264 req->i.ifi_flags |= IFF_UP;
265 } else if (strcmp(*argv, "down") == 0) {
266 req->i.ifi_change |= IFF_UP;
267 req->i.ifi_flags &= ~IFF_UP;
268 } else if (strcmp(*argv, "name") == 0) {
271 } else if (matches(*argv, "link") == 0) {
274 } else if (matches(*argv, "address") == 0) {
276 len = ll_addr_a2n(abuf, sizeof(abuf), *argv);
279 addattr_l(&req->n, sizeof(*req), IFLA_ADDRESS, abuf, len);
280 } else if (matches(*argv, "broadcast") == 0 ||
281 strcmp(*argv, "brd") == 0) {
283 len = ll_addr_a2n(abuf, sizeof(abuf), *argv);
286 addattr_l(&req->n, sizeof(*req), IFLA_BROADCAST, abuf, len);
287 } else if (matches(*argv, "txqueuelen") == 0 ||
288 strcmp(*argv, "qlen") == 0 ||
289 matches(*argv, "txqlen") == 0) {
292 duparg("txqueuelen", *argv);
293 if (get_integer(&qlen, *argv, 0))
294 invarg("Invalid \"txqueuelen\" value\n", *argv);
295 addattr_l(&req->n, sizeof(*req), IFLA_TXQLEN, &qlen, 4);
296 } else if (strcmp(*argv, "mtu") == 0) {
299 duparg("mtu", *argv);
300 if (get_integer(&mtu, *argv, 0))
301 invarg("Invalid \"mtu\" value\n", *argv);
302 addattr_l(&req->n, sizeof(*req), IFLA_MTU, &mtu, 4);
303 } else if (strcmp(*argv, "netns") == 0) {
306 duparg("netns", *argv);
307 if (get_integer(&netns, *argv, 0))
308 invarg("Invalid \"netns\" value\n", *argv);
309 addattr_l(&req->n, sizeof(*req), IFLA_NET_NS_PID, &netns, 4);
310 } else if (strcmp(*argv, "multicast") == 0) {
312 req->i.ifi_change |= IFF_MULTICAST;
313 if (strcmp(*argv, "on") == 0) {
314 req->i.ifi_flags |= IFF_MULTICAST;
315 } else if (strcmp(*argv, "off") == 0) {
316 req->i.ifi_flags &= ~IFF_MULTICAST;
318 return on_off("multicast");
319 } else if (strcmp(*argv, "allmulticast") == 0) {
321 req->i.ifi_change |= IFF_ALLMULTI;
322 if (strcmp(*argv, "on") == 0) {
323 req->i.ifi_flags |= IFF_ALLMULTI;
324 } else if (strcmp(*argv, "off") == 0) {
325 req->i.ifi_flags &= ~IFF_ALLMULTI;
327 return on_off("allmulticast");
328 } else if (strcmp(*argv, "promisc") == 0) {
330 req->i.ifi_change |= IFF_PROMISC;
331 if (strcmp(*argv, "on") == 0) {
332 req->i.ifi_flags |= IFF_PROMISC;
333 } else if (strcmp(*argv, "off") == 0) {
334 req->i.ifi_flags &= ~IFF_PROMISC;
336 return on_off("promisc");
337 } else if (strcmp(*argv, "trailers") == 0) {
339 req->i.ifi_change |= IFF_NOTRAILERS;
340 if (strcmp(*argv, "off") == 0) {
341 req->i.ifi_flags |= IFF_NOTRAILERS;
342 } else if (strcmp(*argv, "on") == 0) {
343 req->i.ifi_flags &= ~IFF_NOTRAILERS;
345 return on_off("trailers");
346 } else if (strcmp(*argv, "arp") == 0) {
348 req->i.ifi_change |= IFF_NOARP;
349 if (strcmp(*argv, "on") == 0) {
350 req->i.ifi_flags &= ~IFF_NOARP;
351 } else if (strcmp(*argv, "off") == 0) {
352 req->i.ifi_flags |= IFF_NOARP;
354 return on_off("noarp");
355 } else if (strcmp(*argv, "vf") == 0) {
356 struct rtattr *vflist;
358 if (get_integer(&vf, *argv, 0)) {
359 invarg("Invalid \"vf\" value\n", *argv);
361 vflist = addattr_nest(&req->n, sizeof(*req),
363 len = iplink_parse_vf(vf, &argc, &argv, req);
366 addattr_nest_end(&req->n, vflist);
368 } else if (matches(*argv, "master") == 0) {
371 ifindex = ll_name_to_index(*argv);
373 invarg("Device does not exist\n", *argv);
374 addattr_l(&req->n, sizeof(*req), IFLA_MASTER,
376 } else if (matches(*argv, "nomaster") == 0) {
378 addattr_l(&req->n, sizeof(*req), IFLA_MASTER,
382 } else if (matches(*argv, "dynamic") == 0) {
384 req->i.ifi_change |= IFF_DYNAMIC;
385 if (strcmp(*argv, "on") == 0) {
386 req->i.ifi_flags |= IFF_DYNAMIC;
387 } else if (strcmp(*argv, "off") == 0) {
388 req->i.ifi_flags &= ~IFF_DYNAMIC;
390 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");
833 } else if (matches(*argv, "dynamic") == 0) {
836 if (strcmp(*argv, "on") == 0) {
837 flags |= IFF_DYNAMIC;
838 } else if (strcmp(*argv, "off") == 0) {
839 flags &= ~IFF_DYNAMIC;
841 return on_off("dynamic");
844 if (strcmp(*argv, "dev") == 0) {
847 if (matches(*argv, "help") == 0)
850 duparg2("dev", *argv);
857 fprintf(stderr, "Not enough of information: \"dev\" argument is required.\n");
861 if (newaddr || newbrd) {
862 halen = get_address(dev, &htype);
866 if (parse_address(dev, htype, halen, newaddr, &ifr0) < 0)
870 if (parse_address(dev, htype, halen, newbrd, &ifr1) < 0)
875 if (newname && strcmp(dev, newname)) {
876 if (strlen(newname) == 0)
877 invarg("\"\" is not a valid device identifier\n", "name");
878 if (do_changename(dev, newname) < 0)
883 if (set_qlen(dev, qlen) < 0)
887 if (set_mtu(dev, mtu) < 0)
890 if (newaddr || newbrd) {
892 if (set_address(&ifr1, 1) < 0)
896 if (set_address(&ifr0, 0) < 0)
901 return do_chflags(dev, flags, mask);
904 #endif /* IPLINK_IOCTL_COMPAT */
906 int do_iplink(int argc, char **argv)
909 if (iplink_have_newlink()) {
910 if (matches(*argv, "add") == 0)
911 return iplink_modify(RTM_NEWLINK,
912 NLM_F_CREATE|NLM_F_EXCL,
914 if (matches(*argv, "set") == 0 ||
915 matches(*argv, "change") == 0)
916 return iplink_modify(RTM_NEWLINK, 0,
918 if (matches(*argv, "replace") == 0)
919 return iplink_modify(RTM_NEWLINK,
920 NLM_F_CREATE|NLM_F_REPLACE,
922 if (matches(*argv, "delete") == 0)
923 return iplink_modify(RTM_DELLINK, 0,
926 #if IPLINK_IOCTL_COMPAT
927 if (matches(*argv, "set") == 0)
928 return do_set(argc-1, argv+1);
931 if (matches(*argv, "show") == 0 ||
932 matches(*argv, "lst") == 0 ||
933 matches(*argv, "list") == 0)
934 return ipaddr_list_link(argc-1, argv+1);
935 if (matches(*argv, "help") == 0)
938 return ipaddr_list_link(0, NULL);
940 fprintf(stderr, "Command \"%s\" is unknown, try \"ip link help\".\n", *argv);