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 DEVICE [ { 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, " ip link show [ DEVICE | group GROUP ]\n");
76 if (iplink_have_newlink()) {
77 fprintf(stderr, "\n");
78 fprintf(stderr, "TYPE := { vlan | veth | vcan | dummy | ifb | macvlan | can }\n");
83 static void usage(void)
88 static int on_off(char *msg)
90 fprintf(stderr, "Error: argument of \"%s\" must be \"on\" or \"off\"\n", msg);
94 static void *BODY; /* cached dlopen(NULL) handle */
95 static struct link_util *linkutil_list;
97 struct link_util *get_link_kind(const char *id)
103 for (l = linkutil_list; l; l = l->next)
104 if (strcmp(l->id, id) == 0)
107 snprintf(buf, sizeof(buf), LIBDIR "/ip/link_%s.so", id);
108 dlh = dlopen(buf, RTLD_LAZY);
110 /* look in current binary, only open once */
113 dlh = BODY = dlopen(NULL, RTLD_LAZY);
119 snprintf(buf, sizeof(buf), "%s_link_util", id);
124 l->next = linkutil_list;
129 #if IPLINK_IOCTL_COMPAT
130 static int have_rtnl_newlink = -1;
132 static int accept_msg(const struct sockaddr_nl *who,
133 struct nlmsghdr *n, void *arg)
135 struct nlmsgerr *err = (struct nlmsgerr *)NLMSG_DATA(n);
137 if (n->nlmsg_type == NLMSG_ERROR &&
138 (err->error == -EOPNOTSUPP || err->error == -EINVAL))
139 have_rtnl_newlink = 0;
141 have_rtnl_newlink = 1;
145 static int iplink_have_newlink(void)
153 if (have_rtnl_newlink < 0) {
154 memset(&req, 0, sizeof(req));
156 req.n.nlmsg_len = NLMSG_LENGTH(sizeof(struct ifinfomsg));
157 req.n.nlmsg_flags = NLM_F_REQUEST|NLM_F_ACK;
158 req.n.nlmsg_type = RTM_NEWLINK;
159 req.i.ifi_family = AF_UNSPEC;
161 rtnl_send(&rth, (char *)&req.n, req.n.nlmsg_len);
162 rtnl_listen(&rth, accept_msg, NULL);
164 return have_rtnl_newlink;
166 #else /* IPLINK_IOCTL_COMPAT */
167 static int iplink_have_newlink(void)
171 #endif /* ! IPLINK_IOCTL_COMPAT */
179 int iplink_parse_vf(int vf, int *argcp, char ***argvp,
180 struct iplink_req *req)
182 int len, argc = *argcp;
183 char **argv = *argvp;
184 struct rtattr *vfinfo;
186 vfinfo = addattr_nest(&req->n, sizeof(*req), IFLA_VF_INFO);
188 while (NEXT_ARG_OK()) {
190 if (matches(*argv, "mac") == 0) {
191 struct ifla_vf_mac ivm;
194 len = ll_addr_a2n((char *)ivm.mac, 32, *argv);
197 addattr_l(&req->n, sizeof(*req), IFLA_VF_MAC, &ivm, sizeof(ivm));
198 } else if (matches(*argv, "vlan") == 0) {
199 struct ifla_vf_vlan ivv;
201 if (get_unsigned(&ivv.vlan, *argv, 0)) {
202 invarg("Invalid \"vlan\" value\n", *argv);
208 if (matches(*argv, "qos") == 0) {
210 if (get_unsigned(&ivv.qos, *argv, 0)) {
211 invarg("Invalid \"qos\" value\n", *argv);
218 addattr_l(&req->n, sizeof(*req), IFLA_VF_VLAN, &ivv, sizeof(ivv));
219 } else if (matches(*argv, "rate") == 0) {
220 struct ifla_vf_tx_rate ivt;
222 if (get_unsigned(&ivt.rate, *argv, 0)) {
223 invarg("Invalid \"rate\" value\n", *argv);
226 addattr_l(&req->n, sizeof(*req), IFLA_VF_TX_RATE, &ivt, sizeof(ivt));
236 incomplete_command();
238 addattr_nest_end(&req->n, vfinfo);
246 int iplink_parse(int argc, char **argv, struct iplink_req *req,
247 char **name, char **type, char **link, char **dev)
259 if (strcmp(*argv, "up") == 0) {
260 req->i.ifi_change |= IFF_UP;
261 req->i.ifi_flags |= IFF_UP;
262 } else if (strcmp(*argv, "down") == 0) {
263 req->i.ifi_change |= IFF_UP;
264 req->i.ifi_flags &= ~IFF_UP;
265 } else if (strcmp(*argv, "name") == 0) {
268 } else if (matches(*argv, "link") == 0) {
271 } else if (matches(*argv, "address") == 0) {
273 len = ll_addr_a2n(abuf, sizeof(abuf), *argv);
276 addattr_l(&req->n, sizeof(*req), IFLA_ADDRESS, abuf, len);
277 } else if (matches(*argv, "broadcast") == 0 ||
278 strcmp(*argv, "brd") == 0) {
280 len = ll_addr_a2n(abuf, sizeof(abuf), *argv);
283 addattr_l(&req->n, sizeof(*req), IFLA_BROADCAST, abuf, len);
284 } else if (matches(*argv, "txqueuelen") == 0 ||
285 strcmp(*argv, "qlen") == 0 ||
286 matches(*argv, "txqlen") == 0) {
289 duparg("txqueuelen", *argv);
290 if (get_integer(&qlen, *argv, 0))
291 invarg("Invalid \"txqueuelen\" value\n", *argv);
292 addattr_l(&req->n, sizeof(*req), IFLA_TXQLEN, &qlen, 4);
293 } else if (strcmp(*argv, "mtu") == 0) {
296 duparg("mtu", *argv);
297 if (get_integer(&mtu, *argv, 0))
298 invarg("Invalid \"mtu\" value\n", *argv);
299 addattr_l(&req->n, sizeof(*req), IFLA_MTU, &mtu, 4);
300 } else if (strcmp(*argv, "netns") == 0) {
303 duparg("netns", *argv);
304 if (get_integer(&netns, *argv, 0))
305 invarg("Invalid \"netns\" value\n", *argv);
306 addattr_l(&req->n, sizeof(*req), IFLA_NET_NS_PID, &netns, 4);
307 } else if (strcmp(*argv, "multicast") == 0) {
309 req->i.ifi_change |= IFF_MULTICAST;
310 if (strcmp(*argv, "on") == 0) {
311 req->i.ifi_flags |= IFF_MULTICAST;
312 } else if (strcmp(*argv, "off") == 0) {
313 req->i.ifi_flags &= ~IFF_MULTICAST;
315 return on_off("multicast");
316 } else if (strcmp(*argv, "allmulticast") == 0) {
318 req->i.ifi_change |= IFF_ALLMULTI;
319 if (strcmp(*argv, "on") == 0) {
320 req->i.ifi_flags |= IFF_ALLMULTI;
321 } else if (strcmp(*argv, "off") == 0) {
322 req->i.ifi_flags &= ~IFF_ALLMULTI;
324 return on_off("allmulticast");
325 } else if (strcmp(*argv, "promisc") == 0) {
327 req->i.ifi_change |= IFF_PROMISC;
328 if (strcmp(*argv, "on") == 0) {
329 req->i.ifi_flags |= IFF_PROMISC;
330 } else if (strcmp(*argv, "off") == 0) {
331 req->i.ifi_flags &= ~IFF_PROMISC;
333 return on_off("promisc");
334 } else if (strcmp(*argv, "trailers") == 0) {
336 req->i.ifi_change |= IFF_NOTRAILERS;
337 if (strcmp(*argv, "off") == 0) {
338 req->i.ifi_flags |= IFF_NOTRAILERS;
339 } else if (strcmp(*argv, "on") == 0) {
340 req->i.ifi_flags &= ~IFF_NOTRAILERS;
342 return on_off("trailers");
343 } else if (strcmp(*argv, "arp") == 0) {
345 req->i.ifi_change |= IFF_NOARP;
346 if (strcmp(*argv, "on") == 0) {
347 req->i.ifi_flags &= ~IFF_NOARP;
348 } else if (strcmp(*argv, "off") == 0) {
349 req->i.ifi_flags |= IFF_NOARP;
351 return on_off("noarp");
352 } else if (strcmp(*argv, "vf") == 0) {
353 struct rtattr *vflist;
355 if (get_integer(&vf, *argv, 0)) {
356 invarg("Invalid \"vf\" value\n", *argv);
358 vflist = addattr_nest(&req->n, sizeof(*req),
360 len = iplink_parse_vf(vf, &argc, &argv, req);
363 addattr_nest_end(&req->n, vflist);
365 } else if (matches(*argv, "dynamic") == 0) {
367 req->i.ifi_change |= IFF_DYNAMIC;
368 if (strcmp(*argv, "on") == 0) {
369 req->i.ifi_flags |= IFF_DYNAMIC;
370 } else if (strcmp(*argv, "off") == 0) {
371 req->i.ifi_flags &= ~IFF_DYNAMIC;
373 return on_off("dynamic");
375 } else if (matches(*argv, "type") == 0) {
380 } else if (matches(*argv, "alias") == 0) {
382 addattr_l(&req->n, sizeof(*req), IFLA_IFALIAS,
383 *argv, strlen(*argv));
387 if (strcmp(*argv, "dev") == 0) {
390 if (matches(*argv, "help") == 0)
393 duparg2("dev", *argv);
402 static int iplink_modify(int cmd, unsigned int flags, int argc, char **argv)
409 struct link_util *lu = NULL;
410 struct iplink_req req;
413 memset(&req, 0, sizeof(req));
415 req.n.nlmsg_len = NLMSG_LENGTH(sizeof(struct ifinfomsg));
416 req.n.nlmsg_flags = NLM_F_REQUEST|flags;
417 req.n.nlmsg_type = cmd;
418 req.i.ifi_family = preferred_family;
420 ret = iplink_parse(argc, argv, &req, &name, &type, &link, &dev);
429 struct rtattr *linkinfo = NLMSG_TAIL(&req.n);
430 addattr_l(&req.n, sizeof(req), IFLA_LINKINFO, NULL, 0);
431 addattr_l(&req.n, sizeof(req), IFLA_INFO_KIND, type,
434 lu = get_link_kind(type);
436 struct rtattr * data = NLMSG_TAIL(&req.n);
437 addattr_l(&req.n, sizeof(req), IFLA_INFO_DATA, NULL, 0);
440 lu->parse_opt(lu, argc, argv, &req.n))
443 data->rta_len = (void *)NLMSG_TAIL(&req.n) - (void *)data;
445 if (matches(*argv, "help") == 0)
447 fprintf(stderr, "Garbage instead of arguments \"%s ...\". "
448 "Try \"ip link help\".\n", *argv);
451 linkinfo->rta_len = (void *)NLMSG_TAIL(&req.n) - (void *)linkinfo;
452 } else if (flags & NLM_F_CREATE) {
453 fprintf(stderr, "Not enough information: \"type\" argument "
458 if (!(flags & NLM_F_CREATE)) {
460 fprintf(stderr, "Not enough information: \"dev\" "
461 "argument is required.\n");
465 req.i.ifi_index = ll_name_to_index(dev);
466 if (req.i.ifi_index == 0) {
467 fprintf(stderr, "Cannot find device \"%s\"\n", dev);
471 /* Allow "ip link add dev" and "ip link add name" */
478 ifindex = ll_name_to_index(link);
480 fprintf(stderr, "Cannot find device \"%s\"\n",
484 addattr_l(&req.n, sizeof(req), IFLA_LINK, &ifindex, 4);
489 len = strlen(name) + 1;
491 invarg("\"\" is not a valid device identifier\n", "name");
493 invarg("\"name\" too long\n", name);
494 addattr_l(&req.n, sizeof(req), IFLA_IFNAME, name, len);
497 if (rtnl_talk(&rth, &req.n, 0, 0, NULL, NULL, NULL) < 0)
503 #if IPLINK_IOCTL_COMPAT
504 static int get_ctl_fd(void)
509 fd = socket(PF_INET, SOCK_DGRAM, 0);
513 fd = socket(PF_PACKET, SOCK_DGRAM, 0);
516 fd = socket(PF_INET6, SOCK_DGRAM, 0);
520 perror("Cannot create control socket");
524 static int do_chflags(const char *dev, __u32 flags, __u32 mask)
530 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
534 err = ioctl(fd, SIOCGIFFLAGS, &ifr);
536 perror("SIOCGIFFLAGS");
540 if ((ifr.ifr_flags^flags)&mask) {
541 ifr.ifr_flags &= ~mask;
542 ifr.ifr_flags |= mask&flags;
543 err = ioctl(fd, SIOCSIFFLAGS, &ifr);
545 perror("SIOCSIFFLAGS");
551 static int do_changename(const char *dev, const char *newdev)
557 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
558 strncpy(ifr.ifr_newname, newdev, IFNAMSIZ);
562 err = ioctl(fd, SIOCSIFNAME, &ifr);
564 perror("SIOCSIFNAME");
572 static int set_qlen(const char *dev, int qlen)
581 memset(&ifr, 0, sizeof(ifr));
582 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
584 if (ioctl(s, SIOCSIFTXQLEN, &ifr) < 0) {
585 perror("SIOCSIFXQLEN");
594 static int set_mtu(const char *dev, int mtu)
603 memset(&ifr, 0, sizeof(ifr));
604 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
606 if (ioctl(s, SIOCSIFMTU, &ifr) < 0) {
607 perror("SIOCSIFMTU");
616 static int get_address(const char *dev, int *htype)
619 struct sockaddr_ll me;
623 s = socket(PF_PACKET, SOCK_DGRAM, 0);
625 perror("socket(PF_PACKET)");
629 memset(&ifr, 0, sizeof(ifr));
630 strncpy(ifr.ifr_name, dev, IFNAMSIZ);
631 if (ioctl(s, SIOCGIFINDEX, &ifr) < 0) {
632 perror("SIOCGIFINDEX");
637 memset(&me, 0, sizeof(me));
638 me.sll_family = AF_PACKET;
639 me.sll_ifindex = ifr.ifr_ifindex;
640 me.sll_protocol = htons(ETH_P_LOOP);
641 if (bind(s, (struct sockaddr*)&me, sizeof(me)) == -1) {
648 if (getsockname(s, (struct sockaddr*)&me, &alen) == -1) {
649 perror("getsockname");
654 *htype = me.sll_hatype;
658 static int parse_address(const char *dev, int hatype, int halen,
659 char *lla, struct ifreq *ifr)
663 memset(ifr, 0, sizeof(*ifr));
664 strncpy(ifr->ifr_name, dev, IFNAMSIZ);
665 ifr->ifr_hwaddr.sa_family = hatype;
666 alen = ll_addr_a2n(ifr->ifr_hwaddr.sa_data, 14, lla);
670 fprintf(stderr, "Wrong address (%s) length: expected %d bytes\n", lla, halen);
676 static int set_address(struct ifreq *ifr, int brd)
683 if (ioctl(s, brd?SIOCSIFHWBROADCAST:SIOCSIFHWADDR, ifr) < 0) {
684 perror(brd?"SIOCSIFHWBROADCAST":"SIOCSIFHWADDR");
693 static int do_set(int argc, char **argv)
700 char *newaddr = NULL;
702 struct ifreq ifr0, ifr1;
703 char *newname = NULL;
707 if (strcmp(*argv, "up") == 0) {
710 } else if (strcmp(*argv, "down") == 0) {
713 } else if (strcmp(*argv, "name") == 0) {
716 } else if (matches(*argv, "address") == 0) {
719 } else if (matches(*argv, "broadcast") == 0 ||
720 strcmp(*argv, "brd") == 0) {
723 } else if (matches(*argv, "txqueuelen") == 0 ||
724 strcmp(*argv, "qlen") == 0 ||
725 matches(*argv, "txqlen") == 0) {
728 duparg("txqueuelen", *argv);
729 if (get_integer(&qlen, *argv, 0))
730 invarg("Invalid \"txqueuelen\" value\n", *argv);
731 } else if (strcmp(*argv, "mtu") == 0) {
734 duparg("mtu", *argv);
735 if (get_integer(&mtu, *argv, 0))
736 invarg("Invalid \"mtu\" value\n", *argv);
737 } else if (strcmp(*argv, "multicast") == 0) {
739 mask |= IFF_MULTICAST;
740 if (strcmp(*argv, "on") == 0) {
741 flags |= IFF_MULTICAST;
742 } else if (strcmp(*argv, "off") == 0) {
743 flags &= ~IFF_MULTICAST;
745 return on_off("multicast");
746 } else if (strcmp(*argv, "allmulticast") == 0) {
748 mask |= IFF_ALLMULTI;
749 if (strcmp(*argv, "on") == 0) {
750 flags |= IFF_ALLMULTI;
751 } else if (strcmp(*argv, "off") == 0) {
752 flags &= ~IFF_ALLMULTI;
754 return on_off("allmulticast");
755 } else if (strcmp(*argv, "promisc") == 0) {
758 if (strcmp(*argv, "on") == 0) {
759 flags |= IFF_PROMISC;
760 } else if (strcmp(*argv, "off") == 0) {
761 flags &= ~IFF_PROMISC;
763 return on_off("promisc");
764 } else if (strcmp(*argv, "trailers") == 0) {
766 mask |= IFF_NOTRAILERS;
767 if (strcmp(*argv, "off") == 0) {
768 flags |= IFF_NOTRAILERS;
769 } else if (strcmp(*argv, "on") == 0) {
770 flags &= ~IFF_NOTRAILERS;
772 return on_off("trailers");
773 } else if (strcmp(*argv, "arp") == 0) {
776 if (strcmp(*argv, "on") == 0) {
778 } else if (strcmp(*argv, "off") == 0) {
781 return on_off("noarp");
783 } else if (matches(*argv, "dynamic") == 0) {
786 if (strcmp(*argv, "on") == 0) {
787 flags |= IFF_DYNAMIC;
788 } else if (strcmp(*argv, "off") == 0) {
789 flags &= ~IFF_DYNAMIC;
791 return on_off("dynamic");
794 if (strcmp(*argv, "dev") == 0) {
797 if (matches(*argv, "help") == 0)
800 duparg2("dev", *argv);
807 fprintf(stderr, "Not enough of information: \"dev\" argument is required.\n");
811 if (newaddr || newbrd) {
812 halen = get_address(dev, &htype);
816 if (parse_address(dev, htype, halen, newaddr, &ifr0) < 0)
820 if (parse_address(dev, htype, halen, newbrd, &ifr1) < 0)
825 if (newname && strcmp(dev, newname)) {
826 if (strlen(newname) == 0)
827 invarg("\"\" is not a valid device identifier\n", "name");
828 if (do_changename(dev, newname) < 0)
833 if (set_qlen(dev, qlen) < 0)
837 if (set_mtu(dev, mtu) < 0)
840 if (newaddr || newbrd) {
842 if (set_address(&ifr1, 1) < 0)
846 if (set_address(&ifr0, 0) < 0)
851 return do_chflags(dev, flags, mask);
854 #endif /* IPLINK_IOCTL_COMPAT */
856 int do_iplink(int argc, char **argv)
859 if (iplink_have_newlink()) {
860 if (matches(*argv, "add") == 0)
861 return iplink_modify(RTM_NEWLINK,
862 NLM_F_CREATE|NLM_F_EXCL,
864 if (matches(*argv, "set") == 0 ||
865 matches(*argv, "change") == 0)
866 return iplink_modify(RTM_NEWLINK, 0,
868 if (matches(*argv, "replace") == 0)
869 return iplink_modify(RTM_NEWLINK,
870 NLM_F_CREATE|NLM_F_REPLACE,
872 if (matches(*argv, "delete") == 0)
873 return iplink_modify(RTM_DELLINK, 0,
876 #if IPLINK_IOCTL_COMPAT
877 if (matches(*argv, "set") == 0)
878 return do_set(argc-1, argv+1);
881 if (matches(*argv, "show") == 0 ||
882 matches(*argv, "lst") == 0 ||
883 matches(*argv, "list") == 0)
884 return ipaddr_list_link(argc-1, argv+1);
885 if (matches(*argv, "help") == 0)
888 return ipaddr_list_link(0, NULL);
890 fprintf(stderr, "Command \"%s\" is unknown, try \"ip link help\".\n", *argv);