2 * drivers/net/bond/bond_options.c - bonding options
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
12 #include <linux/errno.h>
14 #include <linux/netdevice.h>
15 #include <linux/spinlock.h>
16 #include <linux/rcupdate.h>
17 #include <linux/ctype.h>
18 #include <linux/inet.h>
19 #include <linux/sched/signal.h>
21 #include <net/bonding.h>
23 static int bond_option_active_slave_set(struct bonding *bond,
24 const struct bond_opt_value *newval);
25 static int bond_option_miimon_set(struct bonding *bond,
26 const struct bond_opt_value *newval);
27 static int bond_option_updelay_set(struct bonding *bond,
28 const struct bond_opt_value *newval);
29 static int bond_option_downdelay_set(struct bonding *bond,
30 const struct bond_opt_value *newval);
31 static int bond_option_use_carrier_set(struct bonding *bond,
32 const struct bond_opt_value *newval);
33 static int bond_option_arp_interval_set(struct bonding *bond,
34 const struct bond_opt_value *newval);
35 static int bond_option_arp_ip_target_add(struct bonding *bond, __be32 target);
36 static int bond_option_arp_ip_target_rem(struct bonding *bond, __be32 target);
37 static int bond_option_arp_ip_targets_set(struct bonding *bond,
38 const struct bond_opt_value *newval);
39 static int bond_option_arp_validate_set(struct bonding *bond,
40 const struct bond_opt_value *newval);
41 static int bond_option_arp_all_targets_set(struct bonding *bond,
42 const struct bond_opt_value *newval);
43 static int bond_option_primary_set(struct bonding *bond,
44 const struct bond_opt_value *newval);
45 static int bond_option_primary_reselect_set(struct bonding *bond,
46 const struct bond_opt_value *newval);
47 static int bond_option_fail_over_mac_set(struct bonding *bond,
48 const struct bond_opt_value *newval);
49 static int bond_option_xmit_hash_policy_set(struct bonding *bond,
50 const struct bond_opt_value *newval);
51 static int bond_option_resend_igmp_set(struct bonding *bond,
52 const struct bond_opt_value *newval);
53 static int bond_option_num_peer_notif_set(struct bonding *bond,
54 const struct bond_opt_value *newval);
55 static int bond_option_all_slaves_active_set(struct bonding *bond,
56 const struct bond_opt_value *newval);
57 static int bond_option_min_links_set(struct bonding *bond,
58 const struct bond_opt_value *newval);
59 static int bond_option_lp_interval_set(struct bonding *bond,
60 const struct bond_opt_value *newval);
61 static int bond_option_pps_set(struct bonding *bond,
62 const struct bond_opt_value *newval);
63 static int bond_option_lacp_rate_set(struct bonding *bond,
64 const struct bond_opt_value *newval);
65 static int bond_option_ad_select_set(struct bonding *bond,
66 const struct bond_opt_value *newval);
67 static int bond_option_queue_id_set(struct bonding *bond,
68 const struct bond_opt_value *newval);
69 static int bond_option_mode_set(struct bonding *bond,
70 const struct bond_opt_value *newval);
71 static int bond_option_slaves_set(struct bonding *bond,
72 const struct bond_opt_value *newval);
73 static int bond_option_tlb_dynamic_lb_set(struct bonding *bond,
74 const struct bond_opt_value *newval);
75 static int bond_option_ad_actor_sys_prio_set(struct bonding *bond,
76 const struct bond_opt_value *newval);
77 static int bond_option_ad_actor_system_set(struct bonding *bond,
78 const struct bond_opt_value *newval);
79 static int bond_option_ad_user_port_key_set(struct bonding *bond,
80 const struct bond_opt_value *newval);
83 static const struct bond_opt_value bond_mode_tbl[] = {
84 { "balance-rr", BOND_MODE_ROUNDROBIN, BOND_VALFLAG_DEFAULT},
85 { "active-backup", BOND_MODE_ACTIVEBACKUP, 0},
86 { "balance-xor", BOND_MODE_XOR, 0},
87 { "broadcast", BOND_MODE_BROADCAST, 0},
88 { "802.3ad", BOND_MODE_8023AD, 0},
89 { "balance-tlb", BOND_MODE_TLB, 0},
90 { "balance-alb", BOND_MODE_ALB, 0},
94 static const struct bond_opt_value bond_pps_tbl[] = {
95 { "default", 1, BOND_VALFLAG_DEFAULT},
96 { "maxval", USHRT_MAX, BOND_VALFLAG_MAX},
100 static const struct bond_opt_value bond_xmit_hashtype_tbl[] = {
101 { "layer2", BOND_XMIT_POLICY_LAYER2, BOND_VALFLAG_DEFAULT},
102 { "layer3+4", BOND_XMIT_POLICY_LAYER34, 0},
103 { "layer2+3", BOND_XMIT_POLICY_LAYER23, 0},
104 { "encap2+3", BOND_XMIT_POLICY_ENCAP23, 0},
105 { "encap3+4", BOND_XMIT_POLICY_ENCAP34, 0},
109 static const struct bond_opt_value bond_arp_validate_tbl[] = {
110 { "none", BOND_ARP_VALIDATE_NONE, BOND_VALFLAG_DEFAULT},
111 { "active", BOND_ARP_VALIDATE_ACTIVE, 0},
112 { "backup", BOND_ARP_VALIDATE_BACKUP, 0},
113 { "all", BOND_ARP_VALIDATE_ALL, 0},
114 { "filter", BOND_ARP_FILTER, 0},
115 { "filter_active", BOND_ARP_FILTER_ACTIVE, 0},
116 { "filter_backup", BOND_ARP_FILTER_BACKUP, 0},
120 static const struct bond_opt_value bond_arp_all_targets_tbl[] = {
121 { "any", BOND_ARP_TARGETS_ANY, BOND_VALFLAG_DEFAULT},
122 { "all", BOND_ARP_TARGETS_ALL, 0},
126 static const struct bond_opt_value bond_fail_over_mac_tbl[] = {
127 { "none", BOND_FOM_NONE, BOND_VALFLAG_DEFAULT},
128 { "active", BOND_FOM_ACTIVE, 0},
129 { "follow", BOND_FOM_FOLLOW, 0},
133 static const struct bond_opt_value bond_intmax_tbl[] = {
134 { "off", 0, BOND_VALFLAG_DEFAULT},
135 { "maxval", INT_MAX, BOND_VALFLAG_MAX},
139 static const struct bond_opt_value bond_lacp_rate_tbl[] = {
140 { "slow", AD_LACP_SLOW, 0},
141 { "fast", AD_LACP_FAST, 0},
145 static const struct bond_opt_value bond_ad_select_tbl[] = {
146 { "stable", BOND_AD_STABLE, BOND_VALFLAG_DEFAULT},
147 { "bandwidth", BOND_AD_BANDWIDTH, 0},
148 { "count", BOND_AD_COUNT, 0},
152 static const struct bond_opt_value bond_num_peer_notif_tbl[] = {
154 { "maxval", 255, BOND_VALFLAG_MAX},
155 { "default", 1, BOND_VALFLAG_DEFAULT},
159 static const struct bond_opt_value bond_primary_reselect_tbl[] = {
160 { "always", BOND_PRI_RESELECT_ALWAYS, BOND_VALFLAG_DEFAULT},
161 { "better", BOND_PRI_RESELECT_BETTER, 0},
162 { "failure", BOND_PRI_RESELECT_FAILURE, 0},
166 static const struct bond_opt_value bond_use_carrier_tbl[] = {
168 { "on", 1, BOND_VALFLAG_DEFAULT},
172 static const struct bond_opt_value bond_all_slaves_active_tbl[] = {
173 { "off", 0, BOND_VALFLAG_DEFAULT},
178 static const struct bond_opt_value bond_resend_igmp_tbl[] = {
180 { "maxval", 255, BOND_VALFLAG_MAX},
181 { "default", 1, BOND_VALFLAG_DEFAULT},
185 static const struct bond_opt_value bond_lp_interval_tbl[] = {
186 { "minval", 1, BOND_VALFLAG_MIN | BOND_VALFLAG_DEFAULT},
187 { "maxval", INT_MAX, BOND_VALFLAG_MAX},
191 static const struct bond_opt_value bond_tlb_dynamic_lb_tbl[] = {
193 { "on", 1, BOND_VALFLAG_DEFAULT},
197 static const struct bond_opt_value bond_ad_actor_sys_prio_tbl[] = {
198 { "minval", 1, BOND_VALFLAG_MIN},
199 { "maxval", 65535, BOND_VALFLAG_MAX | BOND_VALFLAG_DEFAULT},
203 static const struct bond_opt_value bond_ad_user_port_key_tbl[] = {
204 { "minval", 0, BOND_VALFLAG_MIN | BOND_VALFLAG_DEFAULT},
205 { "maxval", 1023, BOND_VALFLAG_MAX},
209 static const struct bond_option bond_opts[BOND_OPT_LAST] = {
213 .desc = "bond device mode",
214 .flags = BOND_OPTFLAG_NOSLAVES | BOND_OPTFLAG_IFDOWN,
215 .values = bond_mode_tbl,
216 .set = bond_option_mode_set
218 [BOND_OPT_PACKETS_PER_SLAVE] = {
219 .id = BOND_OPT_PACKETS_PER_SLAVE,
220 .name = "packets_per_slave",
221 .desc = "Packets to send per slave in RR mode",
222 .unsuppmodes = BOND_MODE_ALL_EX(BIT(BOND_MODE_ROUNDROBIN)),
223 .values = bond_pps_tbl,
224 .set = bond_option_pps_set
226 [BOND_OPT_XMIT_HASH] = {
227 .id = BOND_OPT_XMIT_HASH,
228 .name = "xmit_hash_policy",
229 .desc = "balance-xor, 802.3ad, and tlb hashing method",
230 .values = bond_xmit_hashtype_tbl,
231 .set = bond_option_xmit_hash_policy_set
233 [BOND_OPT_ARP_VALIDATE] = {
234 .id = BOND_OPT_ARP_VALIDATE,
235 .name = "arp_validate",
236 .desc = "validate src/dst of ARP probes",
237 .unsuppmodes = BIT(BOND_MODE_8023AD) | BIT(BOND_MODE_TLB) |
239 .values = bond_arp_validate_tbl,
240 .set = bond_option_arp_validate_set
242 [BOND_OPT_ARP_ALL_TARGETS] = {
243 .id = BOND_OPT_ARP_ALL_TARGETS,
244 .name = "arp_all_targets",
245 .desc = "fail on any/all arp targets timeout",
246 .values = bond_arp_all_targets_tbl,
247 .set = bond_option_arp_all_targets_set
249 [BOND_OPT_FAIL_OVER_MAC] = {
250 .id = BOND_OPT_FAIL_OVER_MAC,
251 .name = "fail_over_mac",
252 .desc = "For active-backup, do not set all slaves to the same MAC",
253 .flags = BOND_OPTFLAG_NOSLAVES,
254 .values = bond_fail_over_mac_tbl,
255 .set = bond_option_fail_over_mac_set
257 [BOND_OPT_ARP_INTERVAL] = {
258 .id = BOND_OPT_ARP_INTERVAL,
259 .name = "arp_interval",
260 .desc = "arp interval in milliseconds",
261 .unsuppmodes = BIT(BOND_MODE_8023AD) | BIT(BOND_MODE_TLB) |
263 .values = bond_intmax_tbl,
264 .set = bond_option_arp_interval_set
266 [BOND_OPT_ARP_TARGETS] = {
267 .id = BOND_OPT_ARP_TARGETS,
268 .name = "arp_ip_target",
269 .desc = "arp targets in n.n.n.n form",
270 .flags = BOND_OPTFLAG_RAWVAL,
271 .set = bond_option_arp_ip_targets_set
273 [BOND_OPT_DOWNDELAY] = {
274 .id = BOND_OPT_DOWNDELAY,
276 .desc = "Delay before considering link down, in milliseconds",
277 .values = bond_intmax_tbl,
278 .set = bond_option_downdelay_set
280 [BOND_OPT_UPDELAY] = {
281 .id = BOND_OPT_UPDELAY,
283 .desc = "Delay before considering link up, in milliseconds",
284 .values = bond_intmax_tbl,
285 .set = bond_option_updelay_set
287 [BOND_OPT_LACP_RATE] = {
288 .id = BOND_OPT_LACP_RATE,
290 .desc = "LACPDU tx rate to request from 802.3ad partner",
291 .flags = BOND_OPTFLAG_IFDOWN,
292 .unsuppmodes = BOND_MODE_ALL_EX(BIT(BOND_MODE_8023AD)),
293 .values = bond_lacp_rate_tbl,
294 .set = bond_option_lacp_rate_set
296 [BOND_OPT_MINLINKS] = {
297 .id = BOND_OPT_MINLINKS,
299 .desc = "Minimum number of available links before turning on carrier",
300 .values = bond_intmax_tbl,
301 .set = bond_option_min_links_set
303 [BOND_OPT_AD_SELECT] = {
304 .id = BOND_OPT_AD_SELECT,
306 .desc = "803.ad aggregation selection logic",
307 .flags = BOND_OPTFLAG_IFDOWN,
308 .values = bond_ad_select_tbl,
309 .set = bond_option_ad_select_set
311 [BOND_OPT_NUM_PEER_NOTIF] = {
312 .id = BOND_OPT_NUM_PEER_NOTIF,
313 .name = "num_unsol_na",
314 .desc = "Number of peer notifications to send on failover event",
315 .values = bond_num_peer_notif_tbl,
316 .set = bond_option_num_peer_notif_set
318 [BOND_OPT_MIIMON] = {
319 .id = BOND_OPT_MIIMON,
321 .desc = "Link check interval in milliseconds",
322 .values = bond_intmax_tbl,
323 .set = bond_option_miimon_set
325 [BOND_OPT_PRIMARY] = {
326 .id = BOND_OPT_PRIMARY,
328 .desc = "Primary network device to use",
329 .flags = BOND_OPTFLAG_RAWVAL,
330 .unsuppmodes = BOND_MODE_ALL_EX(BIT(BOND_MODE_ACTIVEBACKUP) |
333 .set = bond_option_primary_set
335 [BOND_OPT_PRIMARY_RESELECT] = {
336 .id = BOND_OPT_PRIMARY_RESELECT,
337 .name = "primary_reselect",
338 .desc = "Reselect primary slave once it comes up",
339 .values = bond_primary_reselect_tbl,
340 .set = bond_option_primary_reselect_set
342 [BOND_OPT_USE_CARRIER] = {
343 .id = BOND_OPT_USE_CARRIER,
344 .name = "use_carrier",
345 .desc = "Use netif_carrier_ok (vs MII ioctls) in miimon",
346 .values = bond_use_carrier_tbl,
347 .set = bond_option_use_carrier_set
349 [BOND_OPT_ACTIVE_SLAVE] = {
350 .id = BOND_OPT_ACTIVE_SLAVE,
351 .name = "active_slave",
352 .desc = "Currently active slave",
353 .flags = BOND_OPTFLAG_RAWVAL,
354 .unsuppmodes = BOND_MODE_ALL_EX(BIT(BOND_MODE_ACTIVEBACKUP) |
357 .set = bond_option_active_slave_set
359 [BOND_OPT_QUEUE_ID] = {
360 .id = BOND_OPT_QUEUE_ID,
362 .desc = "Set queue id of a slave",
363 .flags = BOND_OPTFLAG_RAWVAL,
364 .set = bond_option_queue_id_set
366 [BOND_OPT_ALL_SLAVES_ACTIVE] = {
367 .id = BOND_OPT_ALL_SLAVES_ACTIVE,
368 .name = "all_slaves_active",
369 .desc = "Keep all frames received on an interface by setting active flag for all slaves",
370 .values = bond_all_slaves_active_tbl,
371 .set = bond_option_all_slaves_active_set
373 [BOND_OPT_RESEND_IGMP] = {
374 .id = BOND_OPT_RESEND_IGMP,
375 .name = "resend_igmp",
376 .desc = "Number of IGMP membership reports to send on link failure",
377 .values = bond_resend_igmp_tbl,
378 .set = bond_option_resend_igmp_set
380 [BOND_OPT_LP_INTERVAL] = {
381 .id = BOND_OPT_LP_INTERVAL,
382 .name = "lp_interval",
383 .desc = "The number of seconds between instances where the bonding driver sends learning packets to each slave's peer switch",
384 .values = bond_lp_interval_tbl,
385 .set = bond_option_lp_interval_set
387 [BOND_OPT_SLAVES] = {
388 .id = BOND_OPT_SLAVES,
390 .desc = "Slave membership management",
391 .flags = BOND_OPTFLAG_RAWVAL,
392 .set = bond_option_slaves_set
394 [BOND_OPT_TLB_DYNAMIC_LB] = {
395 .id = BOND_OPT_TLB_DYNAMIC_LB,
396 .name = "tlb_dynamic_lb",
397 .desc = "Enable dynamic flow shuffling",
398 .unsuppmodes = BOND_MODE_ALL_EX(BIT(BOND_MODE_TLB) | BIT(BOND_MODE_ALB)),
399 .values = bond_tlb_dynamic_lb_tbl,
400 .flags = BOND_OPTFLAG_IFDOWN,
401 .set = bond_option_tlb_dynamic_lb_set,
403 [BOND_OPT_AD_ACTOR_SYS_PRIO] = {
404 .id = BOND_OPT_AD_ACTOR_SYS_PRIO,
405 .name = "ad_actor_sys_prio",
406 .unsuppmodes = BOND_MODE_ALL_EX(BIT(BOND_MODE_8023AD)),
407 .values = bond_ad_actor_sys_prio_tbl,
408 .set = bond_option_ad_actor_sys_prio_set,
410 [BOND_OPT_AD_ACTOR_SYSTEM] = {
411 .id = BOND_OPT_AD_ACTOR_SYSTEM,
412 .name = "ad_actor_system",
413 .unsuppmodes = BOND_MODE_ALL_EX(BIT(BOND_MODE_8023AD)),
414 .flags = BOND_OPTFLAG_RAWVAL,
415 .set = bond_option_ad_actor_system_set,
417 [BOND_OPT_AD_USER_PORT_KEY] = {
418 .id = BOND_OPT_AD_USER_PORT_KEY,
419 .name = "ad_user_port_key",
420 .unsuppmodes = BOND_MODE_ALL_EX(BIT(BOND_MODE_8023AD)),
421 .flags = BOND_OPTFLAG_IFDOWN,
422 .values = bond_ad_user_port_key_tbl,
423 .set = bond_option_ad_user_port_key_set,
425 [BOND_OPT_NUM_PEER_NOTIF_ALIAS] = {
426 .id = BOND_OPT_NUM_PEER_NOTIF_ALIAS,
427 .name = "num_grat_arp",
428 .desc = "Number of peer notifications to send on failover event",
429 .values = bond_num_peer_notif_tbl,
430 .set = bond_option_num_peer_notif_set
434 /* Searches for an option by name */
435 const struct bond_option *bond_opt_get_by_name(const char *name)
437 const struct bond_option *opt;
440 for (option = 0; option < BOND_OPT_LAST; option++) {
441 opt = bond_opt_get(option);
442 if (opt && !strcmp(opt->name, name))
449 /* Searches for a value in opt's values[] table */
450 const struct bond_opt_value *bond_opt_get_val(unsigned int option, u64 val)
452 const struct bond_option *opt;
455 opt = bond_opt_get(option);
458 for (i = 0; opt->values && opt->values[i].string; i++)
459 if (opt->values[i].value == val)
460 return &opt->values[i];
465 /* Searches for a value in opt's values[] table which matches the flagmask */
466 static const struct bond_opt_value *bond_opt_get_flags(const struct bond_option *opt,
471 for (i = 0; opt->values && opt->values[i].string; i++)
472 if (opt->values[i].flags & flagmask)
473 return &opt->values[i];
478 /* If maxval is missing then there's no range to check. In case minval is
479 * missing then it's considered to be 0.
481 static bool bond_opt_check_range(const struct bond_option *opt, u64 val)
483 const struct bond_opt_value *minval, *maxval;
485 minval = bond_opt_get_flags(opt, BOND_VALFLAG_MIN);
486 maxval = bond_opt_get_flags(opt, BOND_VALFLAG_MAX);
487 if (!maxval || (minval && val < minval->value) || val > maxval->value)
494 * bond_opt_parse - parse option value
495 * @opt: the option to parse against
496 * @val: value to parse
498 * This function tries to extract the value from @val and check if it's
499 * a possible match for the option and returns NULL if a match isn't found,
500 * or the struct_opt_value that matched. It also strips the new line from
501 * @val->string if it's present.
503 const struct bond_opt_value *bond_opt_parse(const struct bond_option *opt,
504 struct bond_opt_value *val)
506 char *p, valstr[BOND_OPT_MAX_NAMELEN + 1] = { 0, };
507 const struct bond_opt_value *tbl;
508 const struct bond_opt_value *ret = NULL;
512 /* No parsing if the option wants a raw val */
513 if (opt->flags & BOND_OPTFLAG_RAWVAL)
520 /* ULLONG_MAX is used to bypass string processing */
521 checkval = val->value != ULLONG_MAX;
525 p = strchr(val->string, '\n');
528 for (p = val->string; *p; p++)
529 if (!(isdigit(*p) || isspace(*p)))
531 /* The following code extracts the string to match or the value
532 * and sets checkval appropriately
535 rv = sscanf(val->string, "%32s", valstr);
537 rv = sscanf(val->string, "%llu", &val->value);
544 for (i = 0; tbl[i].string; i++) {
545 /* Check for exact match */
547 if (val->value == tbl[i].value)
550 if (!strcmp(valstr, "default") &&
551 (tbl[i].flags & BOND_VALFLAG_DEFAULT))
554 if (!strcmp(valstr, tbl[i].string))
557 /* Found an exact match */
561 /* Possible range match */
562 if (checkval && bond_opt_check_range(opt, val->value))
568 /* Check opt's dependencies against bond mode and currently set options */
569 static int bond_opt_check_deps(struct bonding *bond,
570 const struct bond_option *opt)
572 struct bond_params *params = &bond->params;
574 if (test_bit(params->mode, &opt->unsuppmodes))
576 if ((opt->flags & BOND_OPTFLAG_NOSLAVES) && bond_has_slaves(bond))
578 if ((opt->flags & BOND_OPTFLAG_IFDOWN) && (bond->dev->flags & IFF_UP))
584 static void bond_opt_dep_print(struct bonding *bond,
585 const struct bond_option *opt)
587 const struct bond_opt_value *modeval;
588 struct bond_params *params;
590 params = &bond->params;
591 modeval = bond_opt_get_val(BOND_OPT_MODE, params->mode);
592 if (test_bit(params->mode, &opt->unsuppmodes))
593 netdev_err(bond->dev, "option %s: mode dependency failed, not supported in mode %s(%llu)\n",
594 opt->name, modeval->string, modeval->value);
597 static void bond_opt_error_interpret(struct bonding *bond,
598 const struct bond_option *opt,
599 int error, const struct bond_opt_value *val)
601 const struct bond_opt_value *minval, *maxval;
608 /* sometimes RAWVAL opts may have new lines */
609 p = strchr(val->string, '\n');
612 netdev_err(bond->dev, "option %s: invalid value (%s)\n",
613 opt->name, val->string);
615 netdev_err(bond->dev, "option %s: invalid value (%llu)\n",
616 opt->name, val->value);
619 minval = bond_opt_get_flags(opt, BOND_VALFLAG_MIN);
620 maxval = bond_opt_get_flags(opt, BOND_VALFLAG_MAX);
623 netdev_err(bond->dev, "option %s: allowed values %llu - %llu\n",
624 opt->name, minval ? minval->value : 0, maxval->value);
627 bond_opt_dep_print(bond, opt);
630 netdev_err(bond->dev, "option %s: unable to set because the bond device has slaves\n",
634 netdev_err(bond->dev, "option %s: unable to set because the bond device is up\n",
643 * __bond_opt_set - set a bonding option
644 * @bond: target bond device
645 * @option: option to set
646 * @val: value to set it to
648 * This function is used to change the bond's option value, it can be
649 * used for both enabling/changing an option and for disabling it. RTNL lock
650 * must be obtained before calling this function.
652 int __bond_opt_set(struct bonding *bond,
653 unsigned int option, struct bond_opt_value *val)
655 const struct bond_opt_value *retval = NULL;
656 const struct bond_option *opt;
661 opt = bond_opt_get(option);
662 if (WARN_ON(!val) || WARN_ON(!opt))
664 ret = bond_opt_check_deps(bond, opt);
667 retval = bond_opt_parse(opt, val);
672 ret = opt->set(bond, retval);
675 bond_opt_error_interpret(bond, opt, ret, val);
680 * __bond_opt_set_notify - set a bonding option
681 * @bond: target bond device
682 * @option: option to set
683 * @val: value to set it to
685 * This function is used to change the bond's option value and trigger
686 * a notification to user sapce. It can be used for both enabling/changing
687 * an option and for disabling it. RTNL lock must be obtained before calling
690 int __bond_opt_set_notify(struct bonding *bond,
691 unsigned int option, struct bond_opt_value *val)
697 ret = __bond_opt_set(bond, option, val);
699 if (!ret && (bond->dev->reg_state == NETREG_REGISTERED))
700 call_netdevice_notifiers(NETDEV_CHANGEINFODATA, bond->dev);
706 * bond_opt_tryset_rtnl - try to acquire rtnl and call __bond_opt_set
707 * @bond: target bond device
708 * @option: option to set
709 * @buf: value to set it to
711 * This function tries to acquire RTNL without blocking and if successful
712 * calls __bond_opt_set. It is mainly used for sysfs option manipulation.
714 int bond_opt_tryset_rtnl(struct bonding *bond, unsigned int option, char *buf)
716 struct bond_opt_value optval;
720 return restart_syscall();
721 bond_opt_initstr(&optval, buf);
722 ret = __bond_opt_set_notify(bond, option, &optval);
729 * bond_opt_get - get a pointer to an option
730 * @option: option for which to return a pointer
732 * This function checks if option is valid and if so returns a pointer
733 * to its entry in the bond_opts[] option array.
735 const struct bond_option *bond_opt_get(unsigned int option)
737 if (!BOND_OPT_VALID(option))
740 return &bond_opts[option];
743 static int bond_option_mode_set(struct bonding *bond,
744 const struct bond_opt_value *newval)
746 if (!bond_mode_uses_arp(newval->value)) {
747 if (bond->params.arp_interval) {
748 netdev_dbg(bond->dev, "%s mode is incompatible with arp monitoring, start mii monitoring\n",
750 /* disable arp monitoring */
751 bond->params.arp_interval = 0;
754 if (!bond->params.miimon) {
755 /* set miimon to default value */
756 bond->params.miimon = BOND_DEFAULT_MIIMON;
757 netdev_dbg(bond->dev, "Setting MII monitoring interval to %d\n",
758 bond->params.miimon);
762 if (newval->value == BOND_MODE_ALB)
763 bond->params.tlb_dynamic_lb = 1;
765 /* don't cache arp_validate between modes */
766 bond->params.arp_validate = BOND_ARP_VALIDATE_NONE;
767 bond->params.mode = newval->value;
772 static int bond_option_active_slave_set(struct bonding *bond,
773 const struct bond_opt_value *newval)
775 char ifname[IFNAMSIZ] = { 0, };
776 struct net_device *slave_dev;
779 sscanf(newval->string, "%15s", ifname); /* IFNAMSIZ */
780 if (!strlen(ifname) || newval->string[0] == '\n') {
783 slave_dev = __dev_get_by_name(dev_net(bond->dev), ifname);
789 if (!netif_is_bond_slave(slave_dev)) {
790 netdev_err(bond->dev, "Device %s is not bonding slave\n",
795 if (bond->dev != netdev_master_upper_dev_get(slave_dev)) {
796 netdev_err(bond->dev, "Device %s is not our slave\n",
803 /* check to see if we are clearing active */
805 netdev_dbg(bond->dev, "Clearing current active slave\n");
806 RCU_INIT_POINTER(bond->curr_active_slave, NULL);
807 bond_select_active_slave(bond);
809 struct slave *old_active = rtnl_dereference(bond->curr_active_slave);
810 struct slave *new_active = bond_slave_get_rtnl(slave_dev);
814 if (new_active == old_active) {
816 netdev_dbg(bond->dev, "%s is already the current active slave\n",
817 new_active->dev->name);
819 if (old_active && (new_active->link == BOND_LINK_UP) &&
820 bond_slave_is_up(new_active)) {
821 netdev_dbg(bond->dev, "Setting %s as active slave\n",
822 new_active->dev->name);
823 bond_change_active_slave(bond, new_active);
825 netdev_err(bond->dev, "Could not set %s as active slave; either %s is down or the link is down\n",
826 new_active->dev->name,
827 new_active->dev->name);
832 unblock_netpoll_tx();
837 /* There are two tricky bits here. First, if MII monitoring is activated, then
838 * we must disable ARP monitoring. Second, if the timer isn't running, we must
841 static int bond_option_miimon_set(struct bonding *bond,
842 const struct bond_opt_value *newval)
844 netdev_dbg(bond->dev, "Setting MII monitoring interval to %llu\n",
846 bond->params.miimon = newval->value;
847 if (bond->params.updelay)
848 netdev_dbg(bond->dev, "Note: Updating updelay (to %d) since it is a multiple of the miimon value\n",
849 bond->params.updelay * bond->params.miimon);
850 if (bond->params.downdelay)
851 netdev_dbg(bond->dev, "Note: Updating downdelay (to %d) since it is a multiple of the miimon value\n",
852 bond->params.downdelay * bond->params.miimon);
853 if (newval->value && bond->params.arp_interval) {
854 netdev_dbg(bond->dev, "MII monitoring cannot be used with ARP monitoring - disabling ARP monitoring...\n");
855 bond->params.arp_interval = 0;
856 if (bond->params.arp_validate)
857 bond->params.arp_validate = BOND_ARP_VALIDATE_NONE;
859 if (bond->dev->flags & IFF_UP) {
860 /* If the interface is up, we may need to fire off
861 * the MII timer. If the interface is down, the
862 * timer will get fired off when the open function
865 if (!newval->value) {
866 cancel_delayed_work_sync(&bond->mii_work);
868 cancel_delayed_work_sync(&bond->arp_work);
869 queue_delayed_work(bond->wq, &bond->mii_work, 0);
876 /* Set up and down delays. These must be multiples of the
877 * MII monitoring value, and are stored internally as the multiplier.
878 * Thus, we must translate to MS for the real world.
880 static int bond_option_updelay_set(struct bonding *bond,
881 const struct bond_opt_value *newval)
883 int value = newval->value;
885 if (!bond->params.miimon) {
886 netdev_err(bond->dev, "Unable to set up delay as MII monitoring is disabled\n");
889 if ((value % bond->params.miimon) != 0) {
890 netdev_warn(bond->dev, "up delay (%d) is not a multiple of miimon (%d), updelay rounded to %d ms\n",
891 value, bond->params.miimon,
892 (value / bond->params.miimon) *
893 bond->params.miimon);
895 bond->params.updelay = value / bond->params.miimon;
896 netdev_dbg(bond->dev, "Setting up delay to %d\n",
897 bond->params.updelay * bond->params.miimon);
902 static int bond_option_downdelay_set(struct bonding *bond,
903 const struct bond_opt_value *newval)
905 int value = newval->value;
907 if (!bond->params.miimon) {
908 netdev_err(bond->dev, "Unable to set down delay as MII monitoring is disabled\n");
911 if ((value % bond->params.miimon) != 0) {
912 netdev_warn(bond->dev, "down delay (%d) is not a multiple of miimon (%d), delay rounded to %d ms\n",
913 value, bond->params.miimon,
914 (value / bond->params.miimon) *
915 bond->params.miimon);
917 bond->params.downdelay = value / bond->params.miimon;
918 netdev_dbg(bond->dev, "Setting down delay to %d\n",
919 bond->params.downdelay * bond->params.miimon);
924 static int bond_option_use_carrier_set(struct bonding *bond,
925 const struct bond_opt_value *newval)
927 netdev_dbg(bond->dev, "Setting use_carrier to %llu\n",
929 bond->params.use_carrier = newval->value;
934 /* There are two tricky bits here. First, if ARP monitoring is activated, then
935 * we must disable MII monitoring. Second, if the ARP timer isn't running,
938 static int bond_option_arp_interval_set(struct bonding *bond,
939 const struct bond_opt_value *newval)
941 netdev_dbg(bond->dev, "Setting ARP monitoring interval to %llu\n",
943 bond->params.arp_interval = newval->value;
945 if (bond->params.miimon) {
946 netdev_dbg(bond->dev, "ARP monitoring cannot be used with MII monitoring. Disabling MII monitoring\n");
947 bond->params.miimon = 0;
949 if (!bond->params.arp_targets[0])
950 netdev_dbg(bond->dev, "ARP monitoring has been set up, but no ARP targets have been specified\n");
952 if (bond->dev->flags & IFF_UP) {
953 /* If the interface is up, we may need to fire off
954 * the ARP timer. If the interface is down, the
955 * timer will get fired off when the open function
958 if (!newval->value) {
959 if (bond->params.arp_validate)
960 bond->recv_probe = NULL;
961 cancel_delayed_work_sync(&bond->arp_work);
963 /* arp_validate can be set only in active-backup mode */
964 bond->recv_probe = bond_arp_rcv;
965 cancel_delayed_work_sync(&bond->mii_work);
966 queue_delayed_work(bond->wq, &bond->arp_work, 0);
973 static void _bond_options_arp_ip_target_set(struct bonding *bond, int slot,
975 unsigned long last_rx)
977 __be32 *targets = bond->params.arp_targets;
978 struct list_head *iter;
981 if (slot >= 0 && slot < BOND_MAX_ARP_TARGETS) {
982 bond_for_each_slave(bond, slave, iter)
983 slave->target_last_arp_rx[slot] = last_rx;
984 targets[slot] = target;
988 static int _bond_option_arp_ip_target_add(struct bonding *bond, __be32 target)
990 __be32 *targets = bond->params.arp_targets;
993 if (!bond_is_ip_target_ok(target)) {
994 netdev_err(bond->dev, "invalid ARP target %pI4 specified for addition\n",
999 if (bond_get_targets_ip(targets, target) != -1) { /* dup */
1000 netdev_err(bond->dev, "ARP target %pI4 is already present\n",
1005 ind = bond_get_targets_ip(targets, 0); /* first free slot */
1007 netdev_err(bond->dev, "ARP target table is full!\n");
1011 netdev_dbg(bond->dev, "Adding ARP target %pI4\n", &target);
1013 _bond_options_arp_ip_target_set(bond, ind, target, jiffies);
1018 static int bond_option_arp_ip_target_add(struct bonding *bond, __be32 target)
1020 return _bond_option_arp_ip_target_add(bond, target);
1023 static int bond_option_arp_ip_target_rem(struct bonding *bond, __be32 target)
1025 __be32 *targets = bond->params.arp_targets;
1026 struct list_head *iter;
1027 struct slave *slave;
1028 unsigned long *targets_rx;
1031 if (!bond_is_ip_target_ok(target)) {
1032 netdev_err(bond->dev, "invalid ARP target %pI4 specified for removal\n",
1037 ind = bond_get_targets_ip(targets, target);
1039 netdev_err(bond->dev, "unable to remove nonexistent ARP target %pI4\n",
1044 if (ind == 0 && !targets[1] && bond->params.arp_interval)
1045 netdev_warn(bond->dev, "Removing last arp target with arp_interval on\n");
1047 netdev_dbg(bond->dev, "Removing ARP target %pI4\n", &target);
1049 bond_for_each_slave(bond, slave, iter) {
1050 targets_rx = slave->target_last_arp_rx;
1051 for (i = ind; (i < BOND_MAX_ARP_TARGETS-1) && targets[i+1]; i++)
1052 targets_rx[i] = targets_rx[i+1];
1055 for (i = ind; (i < BOND_MAX_ARP_TARGETS-1) && targets[i+1]; i++)
1056 targets[i] = targets[i+1];
1062 void bond_option_arp_ip_targets_clear(struct bonding *bond)
1066 for (i = 0; i < BOND_MAX_ARP_TARGETS; i++)
1067 _bond_options_arp_ip_target_set(bond, i, 0, 0);
1070 static int bond_option_arp_ip_targets_set(struct bonding *bond,
1071 const struct bond_opt_value *newval)
1076 if (newval->string) {
1077 if (!in4_pton(newval->string+1, -1, (u8 *)&target, -1, NULL)) {
1078 netdev_err(bond->dev, "invalid ARP target %pI4 specified\n",
1082 if (newval->string[0] == '+')
1083 ret = bond_option_arp_ip_target_add(bond, target);
1084 else if (newval->string[0] == '-')
1085 ret = bond_option_arp_ip_target_rem(bond, target);
1087 netdev_err(bond->dev, "no command found in arp_ip_targets file - use +<addr> or -<addr>\n");
1089 target = newval->value;
1090 ret = bond_option_arp_ip_target_add(bond, target);
1096 static int bond_option_arp_validate_set(struct bonding *bond,
1097 const struct bond_opt_value *newval)
1099 netdev_dbg(bond->dev, "Setting arp_validate to %s (%llu)\n",
1100 newval->string, newval->value);
1102 if (bond->dev->flags & IFF_UP) {
1104 bond->recv_probe = NULL;
1105 else if (bond->params.arp_interval)
1106 bond->recv_probe = bond_arp_rcv;
1108 bond->params.arp_validate = newval->value;
1113 static int bond_option_arp_all_targets_set(struct bonding *bond,
1114 const struct bond_opt_value *newval)
1116 netdev_dbg(bond->dev, "Setting arp_all_targets to %s (%llu)\n",
1117 newval->string, newval->value);
1118 bond->params.arp_all_targets = newval->value;
1123 static int bond_option_primary_set(struct bonding *bond,
1124 const struct bond_opt_value *newval)
1126 char *p, *primary = newval->string;
1127 struct list_head *iter;
1128 struct slave *slave;
1132 p = strchr(primary, '\n');
1135 /* check to see if we are clearing primary */
1136 if (!strlen(primary)) {
1137 netdev_dbg(bond->dev, "Setting primary slave to None\n");
1138 RCU_INIT_POINTER(bond->primary_slave, NULL);
1139 memset(bond->params.primary, 0, sizeof(bond->params.primary));
1140 bond_select_active_slave(bond);
1144 bond_for_each_slave(bond, slave, iter) {
1145 if (strncmp(slave->dev->name, primary, IFNAMSIZ) == 0) {
1146 netdev_dbg(bond->dev, "Setting %s as primary slave\n",
1148 rcu_assign_pointer(bond->primary_slave, slave);
1149 strcpy(bond->params.primary, slave->dev->name);
1150 bond->force_primary = true;
1151 bond_select_active_slave(bond);
1156 if (rtnl_dereference(bond->primary_slave)) {
1157 netdev_dbg(bond->dev, "Setting primary slave to None\n");
1158 RCU_INIT_POINTER(bond->primary_slave, NULL);
1159 bond_select_active_slave(bond);
1161 strncpy(bond->params.primary, primary, IFNAMSIZ);
1162 bond->params.primary[IFNAMSIZ - 1] = 0;
1164 netdev_dbg(bond->dev, "Recording %s as primary, but it has not been enslaved to %s yet\n",
1165 primary, bond->dev->name);
1168 unblock_netpoll_tx();
1173 static int bond_option_primary_reselect_set(struct bonding *bond,
1174 const struct bond_opt_value *newval)
1176 netdev_dbg(bond->dev, "Setting primary_reselect to %s (%llu)\n",
1177 newval->string, newval->value);
1178 bond->params.primary_reselect = newval->value;
1181 bond_select_active_slave(bond);
1182 unblock_netpoll_tx();
1187 static int bond_option_fail_over_mac_set(struct bonding *bond,
1188 const struct bond_opt_value *newval)
1190 netdev_dbg(bond->dev, "Setting fail_over_mac to %s (%llu)\n",
1191 newval->string, newval->value);
1192 bond->params.fail_over_mac = newval->value;
1197 static int bond_option_xmit_hash_policy_set(struct bonding *bond,
1198 const struct bond_opt_value *newval)
1200 netdev_dbg(bond->dev, "Setting xmit hash policy to %s (%llu)\n",
1201 newval->string, newval->value);
1202 bond->params.xmit_policy = newval->value;
1207 static int bond_option_resend_igmp_set(struct bonding *bond,
1208 const struct bond_opt_value *newval)
1210 netdev_dbg(bond->dev, "Setting resend_igmp to %llu\n",
1212 bond->params.resend_igmp = newval->value;
1217 static int bond_option_num_peer_notif_set(struct bonding *bond,
1218 const struct bond_opt_value *newval)
1220 bond->params.num_peer_notif = newval->value;
1225 static int bond_option_all_slaves_active_set(struct bonding *bond,
1226 const struct bond_opt_value *newval)
1228 struct list_head *iter;
1229 struct slave *slave;
1231 if (newval->value == bond->params.all_slaves_active)
1233 bond->params.all_slaves_active = newval->value;
1234 bond_for_each_slave(bond, slave, iter) {
1235 if (!bond_is_active_slave(slave)) {
1237 slave->inactive = 0;
1239 slave->inactive = 1;
1246 static int bond_option_min_links_set(struct bonding *bond,
1247 const struct bond_opt_value *newval)
1249 netdev_dbg(bond->dev, "Setting min links value to %llu\n",
1251 bond->params.min_links = newval->value;
1252 bond_set_carrier(bond);
1257 static int bond_option_lp_interval_set(struct bonding *bond,
1258 const struct bond_opt_value *newval)
1260 bond->params.lp_interval = newval->value;
1265 static int bond_option_pps_set(struct bonding *bond,
1266 const struct bond_opt_value *newval)
1268 netdev_dbg(bond->dev, "Setting packets per slave to %llu\n",
1270 bond->params.packets_per_slave = newval->value;
1271 if (newval->value > 0) {
1272 bond->params.reciprocal_packets_per_slave =
1273 reciprocal_value(newval->value);
1275 /* reciprocal_packets_per_slave is unused if
1276 * packets_per_slave is 0 or 1, just initialize it
1278 bond->params.reciprocal_packets_per_slave =
1279 (struct reciprocal_value) { 0 };
1285 static int bond_option_lacp_rate_set(struct bonding *bond,
1286 const struct bond_opt_value *newval)
1288 netdev_dbg(bond->dev, "Setting LACP rate to %s (%llu)\n",
1289 newval->string, newval->value);
1290 bond->params.lacp_fast = newval->value;
1291 bond_3ad_update_lacp_rate(bond);
1296 static int bond_option_ad_select_set(struct bonding *bond,
1297 const struct bond_opt_value *newval)
1299 netdev_dbg(bond->dev, "Setting ad_select to %s (%llu)\n",
1300 newval->string, newval->value);
1301 bond->params.ad_select = newval->value;
1306 static int bond_option_queue_id_set(struct bonding *bond,
1307 const struct bond_opt_value *newval)
1309 struct slave *slave, *update_slave;
1310 struct net_device *sdev;
1311 struct list_head *iter;
1316 /* delim will point to queue id if successful */
1317 delim = strchr(newval->string, ':');
1321 /* Terminate string that points to device name and bump it
1322 * up one, so we can read the queue id there.
1325 if (sscanf(++delim, "%hd\n", &qid) != 1)
1328 /* Check buffer length, valid ifname and queue id */
1329 if (!dev_valid_name(newval->string) ||
1330 qid > bond->dev->real_num_tx_queues)
1333 /* Get the pointer to that interface if it exists */
1334 sdev = __dev_get_by_name(dev_net(bond->dev), newval->string);
1338 /* Search for thes slave and check for duplicate qids */
1339 update_slave = NULL;
1340 bond_for_each_slave(bond, slave, iter) {
1341 if (sdev == slave->dev)
1342 /* We don't need to check the matching
1343 * slave for dups, since we're overwriting it
1345 update_slave = slave;
1346 else if (qid && qid == slave->queue_id) {
1354 /* Actually set the qids for the slave */
1355 update_slave->queue_id = qid;
1361 netdev_dbg(bond->dev, "invalid input for queue_id set\n");
1367 static int bond_option_slaves_set(struct bonding *bond,
1368 const struct bond_opt_value *newval)
1370 char command[IFNAMSIZ + 1] = { 0, };
1371 struct net_device *dev;
1375 sscanf(newval->string, "%16s", command); /* IFNAMSIZ*/
1376 ifname = command + 1;
1377 if ((strlen(command) <= 1) ||
1378 !dev_valid_name(ifname))
1381 dev = __dev_get_by_name(dev_net(bond->dev), ifname);
1383 netdev_dbg(bond->dev, "interface %s does not exist!\n",
1389 switch (command[0]) {
1391 netdev_dbg(bond->dev, "Adding slave %s\n", dev->name);
1392 ret = bond_enslave(bond->dev, dev, NULL);
1396 netdev_dbg(bond->dev, "Removing slave %s\n", dev->name);
1397 ret = bond_release(bond->dev, dev);
1408 netdev_err(bond->dev, "no command found in slaves file - use +ifname or -ifname\n");
1413 static int bond_option_tlb_dynamic_lb_set(struct bonding *bond,
1414 const struct bond_opt_value *newval)
1416 netdev_dbg(bond->dev, "Setting dynamic-lb to %s (%llu)\n",
1417 newval->string, newval->value);
1418 bond->params.tlb_dynamic_lb = newval->value;
1423 static int bond_option_ad_actor_sys_prio_set(struct bonding *bond,
1424 const struct bond_opt_value *newval)
1426 netdev_dbg(bond->dev, "Setting ad_actor_sys_prio to %llu\n",
1429 bond->params.ad_actor_sys_prio = newval->value;
1430 bond_3ad_update_ad_actor_settings(bond);
1435 static int bond_option_ad_actor_system_set(struct bonding *bond,
1436 const struct bond_opt_value *newval)
1438 u8 macaddr[ETH_ALEN];
1441 if (newval->string) {
1442 if (!mac_pton(newval->string, macaddr))
1446 mac = (u8 *)&newval->value;
1449 if (!is_valid_ether_addr(mac))
1452 netdev_dbg(bond->dev, "Setting ad_actor_system to %pM\n", mac);
1453 ether_addr_copy(bond->params.ad_actor_system, mac);
1454 bond_3ad_update_ad_actor_settings(bond);
1459 netdev_err(bond->dev, "Invalid MAC address.\n");
1463 static int bond_option_ad_user_port_key_set(struct bonding *bond,
1464 const struct bond_opt_value *newval)
1466 netdev_dbg(bond->dev, "Setting ad_user_port_key to %llu\n",
1469 bond->params.ad_user_port_key = newval->value;