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);
367 } else if (matches(*argv, "master") == 0) {
370 ifindex = ll_name_to_index(*argv);
372 invarg("Device does not exist\n", *argv);
373 addattr_l(&req->n, sizeof(*req), IFLA_MASTER,
375 } else if (matches(*argv, "nomaster") == 0) {
377 addattr_l(&req->n, sizeof(*req), IFLA_MASTER,
379 } else if (matches(*argv, "dynamic") == 0) {
381 req->i.ifi_change |= IFF_DYNAMIC;
382 if (strcmp(*argv, "on") == 0) {
383 req->i.ifi_flags |= IFF_DYNAMIC;
384 } else if (strcmp(*argv, "off") == 0) {
385 req->i.ifi_flags &= ~IFF_DYNAMIC;
387 return on_off("dynamic");
388 } else if (matches(*argv, "type") == 0) {
393 } else if (matches(*argv, "alias") == 0) {
395 addattr_l(&req->n, sizeof(*req), IFLA_IFALIAS,
396 *argv, strlen(*argv));
399 } else if (strcmp(*argv, "group") == 0) {
402 duparg("group", *argv);
403 if (rtnl_group_a2n(group, *argv))
404 invarg("Invalid \"group\" value\n", *argv);
406 if (strcmp(*argv, "dev") == 0) {
409 if (matches(*argv, "help") == 0)
412 duparg2("dev", *argv);
421 static int iplink_modify(int cmd, unsigned int flags, int argc, char **argv)
429 struct link_util *lu = NULL;
430 struct iplink_req req;
433 memset(&req, 0, sizeof(req));
435 req.n.nlmsg_len = NLMSG_LENGTH(sizeof(struct ifinfomsg));
436 req.n.nlmsg_flags = NLM_F_REQUEST|flags;
437 req.n.nlmsg_type = cmd;
438 req.i.ifi_family = preferred_family;
440 ret = iplink_parse(argc, argv, &req, &name, &type, &link, &dev, &group);
449 addattr_l(&req.n, sizeof(req), IFLA_GROUP,
450 &group, sizeof(group));
453 fprintf(stderr, "Garbage instead of arguments "
454 "\"%s ...\". Try \"ip link "
458 if (flags & NLM_F_CREATE) {
459 fprintf(stderr, "group cannot be used when "
460 "creating devices.\n");
465 addattr32(&req.n, sizeof(req), IFLA_GROUP, group);
466 if (rtnl_talk(&rth, &req.n, 0, 0, NULL, NULL, NULL) < 0)
475 struct rtattr *linkinfo = NLMSG_TAIL(&req.n);
476 addattr_l(&req.n, sizeof(req), IFLA_LINKINFO, NULL, 0);
477 addattr_l(&req.n, sizeof(req), IFLA_INFO_KIND, type,
480 lu = get_link_kind(type);
482 struct rtattr * data = NLMSG_TAIL(&req.n);
483 addattr_l(&req.n, sizeof(req), IFLA_INFO_DATA, NULL, 0);
486 lu->parse_opt(lu, argc, argv, &req.n))
489 data->rta_len = (void *)NLMSG_TAIL(&req.n) - (void *)data;
491 if (matches(*argv, "help") == 0)
493 fprintf(stderr, "Garbage instead of arguments \"%s ...\". "
494 "Try \"ip link help\".\n", *argv);
497 linkinfo->rta_len = (void *)NLMSG_TAIL(&req.n) - (void *)linkinfo;
498 } else if (flags & NLM_F_CREATE) {
499 fprintf(stderr, "Not enough information: \"type\" argument "
504 if (!(flags & NLM_F_CREATE)) {
506 fprintf(stderr, "Not enough information: \"dev\" "
507 "argument is required.\n");
511 req.i.ifi_index = ll_name_to_index(dev);
512 if (req.i.ifi_index == 0) {
513 fprintf(stderr, "Cannot find device \"%s\"\n", dev);
517 /* Allow "ip link add dev" and "ip link add name" */
524 ifindex = ll_name_to_index(link);
526 fprintf(stderr, "Cannot find device \"%s\"\n",
530 addattr_l(&req.n, sizeof(req), IFLA_LINK, &ifindex, 4);
535 len = strlen(name) + 1;
537 invarg("\"\" is not a valid device identifier\n", "name");
539 invarg("\"name\" too long\n", name);
540 addattr_l(&req.n, sizeof(req), IFLA_IFNAME, name, len);
543 if (rtnl_talk(&rth, &req.n, 0, 0, NULL, NULL, NULL) < 0)
549 #if IPLINK_IOCTL_COMPAT
550 static int get_ctl_fd(void)
555 fd = socket(PF_INET, SOCK_DGRAM, 0);
559 fd = socket(PF_PACKET, SOCK_DGRAM, 0);
562 fd = socket(PF_INET6, SOCK_DGRAM, 0);
566 perror("Cannot create control socket");
570 static int do_chflags(const char *dev, __u32 flags, __u32 mask)
576 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
580 err = ioctl(fd, SIOCGIFFLAGS, &ifr);
582 perror("SIOCGIFFLAGS");
586 if ((ifr.ifr_flags^flags)&mask) {
587 ifr.ifr_flags &= ~mask;
588 ifr.ifr_flags |= mask&flags;
589 err = ioctl(fd, SIOCSIFFLAGS, &ifr);
591 perror("SIOCSIFFLAGS");
597 static int do_changename(const char *dev, const char *newdev)
603 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
604 strncpy(ifr.ifr_newname, newdev, IFNAMSIZ);
608 err = ioctl(fd, SIOCSIFNAME, &ifr);
610 perror("SIOCSIFNAME");
618 static int set_qlen(const char *dev, int qlen)
627 memset(&ifr, 0, sizeof(ifr));
628 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
630 if (ioctl(s, SIOCSIFTXQLEN, &ifr) < 0) {
631 perror("SIOCSIFXQLEN");
640 static int set_mtu(const char *dev, int mtu)
649 memset(&ifr, 0, sizeof(ifr));
650 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
652 if (ioctl(s, SIOCSIFMTU, &ifr) < 0) {
653 perror("SIOCSIFMTU");
662 static int get_address(const char *dev, int *htype)
665 struct sockaddr_ll me;
669 s = socket(PF_PACKET, SOCK_DGRAM, 0);
671 perror("socket(PF_PACKET)");
675 memset(&ifr, 0, sizeof(ifr));
676 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
677 if (ioctl(s, SIOCGIFINDEX, &ifr) < 0) {
678 perror("SIOCGIFINDEX");
683 memset(&me, 0, sizeof(me));
684 me.sll_family = AF_PACKET;
685 me.sll_ifindex = ifr.ifr_ifindex;
686 me.sll_protocol = htons(ETH_P_LOOP);
687 if (bind(s, (struct sockaddr*)&me, sizeof(me)) == -1) {
694 if (getsockname(s, (struct sockaddr*)&me, &alen) == -1) {
695 perror("getsockname");
700 *htype = me.sll_hatype;
704 static int parse_address(const char *dev, int hatype, int halen,
705 char *lla, struct ifreq *ifr)
709 memset(ifr, 0, sizeof(*ifr));
710 strncpy(ifr->ifr_name, dev, IFNAMSIZ);
711 ifr->ifr_hwaddr.sa_family = hatype;
712 alen = ll_addr_a2n(ifr->ifr_hwaddr.sa_data, 14, lla);
716 fprintf(stderr, "Wrong address (%s) length: expected %d bytes\n", lla, halen);
722 static int set_address(struct ifreq *ifr, int brd)
729 if (ioctl(s, brd?SIOCSIFHWBROADCAST:SIOCSIFHWADDR, ifr) < 0) {
730 perror(brd?"SIOCSIFHWBROADCAST":"SIOCSIFHWADDR");
739 static int do_set(int argc, char **argv)
746 char *newaddr = NULL;
748 struct ifreq ifr0, ifr1;
749 char *newname = NULL;
753 if (strcmp(*argv, "up") == 0) {
756 } else if (strcmp(*argv, "down") == 0) {
759 } else if (strcmp(*argv, "name") == 0) {
762 } else if (matches(*argv, "address") == 0) {
765 } else if (matches(*argv, "broadcast") == 0 ||
766 strcmp(*argv, "brd") == 0) {
769 } else if (matches(*argv, "txqueuelen") == 0 ||
770 strcmp(*argv, "qlen") == 0 ||
771 matches(*argv, "txqlen") == 0) {
774 duparg("txqueuelen", *argv);
775 if (get_integer(&qlen, *argv, 0))
776 invarg("Invalid \"txqueuelen\" value\n", *argv);
777 } else if (strcmp(*argv, "mtu") == 0) {
780 duparg("mtu", *argv);
781 if (get_integer(&mtu, *argv, 0))
782 invarg("Invalid \"mtu\" value\n", *argv);
783 } else if (strcmp(*argv, "multicast") == 0) {
785 mask |= IFF_MULTICAST;
786 if (strcmp(*argv, "on") == 0) {
787 flags |= IFF_MULTICAST;
788 } else if (strcmp(*argv, "off") == 0) {
789 flags &= ~IFF_MULTICAST;
791 return on_off("multicast");
792 } else if (strcmp(*argv, "allmulticast") == 0) {
794 mask |= IFF_ALLMULTI;
795 if (strcmp(*argv, "on") == 0) {
796 flags |= IFF_ALLMULTI;
797 } else if (strcmp(*argv, "off") == 0) {
798 flags &= ~IFF_ALLMULTI;
800 return on_off("allmulticast");
801 } else if (strcmp(*argv, "promisc") == 0) {
804 if (strcmp(*argv, "on") == 0) {
805 flags |= IFF_PROMISC;
806 } else if (strcmp(*argv, "off") == 0) {
807 flags &= ~IFF_PROMISC;
809 return on_off("promisc");
810 } else if (strcmp(*argv, "trailers") == 0) {
812 mask |= IFF_NOTRAILERS;
813 if (strcmp(*argv, "off") == 0) {
814 flags |= IFF_NOTRAILERS;
815 } else if (strcmp(*argv, "on") == 0) {
816 flags &= ~IFF_NOTRAILERS;
818 return on_off("trailers");
819 } else if (strcmp(*argv, "arp") == 0) {
822 if (strcmp(*argv, "on") == 0) {
824 } else if (strcmp(*argv, "off") == 0) {
827 return on_off("noarp");
828 } else if (matches(*argv, "dynamic") == 0) {
831 if (strcmp(*argv, "on") == 0) {
832 flags |= IFF_DYNAMIC;
833 } else if (strcmp(*argv, "off") == 0) {
834 flags &= ~IFF_DYNAMIC;
836 return on_off("dynamic");
838 if (strcmp(*argv, "dev") == 0) {
841 if (matches(*argv, "help") == 0)
844 duparg2("dev", *argv);
851 fprintf(stderr, "Not enough of information: \"dev\" argument is required.\n");
855 if (newaddr || newbrd) {
856 halen = get_address(dev, &htype);
860 if (parse_address(dev, htype, halen, newaddr, &ifr0) < 0)
864 if (parse_address(dev, htype, halen, newbrd, &ifr1) < 0)
869 if (newname && strcmp(dev, newname)) {
870 if (strlen(newname) == 0)
871 invarg("\"\" is not a valid device identifier\n", "name");
872 if (do_changename(dev, newname) < 0)
877 if (set_qlen(dev, qlen) < 0)
881 if (set_mtu(dev, mtu) < 0)
884 if (newaddr || newbrd) {
886 if (set_address(&ifr1, 1) < 0)
890 if (set_address(&ifr0, 0) < 0)
895 return do_chflags(dev, flags, mask);
898 #endif /* IPLINK_IOCTL_COMPAT */
900 int do_iplink(int argc, char **argv)
903 if (iplink_have_newlink()) {
904 if (matches(*argv, "add") == 0)
905 return iplink_modify(RTM_NEWLINK,
906 NLM_F_CREATE|NLM_F_EXCL,
908 if (matches(*argv, "set") == 0 ||
909 matches(*argv, "change") == 0)
910 return iplink_modify(RTM_NEWLINK, 0,
912 if (matches(*argv, "replace") == 0)
913 return iplink_modify(RTM_NEWLINK,
914 NLM_F_CREATE|NLM_F_REPLACE,
916 if (matches(*argv, "delete") == 0)
917 return iplink_modify(RTM_DELLINK, 0,
920 #if IPLINK_IOCTL_COMPAT
921 if (matches(*argv, "set") == 0)
922 return do_set(argc-1, argv+1);
925 if (matches(*argv, "show") == 0 ||
926 matches(*argv, "lst") == 0 ||
927 matches(*argv, "list") == 0)
928 return ipaddr_list_link(argc-1, argv+1);
929 if (matches(*argv, "help") == 0)
932 return ipaddr_list_link(0, NULL);
934 fprintf(stderr, "Command \"%s\" is unknown, try \"ip link help\".\n", *argv);