2 * iplink_bond.c Bonding device support
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: Jiri Pirko <jiri@resnulli.us>
10 * Scott Feldman <sfeldma@cumulusnetworks.com>
16 #include <linux/if_link.h>
17 #include <linux/if_ether.h>
22 #include "ip_common.h"
24 #define BOND_MAX_ARP_TARGETS 16
26 static const char *mode_tbl
[] = {
37 static const char *arp_validate_tbl
[] = {
45 static const char *arp_all_targets_tbl
[] = {
51 static const char *primary_reselect_tbl
[] = {
58 static const char *fail_over_mac_tbl
[] = {
65 static const char *xmit_hash_policy_tbl
[] = {
74 static const char *lacp_rate_tbl
[] = {
80 static const char *ad_select_tbl
[] = {
87 static const char *get_name(const char **tbl
, int index
)
91 for (i
= 0; tbl
[i
]; i
++)
98 static int get_index(const char **tbl
, char *name
)
102 /* check for integer index passed in instead of name */
103 if (get_integer(&index
, name
, 10) == 0)
104 for (i
= 0; tbl
[i
]; i
++)
108 for (i
= 0; tbl
[i
]; i
++)
109 if (strcmp(tbl
[i
], name
) == 0)
115 static void print_explain(FILE *f
)
118 "Usage: ... bond [ mode BONDMODE ] [ active_slave SLAVE_DEV ]\n"
119 " [ clear_active_slave ] [ miimon MIIMON ]\n"
120 " [ updelay UPDELAY ] [ downdelay DOWNDELAY ]\n"
121 " [ use_carrier USE_CARRIER ]\n"
122 " [ arp_interval ARP_INTERVAL ]\n"
123 " [ arp_validate ARP_VALIDATE ]\n"
124 " [ arp_all_targets ARP_ALL_TARGETS ]\n"
125 " [ arp_ip_target [ ARP_IP_TARGET, ... ] ]\n"
126 " [ primary SLAVE_DEV ]\n"
127 " [ primary_reselect PRIMARY_RESELECT ]\n"
128 " [ fail_over_mac FAIL_OVER_MAC ]\n"
129 " [ xmit_hash_policy XMIT_HASH_POLICY ]\n"
130 " [ resend_igmp RESEND_IGMP ]\n"
131 " [ num_grat_arp|num_unsol_na NUM_GRAT_ARP|NUM_UNSOL_NA ]\n"
132 " [ all_slaves_active ALL_SLAVES_ACTIVE ]\n"
133 " [ min_links MIN_LINKS ]\n"
134 " [ lp_interval LP_INTERVAL ]\n"
135 " [ packets_per_slave PACKETS_PER_SLAVE ]\n"
136 " [ tlb_dynamic_lb TLB_DYNAMIC_LB ]\n"
137 " [ lacp_rate LACP_RATE ]\n"
138 " [ ad_select AD_SELECT ]\n"
139 " [ ad_user_port_key PORTKEY ]\n"
140 " [ ad_actor_sys_prio SYSPRIO ]\n"
141 " [ ad_actor_system LLADDR ]\n"
143 "BONDMODE := balance-rr|active-backup|balance-xor|broadcast|802.3ad|balance-tlb|balance-alb\n"
144 "ARP_VALIDATE := none|active|backup|all\n"
145 "ARP_ALL_TARGETS := any|all\n"
146 "PRIMARY_RESELECT := always|better|failure\n"
147 "FAIL_OVER_MAC := none|active|follow\n"
148 "XMIT_HASH_POLICY := layer2|layer2+3|layer3+4|encap2+3|encap3+4\n"
149 "LACP_RATE := slow|fast\n"
150 "AD_SELECT := stable|bandwidth|count\n"
154 static void explain(void)
156 print_explain(stderr
);
159 static int bond_parse_opt(struct link_util
*lu
, int argc
, char **argv
,
162 __u8 mode
, use_carrier
, primary_reselect
, fail_over_mac
;
163 __u8 xmit_hash_policy
, num_peer_notif
, all_slaves_active
;
164 __u8 lacp_rate
, ad_select
, tlb_dynamic_lb
;
165 __u16 ad_user_port_key
, ad_actor_sys_prio
;
166 __u32 miimon
, updelay
, downdelay
, arp_interval
, arp_validate
;
167 __u32 arp_all_targets
, resend_igmp
, min_links
, lp_interval
;
168 __u32 packets_per_slave
;
169 unsigned int ifindex
;
172 if (matches(*argv
, "mode") == 0) {
174 if (get_index(mode_tbl
, *argv
) < 0)
175 invarg("invalid mode", *argv
);
176 mode
= get_index(mode_tbl
, *argv
);
177 addattr8(n
, 1024, IFLA_BOND_MODE
, mode
);
178 } else if (matches(*argv
, "active_slave") == 0) {
180 ifindex
= if_nametoindex(*argv
);
183 addattr32(n
, 1024, IFLA_BOND_ACTIVE_SLAVE
, ifindex
);
184 } else if (matches(*argv
, "clear_active_slave") == 0) {
185 addattr32(n
, 1024, IFLA_BOND_ACTIVE_SLAVE
, 0);
186 } else if (matches(*argv
, "miimon") == 0) {
188 if (get_u32(&miimon
, *argv
, 0))
189 invarg("invalid miimon", *argv
);
190 addattr32(n
, 1024, IFLA_BOND_MIIMON
, miimon
);
191 } else if (matches(*argv
, "updelay") == 0) {
193 if (get_u32(&updelay
, *argv
, 0))
194 invarg("invalid updelay", *argv
);
195 addattr32(n
, 1024, IFLA_BOND_UPDELAY
, updelay
);
196 } else if (matches(*argv
, "downdelay") == 0) {
198 if (get_u32(&downdelay
, *argv
, 0))
199 invarg("invalid downdelay", *argv
);
200 addattr32(n
, 1024, IFLA_BOND_DOWNDELAY
, downdelay
);
201 } else if (matches(*argv
, "use_carrier") == 0) {
203 if (get_u8(&use_carrier
, *argv
, 0))
204 invarg("invalid use_carrier", *argv
);
205 addattr8(n
, 1024, IFLA_BOND_USE_CARRIER
, use_carrier
);
206 } else if (matches(*argv
, "arp_interval") == 0) {
208 if (get_u32(&arp_interval
, *argv
, 0))
209 invarg("invalid arp_interval", *argv
);
210 addattr32(n
, 1024, IFLA_BOND_ARP_INTERVAL
, arp_interval
);
211 } else if (matches(*argv
, "arp_ip_target") == 0) {
212 struct rtattr
*nest
= addattr_nest(n
, 1024,
213 IFLA_BOND_ARP_IP_TARGET
);
216 char *targets
= strdupa(*argv
);
217 char *target
= strtok(targets
, ",");
220 for (i
= 0; target
&& i
< BOND_MAX_ARP_TARGETS
; i
++) {
221 __u32 addr
= get_addr32(target
);
223 addattr32(n
, 1024, i
, addr
);
224 target
= strtok(NULL
, ",");
226 addattr_nest_end(n
, nest
);
228 addattr_nest_end(n
, nest
);
229 } else if (matches(*argv
, "arp_validate") == 0) {
231 if (get_index(arp_validate_tbl
, *argv
) < 0)
232 invarg("invalid arp_validate", *argv
);
233 arp_validate
= get_index(arp_validate_tbl
, *argv
);
234 addattr32(n
, 1024, IFLA_BOND_ARP_VALIDATE
, arp_validate
);
235 } else if (matches(*argv
, "arp_all_targets") == 0) {
237 if (get_index(arp_all_targets_tbl
, *argv
) < 0)
238 invarg("invalid arp_all_targets", *argv
);
239 arp_all_targets
= get_index(arp_all_targets_tbl
, *argv
);
240 addattr32(n
, 1024, IFLA_BOND_ARP_ALL_TARGETS
, arp_all_targets
);
241 } else if (matches(*argv
, "primary") == 0) {
243 ifindex
= if_nametoindex(*argv
);
246 addattr32(n
, 1024, IFLA_BOND_PRIMARY
, ifindex
);
247 } else if (matches(*argv
, "primary_reselect") == 0) {
249 if (get_index(primary_reselect_tbl
, *argv
) < 0)
250 invarg("invalid primary_reselect", *argv
);
251 primary_reselect
= get_index(primary_reselect_tbl
, *argv
);
252 addattr8(n
, 1024, IFLA_BOND_PRIMARY_RESELECT
,
254 } else if (matches(*argv
, "fail_over_mac") == 0) {
256 if (get_index(fail_over_mac_tbl
, *argv
) < 0)
257 invarg("invalid fail_over_mac", *argv
);
258 fail_over_mac
= get_index(fail_over_mac_tbl
, *argv
);
259 addattr8(n
, 1024, IFLA_BOND_FAIL_OVER_MAC
,
261 } else if (matches(*argv
, "xmit_hash_policy") == 0) {
263 if (get_index(xmit_hash_policy_tbl
, *argv
) < 0)
264 invarg("invalid xmit_hash_policy", *argv
);
266 xmit_hash_policy
= get_index(xmit_hash_policy_tbl
, *argv
);
267 addattr8(n
, 1024, IFLA_BOND_XMIT_HASH_POLICY
,
269 } else if (matches(*argv
, "resend_igmp") == 0) {
271 if (get_u32(&resend_igmp
, *argv
, 0))
272 invarg("invalid resend_igmp", *argv
);
274 addattr32(n
, 1024, IFLA_BOND_RESEND_IGMP
, resend_igmp
);
275 } else if (matches(*argv
, "num_grat_arp") == 0 ||
276 matches(*argv
, "num_unsol_na") == 0) {
278 if (get_u8(&num_peer_notif
, *argv
, 0))
279 invarg("invalid num_grat_arp|num_unsol_na",
282 addattr8(n
, 1024, IFLA_BOND_NUM_PEER_NOTIF
,
284 } else if (matches(*argv
, "all_slaves_active") == 0) {
286 if (get_u8(&all_slaves_active
, *argv
, 0))
287 invarg("invalid all_slaves_active", *argv
);
289 addattr8(n
, 1024, IFLA_BOND_ALL_SLAVES_ACTIVE
,
291 } else if (matches(*argv
, "min_links") == 0) {
293 if (get_u32(&min_links
, *argv
, 0))
294 invarg("invalid min_links", *argv
);
296 addattr32(n
, 1024, IFLA_BOND_MIN_LINKS
, min_links
);
297 } else if (matches(*argv
, "lp_interval") == 0) {
299 if (get_u32(&lp_interval
, *argv
, 0))
300 invarg("invalid lp_interval", *argv
);
302 addattr32(n
, 1024, IFLA_BOND_LP_INTERVAL
, lp_interval
);
303 } else if (matches(*argv
, "packets_per_slave") == 0) {
305 if (get_u32(&packets_per_slave
, *argv
, 0))
306 invarg("invalid packets_per_slave", *argv
);
308 addattr32(n
, 1024, IFLA_BOND_PACKETS_PER_SLAVE
,
310 } else if (matches(*argv
, "lacp_rate") == 0) {
312 if (get_index(lacp_rate_tbl
, *argv
) < 0)
313 invarg("invalid lacp_rate", *argv
);
315 lacp_rate
= get_index(lacp_rate_tbl
, *argv
);
316 addattr8(n
, 1024, IFLA_BOND_AD_LACP_RATE
, lacp_rate
);
317 } else if (matches(*argv
, "ad_select") == 0) {
319 if (get_index(ad_select_tbl
, *argv
) < 0)
320 invarg("invalid ad_select", *argv
);
322 ad_select
= get_index(ad_select_tbl
, *argv
);
323 addattr8(n
, 1024, IFLA_BOND_AD_SELECT
, ad_select
);
324 } else if (matches(*argv
, "ad_user_port_key") == 0) {
326 if (get_u16(&ad_user_port_key
, *argv
, 0))
327 invarg("invalid ad_user_port_key", *argv
);
329 addattr16(n
, 1024, IFLA_BOND_AD_USER_PORT_KEY
,
331 } else if (matches(*argv
, "ad_actor_sys_prio") == 0) {
333 if (get_u16(&ad_actor_sys_prio
, *argv
, 0))
334 invarg("invalid ad_actor_sys_prio", *argv
);
336 addattr16(n
, 1024, IFLA_BOND_AD_ACTOR_SYS_PRIO
,
338 } else if (matches(*argv
, "ad_actor_system") == 0) {
343 len
= ll_addr_a2n(abuf
, sizeof(abuf
), *argv
);
346 addattr_l(n
, 1024, IFLA_BOND_AD_ACTOR_SYSTEM
,
348 } else if (matches(*argv
, "tlb_dynamic_lb") == 0) {
350 if (get_u8(&tlb_dynamic_lb
, *argv
, 0)) {
351 invarg("invalid tlb_dynamic_lb", *argv
);
354 addattr8(n
, 1024, IFLA_BOND_TLB_DYNAMIC_LB
,
356 } else if (matches(*argv
, "help") == 0) {
360 fprintf(stderr
, "bond: unknown command \"%s\"?\n", *argv
);
370 static void bond_print_opt(struct link_util
*lu
, FILE *f
, struct rtattr
*tb
[])
372 unsigned int ifindex
;
377 if (tb
[IFLA_BOND_MODE
]) {
378 const char *mode
= get_name(mode_tbl
,
379 rta_getattr_u8(tb
[IFLA_BOND_MODE
]));
380 fprintf(f
, "mode %s ", mode
);
383 if (tb
[IFLA_BOND_ACTIVE_SLAVE
] &&
384 (ifindex
= rta_getattr_u32(tb
[IFLA_BOND_ACTIVE_SLAVE
]))) {
386 const char *n
= if_indextoname(ifindex
, buf
);
389 fprintf(f
, "active_slave %s ", n
);
391 fprintf(f
, "active_slave %u ", ifindex
);
394 if (tb
[IFLA_BOND_MIIMON
])
395 fprintf(f
, "miimon %u ", rta_getattr_u32(tb
[IFLA_BOND_MIIMON
]));
397 if (tb
[IFLA_BOND_UPDELAY
])
398 fprintf(f
, "updelay %u ", rta_getattr_u32(tb
[IFLA_BOND_UPDELAY
]));
400 if (tb
[IFLA_BOND_DOWNDELAY
])
401 fprintf(f
, "downdelay %u ",
402 rta_getattr_u32(tb
[IFLA_BOND_DOWNDELAY
]));
404 if (tb
[IFLA_BOND_USE_CARRIER
])
405 fprintf(f
, "use_carrier %u ",
406 rta_getattr_u8(tb
[IFLA_BOND_USE_CARRIER
]));
408 if (tb
[IFLA_BOND_ARP_INTERVAL
])
409 fprintf(f
, "arp_interval %u ",
410 rta_getattr_u32(tb
[IFLA_BOND_ARP_INTERVAL
]));
412 if (tb
[IFLA_BOND_ARP_IP_TARGET
]) {
413 struct rtattr
*iptb
[BOND_MAX_ARP_TARGETS
+ 1];
414 char buf
[INET_ADDRSTRLEN
];
417 parse_rtattr_nested(iptb
, BOND_MAX_ARP_TARGETS
,
418 tb
[IFLA_BOND_ARP_IP_TARGET
]);
421 fprintf(f
, "arp_ip_target ");
423 for (i
= 0; i
< BOND_MAX_ARP_TARGETS
; i
++) {
427 RTA_PAYLOAD(iptb
[i
]),
431 if (i
< BOND_MAX_ARP_TARGETS
-1 && iptb
[i
+1])
439 if (tb
[IFLA_BOND_ARP_VALIDATE
]) {
440 const char *arp_validate
= get_name(arp_validate_tbl
,
441 rta_getattr_u32(tb
[IFLA_BOND_ARP_VALIDATE
]));
442 fprintf(f
, "arp_validate %s ", arp_validate
);
445 if (tb
[IFLA_BOND_ARP_ALL_TARGETS
]) {
446 const char *arp_all_targets
= get_name(arp_all_targets_tbl
,
447 rta_getattr_u32(tb
[IFLA_BOND_ARP_ALL_TARGETS
]));
448 fprintf(f
, "arp_all_targets %s ", arp_all_targets
);
451 if (tb
[IFLA_BOND_PRIMARY
] &&
452 (ifindex
= rta_getattr_u32(tb
[IFLA_BOND_PRIMARY
]))) {
454 const char *n
= if_indextoname(ifindex
, buf
);
457 fprintf(f
, "primary %s ", n
);
459 fprintf(f
, "primary %u ", ifindex
);
462 if (tb
[IFLA_BOND_PRIMARY_RESELECT
]) {
463 const char *primary_reselect
= get_name(primary_reselect_tbl
,
464 rta_getattr_u8(tb
[IFLA_BOND_PRIMARY_RESELECT
]));
465 fprintf(f
, "primary_reselect %s ", primary_reselect
);
468 if (tb
[IFLA_BOND_FAIL_OVER_MAC
]) {
469 const char *fail_over_mac
= get_name(fail_over_mac_tbl
,
470 rta_getattr_u8(tb
[IFLA_BOND_FAIL_OVER_MAC
]));
471 fprintf(f
, "fail_over_mac %s ", fail_over_mac
);
474 if (tb
[IFLA_BOND_XMIT_HASH_POLICY
]) {
475 const char *xmit_hash_policy
= get_name(xmit_hash_policy_tbl
,
476 rta_getattr_u8(tb
[IFLA_BOND_XMIT_HASH_POLICY
]));
477 fprintf(f
, "xmit_hash_policy %s ", xmit_hash_policy
);
480 if (tb
[IFLA_BOND_RESEND_IGMP
])
481 fprintf(f
, "resend_igmp %u ",
482 rta_getattr_u32(tb
[IFLA_BOND_RESEND_IGMP
]));
484 if (tb
[IFLA_BOND_NUM_PEER_NOTIF
])
485 fprintf(f
, "num_grat_arp %u ",
486 rta_getattr_u8(tb
[IFLA_BOND_NUM_PEER_NOTIF
]));
488 if (tb
[IFLA_BOND_ALL_SLAVES_ACTIVE
])
489 fprintf(f
, "all_slaves_active %u ",
490 rta_getattr_u8(tb
[IFLA_BOND_ALL_SLAVES_ACTIVE
]));
492 if (tb
[IFLA_BOND_MIN_LINKS
])
493 fprintf(f
, "min_links %u ",
494 rta_getattr_u32(tb
[IFLA_BOND_MIN_LINKS
]));
496 if (tb
[IFLA_BOND_LP_INTERVAL
])
497 fprintf(f
, "lp_interval %u ",
498 rta_getattr_u32(tb
[IFLA_BOND_LP_INTERVAL
]));
500 if (tb
[IFLA_BOND_PACKETS_PER_SLAVE
])
501 fprintf(f
, "packets_per_slave %u ",
502 rta_getattr_u32(tb
[IFLA_BOND_PACKETS_PER_SLAVE
]));
504 if (tb
[IFLA_BOND_AD_LACP_RATE
]) {
505 const char *lacp_rate
= get_name(lacp_rate_tbl
,
506 rta_getattr_u8(tb
[IFLA_BOND_AD_LACP_RATE
]));
507 fprintf(f
, "lacp_rate %s ", lacp_rate
);
510 if (tb
[IFLA_BOND_AD_SELECT
]) {
511 const char *ad_select
= get_name(ad_select_tbl
,
512 rta_getattr_u8(tb
[IFLA_BOND_AD_SELECT
]));
513 fprintf(f
, "ad_select %s ", ad_select
);
516 if (tb
[IFLA_BOND_AD_INFO
]) {
517 struct rtattr
*adtb
[IFLA_BOND_AD_INFO_MAX
+ 1];
519 parse_rtattr_nested(adtb
, IFLA_BOND_AD_INFO_MAX
,
520 tb
[IFLA_BOND_AD_INFO
]);
522 if (adtb
[IFLA_BOND_AD_INFO_AGGREGATOR
])
523 fprintf(f
, "ad_aggregator %d ",
524 rta_getattr_u16(adtb
[IFLA_BOND_AD_INFO_AGGREGATOR
]));
526 if (adtb
[IFLA_BOND_AD_INFO_NUM_PORTS
])
527 fprintf(f
, "ad_num_ports %d ",
528 rta_getattr_u16(adtb
[IFLA_BOND_AD_INFO_NUM_PORTS
]));
530 if (adtb
[IFLA_BOND_AD_INFO_ACTOR_KEY
])
531 fprintf(f
, "ad_actor_key %d ",
532 rta_getattr_u16(adtb
[IFLA_BOND_AD_INFO_ACTOR_KEY
]));
534 if (adtb
[IFLA_BOND_AD_INFO_PARTNER_KEY
])
535 fprintf(f
, "ad_partner_key %d ",
536 rta_getattr_u16(adtb
[IFLA_BOND_AD_INFO_PARTNER_KEY
]));
538 if (adtb
[IFLA_BOND_AD_INFO_PARTNER_MAC
]) {
540 RTA_DATA(adtb
[IFLA_BOND_AD_INFO_PARTNER_MAC
]);
542 fprintf(f
, "ad_partner_mac %s ",
543 ll_addr_n2a(p
, ETH_ALEN
, 0, b
, sizeof(b
)));
547 if (tb
[IFLA_BOND_AD_ACTOR_SYS_PRIO
]) {
548 fprintf(f
, "ad_actor_sys_prio %u ",
549 rta_getattr_u16(tb
[IFLA_BOND_AD_ACTOR_SYS_PRIO
]));
552 if (tb
[IFLA_BOND_AD_USER_PORT_KEY
]) {
553 fprintf(f
, "ad_user_port_key %u ",
554 rta_getattr_u16(tb
[IFLA_BOND_AD_USER_PORT_KEY
]));
557 if (tb
[IFLA_BOND_AD_ACTOR_SYSTEM
]) {
558 /* We assume the l2 address is an Ethernet MAC address */
560 fprintf(f
, "ad_actor_system %s ",
561 ll_addr_n2a(RTA_DATA(tb
[IFLA_BOND_AD_ACTOR_SYSTEM
]),
562 RTA_PAYLOAD(tb
[IFLA_BOND_AD_ACTOR_SYSTEM
]),
563 1 /*ARPHDR_ETHER*/, b1
, sizeof(b1
)));
566 if (tb
[IFLA_BOND_TLB_DYNAMIC_LB
]) {
567 fprintf(f
, "tlb_dynamic_lb %u ",
568 rta_getattr_u8(tb
[IFLA_BOND_TLB_DYNAMIC_LB
]));
572 static void bond_print_help(struct link_util
*lu
, int argc
, char **argv
,
578 struct link_util bond_link_util
= {
580 .maxattr
= IFLA_BOND_MAX
,
581 .parse_opt
= bond_parse_opt
,
582 .print_opt
= bond_print_opt
,
583 .print_help
= bond_print_help
,