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>
30 #include <linux/mpls.h>
34 #include "ip_common.h"
36 #include "namespace.h"
38 #define IPLINK_IOCTL_COMPAT 1
40 #define LIBDIR "/usr/lib"
43 static void usage(void) __attribute__((noreturn
));
44 static int iplink_have_newlink(void);
46 void iplink_usage(void)
48 if (iplink_have_newlink()) {
50 "Usage: ip link add [link DEV] [ name ] NAME\n"
51 " [ txqueuelen PACKETS ]\n"
52 " [ address LLADDR ]\n"
53 " [ broadcast LLADDR ]\n"
54 " [ mtu MTU ] [index IDX ]\n"
55 " [ numtxqueues QUEUE_COUNT ]\n"
56 " [ numrxqueues QUEUE_COUNT ]\n"
57 " type TYPE [ ARGS ]\n"
59 " ip link delete { DEVICE | dev DEVICE | group DEVGROUP } type TYPE [ ARGS ]\n"
61 " ip link set { DEVICE | dev DEVICE | group DEVGROUP }\n"
62 " [ { up | down } ]\n"
63 " [ type TYPE ARGS ]\n");
66 "Usage: ip link set DEVICE [ { up | down } ]\n");
69 " [ arp { on | off } ]\n"
70 " [ dynamic { on | off } ]\n"
71 " [ multicast { on | off } ]\n"
72 " [ allmulticast { on | off } ]\n"
73 " [ promisc { on | off } ]\n"
74 " [ trailers { on | off } ]\n"
75 " [ carrier { on | off } ]\n"
76 " [ txqueuelen PACKETS ]\n"
78 " [ address LLADDR ]\n"
79 " [ broadcast LLADDR ]\n"
81 " [ netns { PID | NAME } ]\n"
82 " [ link-netnsid ID ]\n"
84 " [ vf NUM [ mac LLADDR ]\n"
85 " [ vlan VLANID [ qos VLAN-QOS ] [ proto VLAN-PROTO ] ]\n"
87 " [ max_tx_rate TXRATE ]\n"
88 " [ min_tx_rate TXRATE ]\n"
89 " [ spoofchk { on | off} ]\n"
90 " [ query_rss { on | off} ]\n"
91 " [ state { auto | enable | disable} ] ]\n"
92 " [ trust { on | off} ] ]\n"
93 " [ node_guid { eui64 } ]\n"
94 " [ port_guid { eui64 } ]\n"
96 " object FILE [ section NAME ] [ verbose ] |\n"
98 " [ master DEVICE ][ vrf NAME ]\n"
100 " [ addrgenmode { eui64 | none | stable_secret | random } ]\n"
101 " [ protodown { on | off } ]\n"
103 " ip link show [ DEVICE | group GROUP ] [up] [master DEV] [vrf NAME] [type TYPE]\n");
105 fprintf(stderr
, "\n ip link xstats type TYPE [ ARGS ]\n");
106 fprintf(stderr
, "\n ip link afstats [ dev DEVICE ]\n");
108 if (iplink_have_newlink()) {
111 " ip link help [ TYPE ]\n"
113 "TYPE := { vlan | veth | vcan | dummy | ifb | macvlan | macvtap |\n"
114 " bridge | bond | team | ipoib | ip6tnl | ipip | sit | vxlan |\n"
115 " gre | gretap | erspan | ip6gre | ip6gretap | vti | nlmon |\n"
116 " team_slave | bond_slave | ipvlan | geneve | bridge_slave |\n"
117 " vrf | macsec }\n");
122 static void usage(void)
127 static int on_off(const char *msg
, const char *realval
)
130 "Error: argument of \"%s\" must be \"on\" or \"off\", not \"%s\"\n",
135 static void *BODY
; /* cached dlopen(NULL) handle */
136 static struct link_util
*linkutil_list
;
138 struct link_util
*get_link_kind(const char *id
)
144 for (l
= linkutil_list
; l
; l
= l
->next
)
145 if (strcmp(l
->id
, id
) == 0)
148 snprintf(buf
, sizeof(buf
), LIBDIR
"/ip/link_%s.so", id
);
149 dlh
= dlopen(buf
, RTLD_LAZY
);
151 /* look in current binary, only open once */
154 dlh
= BODY
= dlopen(NULL
, RTLD_LAZY
);
160 snprintf(buf
, sizeof(buf
), "%s_link_util", id
);
165 l
->next
= linkutil_list
;
170 static int get_link_mode(const char *mode
)
172 if (strcasecmp(mode
, "default") == 0)
173 return IF_LINK_MODE_DEFAULT
;
174 if (strcasecmp(mode
, "dormant") == 0)
175 return IF_LINK_MODE_DORMANT
;
179 static int get_addr_gen_mode(const char *mode
)
181 if (strcasecmp(mode
, "eui64") == 0)
182 return IN6_ADDR_GEN_MODE_EUI64
;
183 if (strcasecmp(mode
, "none") == 0)
184 return IN6_ADDR_GEN_MODE_NONE
;
185 if (strcasecmp(mode
, "stable_secret") == 0)
186 return IN6_ADDR_GEN_MODE_STABLE_PRIVACY
;
187 if (strcasecmp(mode
, "random") == 0)
188 return IN6_ADDR_GEN_MODE_RANDOM
;
192 #if IPLINK_IOCTL_COMPAT
193 static int have_rtnl_newlink
= -1;
195 static int accept_msg(const struct sockaddr_nl
*who
,
196 struct rtnl_ctrl_data
*ctrl
,
197 struct nlmsghdr
*n
, void *arg
)
199 struct nlmsgerr
*err
= (struct nlmsgerr
*)NLMSG_DATA(n
);
201 if (n
->nlmsg_type
== NLMSG_ERROR
&&
202 (err
->error
== -EOPNOTSUPP
|| err
->error
== -EINVAL
))
203 have_rtnl_newlink
= 0;
205 have_rtnl_newlink
= 1;
209 static int iplink_have_newlink(void)
216 .n
.nlmsg_len
= NLMSG_LENGTH(sizeof(struct ifinfomsg
)),
217 .n
.nlmsg_flags
= NLM_F_REQUEST
| NLM_F_ACK
,
218 .n
.nlmsg_type
= RTM_NEWLINK
,
219 .i
.ifi_family
= AF_UNSPEC
,
222 if (have_rtnl_newlink
< 0) {
223 if (rtnl_send(&rth
, &req
.n
, req
.n
.nlmsg_len
) < 0) {
224 perror("request send failed");
227 rtnl_listen(&rth
, accept_msg
, NULL
);
229 return have_rtnl_newlink
;
231 #else /* IPLINK_IOCTL_COMPAT */
232 static int iplink_have_newlink(void)
236 #endif /* ! IPLINK_IOCTL_COMPAT */
238 static int nl_get_ll_addr_len(unsigned int dev_index
)
241 struct iplink_req req
= {
243 .nlmsg_len
= NLMSG_LENGTH(sizeof(struct ifinfomsg
)),
244 .nlmsg_type
= RTM_GETLINK
,
245 .nlmsg_flags
= NLM_F_REQUEST
248 .ifi_family
= preferred_family
,
249 .ifi_index
= dev_index
,
252 struct rtattr
*tb
[IFLA_MAX
+1];
254 if (rtnl_talk(&rth
, &req
.n
, &req
.n
, sizeof(req
)) < 0)
257 len
= req
.n
.nlmsg_len
- NLMSG_LENGTH(sizeof(req
.i
));
261 parse_rtattr_flags(tb
, IFLA_MAX
, IFLA_RTA(&req
.i
), len
, NLA_F_NESTED
);
262 if (!tb
[IFLA_ADDRESS
])
265 return RTA_PAYLOAD(tb
[IFLA_ADDRESS
]);
268 static void iplink_parse_vf_vlan_info(int vf
, int *argcp
, char ***argvp
,
269 struct ifla_vf_vlan_info
*ivvip
)
272 char **argv
= *argvp
;
275 if (get_unsigned(&ivvip
->vlan
, *argv
, 0))
276 invarg("Invalid \"vlan\" value\n", *argv
);
280 ivvip
->vlan_proto
= htons(ETH_P_8021Q
);
283 if (matches(*argv
, "qos") == 0) {
285 if (get_unsigned(&ivvip
->qos
, *argv
, 0))
286 invarg("Invalid \"qos\" value\n", *argv
);
294 if (matches(*argv
, "proto") == 0) {
296 if (ll_proto_a2n(&ivvip
->vlan_proto
, *argv
))
297 invarg("protocol is invalid\n", *argv
);
298 if (ivvip
->vlan_proto
!= htons(ETH_P_8021AD
) &&
299 ivvip
->vlan_proto
!= htons(ETH_P_8021Q
)) {
302 char msg
[64 + sizeof(b1
) + sizeof(b2
)];
305 "Invalid \"vlan protocol\" value - supported %s, %s\n",
306 ll_proto_n2a(htons(ETH_P_8021Q
),
308 ll_proto_n2a(htons(ETH_P_8021AD
),
322 static int iplink_parse_vf(int vf
, int *argcp
, char ***argvp
,
323 struct iplink_req
*req
, int dev_index
)
325 char new_rate_api
= 0, count
= 0, override_legacy_rate
= 0;
326 struct ifla_vf_rate tivt
;
327 int len
, argc
= *argcp
;
328 char **argv
= *argvp
;
329 struct rtattr
*vfinfo
;
331 tivt
.min_tx_rate
= -1;
332 tivt
.max_tx_rate
= -1;
334 vfinfo
= addattr_nest(&req
->n
, sizeof(*req
), IFLA_VF_INFO
);
336 while (NEXT_ARG_OK()) {
339 if (!matches(*argv
, "max_tx_rate")) {
342 /* override legacy rate */
343 override_legacy_rate
= 1;
344 } else if (!matches(*argv
, "min_tx_rate")) {
355 while (NEXT_ARG_OK()) {
357 if (matches(*argv
, "mac") == 0) {
358 struct ifla_vf_mac ivm
= { 0 };
359 int halen
= nl_get_ll_addr_len(dev_index
);
363 len
= ll_addr_a2n((char *)ivm
.mac
, 32, *argv
);
366 if (halen
> 0 && len
!= halen
) {
368 "Invalid address length %d - must be %d bytes\n",
372 addattr_l(&req
->n
, sizeof(*req
), IFLA_VF_MAC
,
374 } else if (matches(*argv
, "vlan") == 0) {
375 struct ifla_vf_vlan_info ivvi
;
377 iplink_parse_vf_vlan_info(vf
, &argc
, &argv
, &ivvi
);
378 /* support the old interface in case of older kernel*/
379 if (ivvi
.vlan_proto
== htons(ETH_P_8021Q
)) {
380 struct ifla_vf_vlan ivv
;
383 ivv
.vlan
= ivvi
.vlan
;
385 addattr_l(&req
->n
, sizeof(*req
),
386 IFLA_VF_VLAN
, &ivv
, sizeof(ivv
));
388 struct rtattr
*vfvlanlist
;
390 vfvlanlist
= addattr_nest(&req
->n
, sizeof(*req
),
392 addattr_l(&req
->n
, sizeof(*req
),
393 IFLA_VF_VLAN_INFO
, &ivvi
,
396 while (NEXT_ARG_OK()) {
398 if (matches(*argv
, "vlan") != 0) {
402 iplink_parse_vf_vlan_info(vf
, &argc
,
404 addattr_l(&req
->n
, sizeof(*req
),
405 IFLA_VF_VLAN_INFO
, &ivvi
,
408 addattr_nest_end(&req
->n
, vfvlanlist
);
410 } else if (matches(*argv
, "rate") == 0) {
411 struct ifla_vf_tx_rate ivt
;
414 if (get_unsigned(&ivt
.rate
, *argv
, 0))
415 invarg("Invalid \"rate\" value\n", *argv
);
419 addattr_l(&req
->n
, sizeof(*req
),
420 IFLA_VF_TX_RATE
, &ivt
, sizeof(ivt
));
421 else if (!override_legacy_rate
)
422 tivt
.max_tx_rate
= ivt
.rate
;
424 } else if (matches(*argv
, "max_tx_rate") == 0) {
426 if (get_unsigned(&tivt
.max_tx_rate
, *argv
, 0))
427 invarg("Invalid \"max tx rate\" value\n",
431 } else if (matches(*argv
, "min_tx_rate") == 0) {
433 if (get_unsigned(&tivt
.min_tx_rate
, *argv
, 0))
434 invarg("Invalid \"min tx rate\" value\n",
438 } else if (matches(*argv
, "spoofchk") == 0) {
439 struct ifla_vf_spoofchk ivs
;
442 if (matches(*argv
, "on") == 0)
444 else if (matches(*argv
, "off") == 0)
447 return on_off("spoofchk", *argv
);
449 addattr_l(&req
->n
, sizeof(*req
), IFLA_VF_SPOOFCHK
,
452 } else if (matches(*argv
, "query_rss") == 0) {
453 struct ifla_vf_rss_query_en ivs
;
456 if (matches(*argv
, "on") == 0)
458 else if (matches(*argv
, "off") == 0)
461 return on_off("query_rss", *argv
);
463 addattr_l(&req
->n
, sizeof(*req
), IFLA_VF_RSS_QUERY_EN
,
466 } else if (matches(*argv
, "trust") == 0) {
467 struct ifla_vf_trust ivt
;
470 if (matches(*argv
, "on") == 0)
472 else if (matches(*argv
, "off") == 0)
475 invarg("Invalid \"trust\" value\n", *argv
);
477 addattr_l(&req
->n
, sizeof(*req
), IFLA_VF_TRUST
,
480 } else if (matches(*argv
, "state") == 0) {
481 struct ifla_vf_link_state ivl
;
484 if (matches(*argv
, "auto") == 0)
485 ivl
.link_state
= IFLA_VF_LINK_STATE_AUTO
;
486 else if (matches(*argv
, "enable") == 0)
487 ivl
.link_state
= IFLA_VF_LINK_STATE_ENABLE
;
488 else if (matches(*argv
, "disable") == 0)
489 ivl
.link_state
= IFLA_VF_LINK_STATE_DISABLE
;
491 invarg("Invalid \"state\" value\n", *argv
);
493 addattr_l(&req
->n
, sizeof(*req
), IFLA_VF_LINK_STATE
,
495 } else if (matches(*argv
, "node_guid") == 0) {
496 struct ifla_vf_guid ivg
;
500 if (get_guid(&ivg
.guid
, *argv
)) {
501 invarg("Invalid GUID format\n", *argv
);
504 addattr_l(&req
->n
, sizeof(*req
), IFLA_VF_IB_NODE_GUID
,
506 } else if (matches(*argv
, "port_guid") == 0) {
507 struct ifla_vf_guid ivg
;
511 if (get_guid(&ivg
.guid
, *argv
)) {
512 invarg("Invalid GUID format\n", *argv
);
515 addattr_l(&req
->n
, sizeof(*req
), IFLA_VF_IB_PORT_GUID
,
527 if (tivt
.min_tx_rate
== -1 || tivt
.max_tx_rate
== -1) {
528 ipaddr_get_vf_rate(tivt
.vf
, &tmin
, &tmax
, dev_index
);
529 if (tivt
.min_tx_rate
== -1)
530 tivt
.min_tx_rate
= tmin
;
531 if (tivt
.max_tx_rate
== -1)
532 tivt
.max_tx_rate
= tmax
;
534 addattr_l(&req
->n
, sizeof(*req
), IFLA_VF_RATE
, &tivt
,
539 incomplete_command();
541 addattr_nest_end(&req
->n
, vfinfo
);
548 int iplink_parse(int argc
, char **argv
, struct iplink_req
*req
,
549 char **name
, char **type
, char **link
, char **dev
,
550 int *group
, int *index
)
558 int numtxqueues
= -1;
559 int numrxqueues
= -1;
561 int link_netnsid
= -1;
568 if (strcmp(*argv
, "up") == 0) {
569 req
->i
.ifi_change
|= IFF_UP
;
570 req
->i
.ifi_flags
|= IFF_UP
;
571 } else if (strcmp(*argv
, "down") == 0) {
572 req
->i
.ifi_change
|= IFF_UP
;
573 req
->i
.ifi_flags
&= ~IFF_UP
;
574 } else if (strcmp(*argv
, "name") == 0) {
577 } else if (strcmp(*argv
, "index") == 0) {
579 *index
= atoi(*argv
);
581 invarg("Invalid \"index\" value", *argv
);
582 } else if (matches(*argv
, "link") == 0) {
585 } else if (matches(*argv
, "address") == 0) {
587 addr_len
= ll_addr_a2n(abuf
, sizeof(abuf
), *argv
);
590 addattr_l(&req
->n
, sizeof(*req
),
591 IFLA_ADDRESS
, abuf
, addr_len
);
592 } else if (matches(*argv
, "broadcast") == 0 ||
593 strcmp(*argv
, "brd") == 0) {
595 len
= ll_addr_a2n(abuf
, sizeof(abuf
), *argv
);
598 addattr_l(&req
->n
, sizeof(*req
),
599 IFLA_BROADCAST
, abuf
, len
);
600 } else if (matches(*argv
, "txqueuelen") == 0 ||
601 strcmp(*argv
, "qlen") == 0 ||
602 matches(*argv
, "txqlen") == 0) {
605 duparg("txqueuelen", *argv
);
606 if (get_integer(&qlen
, *argv
, 0))
607 invarg("Invalid \"txqueuelen\" value\n", *argv
);
608 addattr_l(&req
->n
, sizeof(*req
),
609 IFLA_TXQLEN
, &qlen
, 4);
610 } else if (strcmp(*argv
, "mtu") == 0) {
613 duparg("mtu", *argv
);
614 if (get_integer(&mtu
, *argv
, 0))
615 invarg("Invalid \"mtu\" value\n", *argv
);
616 addattr_l(&req
->n
, sizeof(*req
), IFLA_MTU
, &mtu
, 4);
617 } else if (strcmp(*argv
, "xdpgeneric") == 0 ||
618 strcmp(*argv
, "xdpdrv") == 0 ||
619 strcmp(*argv
, "xdpoffload") == 0 ||
620 strcmp(*argv
, "xdp") == 0) {
621 bool generic
= strcmp(*argv
, "xdpgeneric") == 0;
622 bool drv
= strcmp(*argv
, "xdpdrv") == 0;
623 bool offload
= strcmp(*argv
, "xdpoffload") == 0;
626 if (xdp_parse(&argc
, &argv
, req
, generic
, drv
,
629 } else if (strcmp(*argv
, "netns") == 0) {
632 duparg("netns", *argv
);
633 netns
= netns_get_fd(*argv
);
635 addattr_l(&req
->n
, sizeof(*req
), IFLA_NET_NS_FD
,
637 else if (get_integer(&netns
, *argv
, 0) == 0)
638 addattr_l(&req
->n
, sizeof(*req
),
639 IFLA_NET_NS_PID
, &netns
, 4);
641 invarg("Invalid \"netns\" value\n", *argv
);
642 } else if (strcmp(*argv
, "multicast") == 0) {
644 req
->i
.ifi_change
|= IFF_MULTICAST
;
646 if (strcmp(*argv
, "on") == 0)
647 req
->i
.ifi_flags
|= IFF_MULTICAST
;
648 else if (strcmp(*argv
, "off") == 0)
649 req
->i
.ifi_flags
&= ~IFF_MULTICAST
;
651 return on_off("multicast", *argv
);
652 } else if (strcmp(*argv
, "allmulticast") == 0) {
654 req
->i
.ifi_change
|= IFF_ALLMULTI
;
656 if (strcmp(*argv
, "on") == 0)
657 req
->i
.ifi_flags
|= IFF_ALLMULTI
;
658 else if (strcmp(*argv
, "off") == 0)
659 req
->i
.ifi_flags
&= ~IFF_ALLMULTI
;
661 return on_off("allmulticast", *argv
);
662 } else if (strcmp(*argv
, "promisc") == 0) {
664 req
->i
.ifi_change
|= IFF_PROMISC
;
666 if (strcmp(*argv
, "on") == 0)
667 req
->i
.ifi_flags
|= IFF_PROMISC
;
668 else if (strcmp(*argv
, "off") == 0)
669 req
->i
.ifi_flags
&= ~IFF_PROMISC
;
671 return on_off("promisc", *argv
);
672 } else if (strcmp(*argv
, "trailers") == 0) {
674 req
->i
.ifi_change
|= IFF_NOTRAILERS
;
676 if (strcmp(*argv
, "off") == 0)
677 req
->i
.ifi_flags
|= IFF_NOTRAILERS
;
678 else if (strcmp(*argv
, "on") == 0)
679 req
->i
.ifi_flags
&= ~IFF_NOTRAILERS
;
681 return on_off("trailers", *argv
);
682 } else if (strcmp(*argv
, "arp") == 0) {
684 req
->i
.ifi_change
|= IFF_NOARP
;
686 if (strcmp(*argv
, "on") == 0)
687 req
->i
.ifi_flags
&= ~IFF_NOARP
;
688 else if (strcmp(*argv
, "off") == 0)
689 req
->i
.ifi_flags
|= IFF_NOARP
;
691 return on_off("arp", *argv
);
692 } else if (strcmp(*argv
, "carrier") == 0) {
696 if (strcmp(*argv
, "on") == 0)
698 else if (strcmp(*argv
, "off") == 0)
701 return on_off("carrier", *argv
);
703 addattr8(&req
->n
, sizeof(*req
), IFLA_CARRIER
, carrier
);
704 } else if (strcmp(*argv
, "vf") == 0) {
705 struct rtattr
*vflist
;
708 if (get_integer(&vf
, *argv
, 0))
709 invarg("Invalid \"vf\" value\n", *argv
);
711 vflist
= addattr_nest(&req
->n
, sizeof(*req
),
716 len
= iplink_parse_vf(vf
, &argc
, &argv
, req
, dev_index
);
719 addattr_nest_end(&req
->n
, vflist
);
720 } else if (matches(*argv
, "master") == 0) {
724 ifindex
= ll_name_to_index(*argv
);
726 invarg("Device does not exist\n", *argv
);
727 addattr_l(&req
->n
, sizeof(*req
), IFLA_MASTER
,
729 } else if (strcmp(*argv
, "vrf") == 0) {
733 ifindex
= ll_name_to_index(*argv
);
735 invarg("Not a valid VRF name\n", *argv
);
736 if (!name_is_vrf(*argv
))
737 invarg("Not a valid VRF name\n", *argv
);
738 addattr_l(&req
->n
, sizeof(*req
), IFLA_MASTER
,
739 &ifindex
, sizeof(ifindex
));
740 } else if (matches(*argv
, "nomaster") == 0) {
743 addattr_l(&req
->n
, sizeof(*req
), IFLA_MASTER
,
745 } else if (matches(*argv
, "dynamic") == 0) {
747 req
->i
.ifi_change
|= IFF_DYNAMIC
;
749 if (strcmp(*argv
, "on") == 0)
750 req
->i
.ifi_flags
|= IFF_DYNAMIC
;
751 else if (strcmp(*argv
, "off") == 0)
752 req
->i
.ifi_flags
&= ~IFF_DYNAMIC
;
754 return on_off("dynamic", *argv
);
755 } else if (matches(*argv
, "type") == 0) {
760 } else if (matches(*argv
, "alias") == 0) {
762 addattr_l(&req
->n
, sizeof(*req
), IFLA_IFALIAS
,
763 *argv
, strlen(*argv
));
766 } else if (strcmp(*argv
, "group") == 0) {
769 duparg("group", *argv
);
770 if (rtnl_group_a2n(group
, *argv
))
771 invarg("Invalid \"group\" value\n", *argv
);
772 } else if (strcmp(*argv
, "mode") == 0) {
776 mode
= get_link_mode(*argv
);
778 invarg("Invalid link mode\n", *argv
);
779 addattr8(&req
->n
, sizeof(*req
), IFLA_LINKMODE
, mode
);
780 } else if (strcmp(*argv
, "state") == 0) {
784 state
= get_operstate(*argv
);
786 invarg("Invalid operstate\n", *argv
);
788 addattr8(&req
->n
, sizeof(*req
), IFLA_OPERSTATE
, state
);
789 } else if (matches(*argv
, "numtxqueues") == 0) {
791 if (numtxqueues
!= -1)
792 duparg("numtxqueues", *argv
);
793 if (get_integer(&numtxqueues
, *argv
, 0))
794 invarg("Invalid \"numtxqueues\" value\n",
796 addattr_l(&req
->n
, sizeof(*req
), IFLA_NUM_TX_QUEUES
,
798 } else if (matches(*argv
, "numrxqueues") == 0) {
800 if (numrxqueues
!= -1)
801 duparg("numrxqueues", *argv
);
802 if (get_integer(&numrxqueues
, *argv
, 0))
803 invarg("Invalid \"numrxqueues\" value\n",
805 addattr_l(&req
->n
, sizeof(*req
), IFLA_NUM_RX_QUEUES
,
807 } else if (matches(*argv
, "addrgenmode") == 0) {
808 struct rtattr
*afs
, *afs6
;
812 mode
= get_addr_gen_mode(*argv
);
814 invarg("Invalid address generation mode\n",
816 afs
= addattr_nest(&req
->n
, sizeof(*req
), IFLA_AF_SPEC
);
817 afs6
= addattr_nest(&req
->n
, sizeof(*req
), AF_INET6
);
818 addattr8(&req
->n
, sizeof(*req
),
819 IFLA_INET6_ADDR_GEN_MODE
, mode
);
820 addattr_nest_end(&req
->n
, afs6
);
821 addattr_nest_end(&req
->n
, afs
);
822 } else if (matches(*argv
, "link-netnsid") == 0) {
824 if (link_netnsid
!= -1)
825 duparg("link-netnsid", *argv
);
826 if (get_integer(&link_netnsid
, *argv
, 0))
827 invarg("Invalid \"link-netnsid\" value\n",
829 addattr32(&req
->n
, sizeof(*req
), IFLA_LINK_NETNSID
,
831 } else if (strcmp(*argv
, "protodown") == 0) {
832 unsigned int proto_down
;
835 if (strcmp(*argv
, "on") == 0)
837 else if (strcmp(*argv
, "off") == 0)
840 return on_off("protodown", *argv
);
841 addattr8(&req
->n
, sizeof(*req
), IFLA_PROTO_DOWN
,
844 if (matches(*argv
, "help") == 0)
847 if (strcmp(*argv
, "dev") == 0)
850 duparg2("dev", *argv
);
852 dev_index
= ll_name_to_index(*dev
);
857 if (dev_index
&& addr_len
) {
858 int halen
= nl_get_ll_addr_len(dev_index
);
860 if (halen
>= 0 && halen
!= addr_len
) {
862 "Invalid address length %d - must be %d bytes\n",
871 static int iplink_modify(int cmd
, unsigned int flags
, int argc
, char **argv
)
880 struct link_util
*lu
= NULL
;
881 struct iplink_req req
= {
882 .n
.nlmsg_len
= NLMSG_LENGTH(sizeof(struct ifinfomsg
)),
883 .n
.nlmsg_flags
= NLM_F_REQUEST
| flags
,
885 .i
.ifi_family
= preferred_family
,
889 ret
= iplink_parse(argc
, argv
,
890 &req
, &name
, &type
, &link
, &dev
, &group
, &index
);
899 addattr_l(&req
.n
, sizeof(req
), IFLA_GROUP
,
900 &group
, sizeof(group
));
904 "Garbage instead of arguments \"%s ...\". Try \"ip link help\".\n",
908 if (flags
& NLM_F_CREATE
) {
910 "group cannot be used when creating devices.\n");
915 addattr32(&req
.n
, sizeof(req
), IFLA_GROUP
, group
);
916 if (rtnl_talk(&rth
, &req
.n
, NULL
, 0) < 0)
922 if (!(flags
& NLM_F_CREATE
)) {
925 "Not enough information: \"dev\" argument is required.\n");
928 if (cmd
== RTM_NEWLINK
&& index
!= -1) {
930 "index can be used only when creating devices.\n");
934 req
.i
.ifi_index
= ll_name_to_index(dev
);
935 if (req
.i
.ifi_index
== 0) {
936 fprintf(stderr
, "Cannot find device \"%s\"\n", dev
);
940 /* Allow "ip link add dev" and "ip link add name" */
947 ifindex
= ll_name_to_index(link
);
949 fprintf(stderr
, "Cannot find device \"%s\"\n",
953 addattr_l(&req
.n
, sizeof(req
), IFLA_LINK
, &ifindex
, 4);
959 req
.i
.ifi_index
= index
;
963 len
= strlen(name
) + 1;
965 invarg("\"\" is not a valid device identifier\n",
968 invarg("\"name\" too long\n", name
);
969 addattr_l(&req
.n
, sizeof(req
), IFLA_IFNAME
, name
, len
);
973 struct rtattr
*linkinfo
;
974 char *ulinep
= strchr(type
, '_');
977 linkinfo
= addattr_nest(&req
.n
, sizeof(req
), IFLA_LINKINFO
);
978 addattr_l(&req
.n
, sizeof(req
), IFLA_INFO_KIND
, type
,
981 lu
= get_link_kind(type
);
982 if (ulinep
&& !strcmp(ulinep
, "_slave"))
983 iflatype
= IFLA_INFO_SLAVE_DATA
;
985 iflatype
= IFLA_INFO_DATA
;
988 = addattr_nest(&req
.n
,
989 sizeof(req
), iflatype
);
992 lu
->parse_opt(lu
, argc
, argv
, &req
.n
))
995 addattr_nest_end(&req
.n
, data
);
997 if (matches(*argv
, "help") == 0)
1000 "Garbage instead of arguments \"%s ...\". Try \"ip link help\".\n",
1004 addattr_nest_end(&req
.n
, linkinfo
);
1005 } else if (flags
& NLM_F_CREATE
) {
1007 "Not enough information: \"type\" argument is required\n");
1011 if (rtnl_talk(&rth
, &req
.n
, NULL
, 0) < 0)
1017 int iplink_get(unsigned int flags
, char *name
, __u32 filt_mask
)
1020 struct iplink_req req
= {
1021 .n
.nlmsg_len
= NLMSG_LENGTH(sizeof(struct ifinfomsg
)),
1022 .n
.nlmsg_flags
= NLM_F_REQUEST
| flags
,
1023 .n
.nlmsg_type
= RTM_GETLINK
,
1024 .i
.ifi_family
= preferred_family
,
1032 len
= strlen(name
) + 1;
1034 invarg("\"\" is not a valid device identifier\n",
1037 invarg("\"name\" too long\n", name
);
1038 addattr_l(&req
.n
, sizeof(req
), IFLA_IFNAME
, name
, len
);
1040 addattr32(&req
.n
, sizeof(req
), IFLA_EXT_MASK
, filt_mask
);
1042 if (rtnl_talk(&rth
, &req
.n
, &answer
.n
, sizeof(answer
)) < 0)
1045 open_json_object(NULL
);
1047 print_linkinfo_brief(NULL
, &answer
.n
, stdout
, NULL
);
1049 print_linkinfo(NULL
, &answer
.n
, stdout
);
1050 close_json_object();
1055 #if IPLINK_IOCTL_COMPAT
1056 static int get_ctl_fd(void)
1061 fd
= socket(PF_INET
, SOCK_DGRAM
, 0);
1065 fd
= socket(PF_PACKET
, SOCK_DGRAM
, 0);
1068 fd
= socket(PF_INET6
, SOCK_DGRAM
, 0);
1072 perror("Cannot create control socket");
1076 static int do_chflags(const char *dev
, __u32 flags
, __u32 mask
)
1082 strncpy(ifr
.ifr_name
, dev
, IFNAMSIZ
);
1086 err
= ioctl(fd
, SIOCGIFFLAGS
, &ifr
);
1088 perror("SIOCGIFFLAGS");
1092 if ((ifr
.ifr_flags
^flags
)&mask
) {
1093 ifr
.ifr_flags
&= ~mask
;
1094 ifr
.ifr_flags
|= mask
&flags
;
1095 err
= ioctl(fd
, SIOCSIFFLAGS
, &ifr
);
1097 perror("SIOCSIFFLAGS");
1103 static int do_changename(const char *dev
, const char *newdev
)
1109 strncpy(ifr
.ifr_name
, dev
, IFNAMSIZ
);
1110 strncpy(ifr
.ifr_newname
, newdev
, IFNAMSIZ
);
1114 err
= ioctl(fd
, SIOCSIFNAME
, &ifr
);
1116 perror("SIOCSIFNAME");
1124 static int set_qlen(const char *dev
, int qlen
)
1126 struct ifreq ifr
= { .ifr_qlen
= qlen
};
1133 strncpy(ifr
.ifr_name
, dev
, IFNAMSIZ
);
1134 if (ioctl(s
, SIOCSIFTXQLEN
, &ifr
) < 0) {
1135 perror("SIOCSIFXQLEN");
1144 static int set_mtu(const char *dev
, int mtu
)
1146 struct ifreq ifr
= { .ifr_mtu
= mtu
};
1153 strncpy(ifr
.ifr_name
, dev
, IFNAMSIZ
);
1154 if (ioctl(s
, SIOCSIFMTU
, &ifr
) < 0) {
1155 perror("SIOCSIFMTU");
1164 static int get_address(const char *dev
, int *htype
)
1166 struct ifreq ifr
= {};
1167 struct sockaddr_ll me
= {
1168 .sll_family
= AF_PACKET
,
1169 .sll_protocol
= htons(ETH_P_LOOP
),
1174 s
= socket(PF_PACKET
, SOCK_DGRAM
, 0);
1176 perror("socket(PF_PACKET)");
1180 strncpy(ifr
.ifr_name
, dev
, IFNAMSIZ
);
1181 if (ioctl(s
, SIOCGIFINDEX
, &ifr
) < 0) {
1182 perror("SIOCGIFINDEX");
1187 me
.sll_ifindex
= ifr
.ifr_ifindex
;
1188 if (bind(s
, (struct sockaddr
*)&me
, sizeof(me
)) == -1) {
1195 if (getsockname(s
, (struct sockaddr
*)&me
, &alen
) == -1) {
1196 perror("getsockname");
1201 *htype
= me
.sll_hatype
;
1202 return me
.sll_halen
;
1205 static int parse_address(const char *dev
, int hatype
, int halen
,
1206 char *lla
, struct ifreq
*ifr
)
1210 memset(ifr
, 0, sizeof(*ifr
));
1211 strncpy(ifr
->ifr_name
, dev
, IFNAMSIZ
);
1212 ifr
->ifr_hwaddr
.sa_family
= hatype
;
1213 alen
= ll_addr_a2n(ifr
->ifr_hwaddr
.sa_data
, 14, lla
);
1216 if (alen
!= halen
) {
1218 "Wrong address (%s) length: expected %d bytes\n",
1225 static int set_address(struct ifreq
*ifr
, int brd
)
1232 if (ioctl(s
, brd
?SIOCSIFHWBROADCAST
:SIOCSIFHWADDR
, ifr
) < 0) {
1233 perror(brd
?"SIOCSIFHWBROADCAST":"SIOCSIFHWADDR");
1241 static int do_set(int argc
, char **argv
)
1248 char *newaddr
= NULL
;
1249 char *newbrd
= NULL
;
1250 struct ifreq ifr0
, ifr1
;
1251 char *newname
= NULL
;
1255 if (strcmp(*argv
, "up") == 0) {
1258 } else if (strcmp(*argv
, "down") == 0) {
1261 } else if (strcmp(*argv
, "name") == 0) {
1264 } else if (matches(*argv
, "address") == 0) {
1267 } else if (matches(*argv
, "broadcast") == 0 ||
1268 strcmp(*argv
, "brd") == 0) {
1271 } else if (matches(*argv
, "txqueuelen") == 0 ||
1272 strcmp(*argv
, "qlen") == 0 ||
1273 matches(*argv
, "txqlen") == 0) {
1276 duparg("txqueuelen", *argv
);
1277 if (get_integer(&qlen
, *argv
, 0))
1278 invarg("Invalid \"txqueuelen\" value\n", *argv
);
1279 } else if (strcmp(*argv
, "mtu") == 0) {
1282 duparg("mtu", *argv
);
1283 if (get_integer(&mtu
, *argv
, 0))
1284 invarg("Invalid \"mtu\" value\n", *argv
);
1285 } else if (strcmp(*argv
, "multicast") == 0) {
1287 mask
|= IFF_MULTICAST
;
1289 if (strcmp(*argv
, "on") == 0)
1290 flags
|= IFF_MULTICAST
;
1291 else if (strcmp(*argv
, "off") == 0)
1292 flags
&= ~IFF_MULTICAST
;
1294 return on_off("multicast", *argv
);
1295 } else if (strcmp(*argv
, "allmulticast") == 0) {
1297 mask
|= IFF_ALLMULTI
;
1299 if (strcmp(*argv
, "on") == 0)
1300 flags
|= IFF_ALLMULTI
;
1301 else if (strcmp(*argv
, "off") == 0)
1302 flags
&= ~IFF_ALLMULTI
;
1304 return on_off("allmulticast", *argv
);
1305 } else if (strcmp(*argv
, "promisc") == 0) {
1307 mask
|= IFF_PROMISC
;
1309 if (strcmp(*argv
, "on") == 0)
1310 flags
|= IFF_PROMISC
;
1311 else if (strcmp(*argv
, "off") == 0)
1312 flags
&= ~IFF_PROMISC
;
1314 return on_off("promisc", *argv
);
1315 } else if (strcmp(*argv
, "trailers") == 0) {
1317 mask
|= IFF_NOTRAILERS
;
1319 if (strcmp(*argv
, "off") == 0)
1320 flags
|= IFF_NOTRAILERS
;
1321 else if (strcmp(*argv
, "on") == 0)
1322 flags
&= ~IFF_NOTRAILERS
;
1324 return on_off("trailers", *argv
);
1325 } else if (strcmp(*argv
, "arp") == 0) {
1329 if (strcmp(*argv
, "on") == 0)
1330 flags
&= ~IFF_NOARP
;
1331 else if (strcmp(*argv
, "off") == 0)
1334 return on_off("arp", *argv
);
1335 } else if (matches(*argv
, "dynamic") == 0) {
1337 mask
|= IFF_DYNAMIC
;
1339 if (strcmp(*argv
, "on") == 0)
1340 flags
|= IFF_DYNAMIC
;
1341 else if (strcmp(*argv
, "off") == 0)
1342 flags
&= ~IFF_DYNAMIC
;
1344 return on_off("dynamic", *argv
);
1346 if (strcmp(*argv
, "dev") == 0)
1348 else if (matches(*argv
, "help") == 0)
1352 duparg2("dev", *argv
);
1360 "Not enough of information: \"dev\" argument is required.\n");
1364 if (newaddr
|| newbrd
) {
1365 halen
= get_address(dev
, &htype
);
1369 if (parse_address(dev
, htype
, halen
,
1370 newaddr
, &ifr0
) < 0)
1374 if (parse_address(dev
, htype
, halen
,
1380 if (newname
&& strcmp(dev
, newname
)) {
1381 if (strlen(newname
) == 0)
1382 invarg("\"\" is not a valid device identifier\n",
1384 if (do_changename(dev
, newname
) < 0)
1389 if (set_qlen(dev
, qlen
) < 0)
1393 if (set_mtu(dev
, mtu
) < 0)
1396 if (newaddr
|| newbrd
) {
1398 if (set_address(&ifr1
, 1) < 0)
1402 if (set_address(&ifr0
, 0) < 0)
1407 return do_chflags(dev
, flags
, mask
);
1410 #endif /* IPLINK_IOCTL_COMPAT */
1412 static void print_mpls_stats(FILE *fp
, struct rtattr
*attr
)
1414 struct rtattr
*mrtb
[MPLS_STATS_MAX
+1];
1415 struct mpls_link_stats
*stats
;
1417 parse_rtattr(mrtb
, MPLS_STATS_MAX
, RTA_DATA(attr
),
1419 if (!mrtb
[MPLS_STATS_LINK
])
1422 stats
= RTA_DATA(mrtb
[MPLS_STATS_LINK
]);
1424 fprintf(fp
, " mpls:\n");
1425 fprintf(fp
, " RX: bytes packets errors dropped noroute\n");
1427 print_num(fp
, 10, stats
->rx_bytes
);
1428 print_num(fp
, 8, stats
->rx_packets
);
1429 print_num(fp
, 7, stats
->rx_errors
);
1430 print_num(fp
, 8, stats
->rx_dropped
);
1431 print_num(fp
, 7, stats
->rx_noroute
);
1433 fprintf(fp
, " TX: bytes packets errors dropped\n");
1435 print_num(fp
, 10, stats
->tx_bytes
);
1436 print_num(fp
, 8, stats
->tx_packets
);
1437 print_num(fp
, 7, stats
->tx_errors
);
1438 print_num(fp
, 7, stats
->tx_dropped
);
1442 static void print_af_stats_attr(FILE *fp
, int ifindex
, struct rtattr
*attr
)
1444 bool if_printed
= false;
1448 rem
= RTA_PAYLOAD(attr
);
1449 for (i
= RTA_DATA(attr
); RTA_OK(i
, rem
); i
= RTA_NEXT(i
, rem
)) {
1450 if (preferred_family
!= AF_UNSPEC
&&
1451 i
->rta_type
!= preferred_family
)
1455 fprintf(fp
, "%u: %s\n", ifindex
,
1456 ll_index_to_name(ifindex
));
1460 switch (i
->rta_type
) {
1462 print_mpls_stats(fp
, i
);
1465 fprintf(fp
, " unknown af(%d)\n", i
->rta_type
);
1471 struct af_stats_ctx
{
1476 static int print_af_stats(const struct sockaddr_nl
*who
,
1480 struct if_stats_msg
*ifsm
= NLMSG_DATA(n
);
1481 struct rtattr
*tb
[IFLA_STATS_MAX
+1];
1482 int len
= n
->nlmsg_len
;
1483 struct af_stats_ctx
*ctx
= arg
;
1486 len
-= NLMSG_LENGTH(sizeof(*ifsm
));
1488 fprintf(stderr
, "BUG: wrong nlmsg len %d\n", len
);
1492 if (ctx
->ifindex
&& ifsm
->ifindex
!= ctx
->ifindex
)
1495 parse_rtattr(tb
, IFLA_STATS_MAX
, IFLA_STATS_RTA(ifsm
), len
);
1497 if (tb
[IFLA_STATS_AF_SPEC
])
1498 print_af_stats_attr(fp
, ifsm
->ifindex
, tb
[IFLA_STATS_AF_SPEC
]);
1504 static int iplink_afstats(int argc
, char **argv
)
1506 __u32 filt_mask
= IFLA_STATS_FILTER_BIT(IFLA_STATS_AF_SPEC
);
1507 const char *filter_dev
= NULL
;
1508 struct af_stats_ctx ctx
= {
1514 if (strcmp(*argv
, "dev") == 0) {
1517 duparg2("dev", *argv
);
1519 } else if (matches(*argv
, "help") == 0) {
1523 "Command \"%s\" is unknown, try \"ip link help\".\n",
1532 ctx
.ifindex
= ll_name_to_index(filter_dev
);
1533 if (ctx
.ifindex
<= 0) {
1535 "Device \"%s\" does not exist.\n",
1541 if (rtnl_wilddump_stats_req_filter(&rth
, AF_UNSPEC
,
1544 perror("Cannont send dump request");
1548 if (rtnl_dump_filter(&rth
, print_af_stats
, &ctx
) < 0) {
1549 fprintf(stderr
, "Dump terminated\n");
1556 static void do_help(int argc
, char **argv
)
1558 struct link_util
*lu
= NULL
;
1565 lu
= get_link_kind(*argv
);
1566 if (lu
&& lu
->print_help
)
1567 lu
->print_help(lu
, argc
-1, argv
+1, stdout
);
1572 int do_iplink(int argc
, char **argv
)
1575 return ipaddr_list_link(0, NULL
);
1577 if (iplink_have_newlink()) {
1578 if (matches(*argv
, "add") == 0)
1579 return iplink_modify(RTM_NEWLINK
,
1580 NLM_F_CREATE
|NLM_F_EXCL
,
1582 if (matches(*argv
, "set") == 0 ||
1583 matches(*argv
, "change") == 0)
1584 return iplink_modify(RTM_NEWLINK
, 0,
1586 if (matches(*argv
, "replace") == 0)
1587 return iplink_modify(RTM_NEWLINK
,
1588 NLM_F_CREATE
|NLM_F_REPLACE
,
1590 if (matches(*argv
, "delete") == 0)
1591 return iplink_modify(RTM_DELLINK
, 0,
1594 #if IPLINK_IOCTL_COMPAT
1595 if (matches(*argv
, "set") == 0)
1596 return do_set(argc
-1, argv
+1);
1600 if (matches(*argv
, "show") == 0 ||
1601 matches(*argv
, "lst") == 0 ||
1602 matches(*argv
, "list") == 0)
1603 return ipaddr_list_link(argc
-1, argv
+1);
1605 if (matches(*argv
, "xstats") == 0)
1606 return iplink_ifla_xstats(argc
-1, argv
+1);
1608 if (matches(*argv
, "afstats") == 0) {
1609 iplink_afstats(argc
-1, argv
+1);
1613 if (matches(*argv
, "help") == 0) {
1614 do_help(argc
-1, argv
+1);
1618 fprintf(stderr
, "Command \"%s\" is unknown, try \"ip link help\".\n",