2 * Bridge netlink control interface
5 * Stephen Hemminger <shemminger@osdl.org>
7 * This program is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU General Public License
9 * as published by the Free Software Foundation; either version
10 * 2 of the License, or (at your option) any later version.
13 #include <linux/kernel.h>
14 #include <linux/slab.h>
15 #include <linux/etherdevice.h>
16 #include <net/rtnetlink.h>
17 #include <net/net_namespace.h>
19 #include <uapi/linux/if_bridge.h>
21 #include "br_private.h"
22 #include "br_private_stp.h"
24 static inline size_t br_port_info_size(void)
26 return nla_total_size(1) /* IFLA_BRPORT_STATE */
27 + nla_total_size(2) /* IFLA_BRPORT_PRIORITY */
28 + nla_total_size(4) /* IFLA_BRPORT_COST */
29 + nla_total_size(1) /* IFLA_BRPORT_MODE */
30 + nla_total_size(1) /* IFLA_BRPORT_GUARD */
31 + nla_total_size(1) /* IFLA_BRPORT_PROTECT */
32 + nla_total_size(1) /* IFLA_BRPORT_FAST_LEAVE */
33 + nla_total_size(1) /* IFLA_BRPORT_LEARNING */
34 + nla_total_size(1) /* IFLA_BRPORT_UNICAST_FLOOD */
38 static inline size_t br_nlmsg_size(void)
40 return NLMSG_ALIGN(sizeof(struct ifinfomsg))
41 + nla_total_size(IFNAMSIZ) /* IFLA_IFNAME */
42 + nla_total_size(MAX_ADDR_LEN) /* IFLA_ADDRESS */
43 + nla_total_size(4) /* IFLA_MASTER */
44 + nla_total_size(4) /* IFLA_MTU */
45 + nla_total_size(4) /* IFLA_LINK */
46 + nla_total_size(1) /* IFLA_OPERSTATE */
47 + nla_total_size(br_port_info_size()); /* IFLA_PROTINFO */
50 static int br_port_fill_attrs(struct sk_buff *skb,
51 const struct net_bridge_port *p)
53 u8 mode = !!(p->flags & BR_HAIRPIN_MODE);
55 if (nla_put_u8(skb, IFLA_BRPORT_STATE, p->state) ||
56 nla_put_u16(skb, IFLA_BRPORT_PRIORITY, p->priority) ||
57 nla_put_u32(skb, IFLA_BRPORT_COST, p->path_cost) ||
58 nla_put_u8(skb, IFLA_BRPORT_MODE, mode) ||
59 nla_put_u8(skb, IFLA_BRPORT_GUARD, !!(p->flags & BR_BPDU_GUARD)) ||
60 nla_put_u8(skb, IFLA_BRPORT_PROTECT, !!(p->flags & BR_ROOT_BLOCK)) ||
61 nla_put_u8(skb, IFLA_BRPORT_FAST_LEAVE, !!(p->flags & BR_MULTICAST_FAST_LEAVE)) ||
62 nla_put_u8(skb, IFLA_BRPORT_LEARNING, !!(p->flags & BR_LEARNING)) ||
63 nla_put_u8(skb, IFLA_BRPORT_UNICAST_FLOOD, !!(p->flags & BR_FLOOD)) ||
64 nla_put_u8(skb, IFLA_BRPORT_PROXYARP, !!(p->flags & BR_PROXYARP)))
71 * Create one netlink message for one interface
72 * Contains port and master info as well as carrier and bridge state.
74 static int br_fill_ifinfo(struct sk_buff *skb,
75 const struct net_bridge_port *port,
76 u32 pid, u32 seq, int event, unsigned int flags,
77 u32 filter_mask, const struct net_device *dev)
79 const struct net_bridge *br;
80 struct ifinfomsg *hdr;
82 u8 operstate = netif_running(dev) ? dev->operstate : IF_OPER_DOWN;
87 br = netdev_priv(dev);
89 br_debug(br, "br_fill_info event %d port %s master %s\n",
90 event, dev->name, br->dev->name);
92 nlh = nlmsg_put(skb, pid, seq, event, sizeof(*hdr), flags);
96 hdr = nlmsg_data(nlh);
97 hdr->ifi_family = AF_BRIDGE;
99 hdr->ifi_type = dev->type;
100 hdr->ifi_index = dev->ifindex;
101 hdr->ifi_flags = dev_get_flags(dev);
104 if (nla_put_string(skb, IFLA_IFNAME, dev->name) ||
105 nla_put_u32(skb, IFLA_MASTER, br->dev->ifindex) ||
106 nla_put_u32(skb, IFLA_MTU, dev->mtu) ||
107 nla_put_u8(skb, IFLA_OPERSTATE, operstate) ||
109 nla_put(skb, IFLA_ADDRESS, dev->addr_len, dev->dev_addr)) ||
110 (dev->ifindex != dev->iflink &&
111 nla_put_u32(skb, IFLA_LINK, dev->iflink)))
112 goto nla_put_failure;
114 if (event == RTM_NEWLINK && port) {
116 = nla_nest_start(skb, IFLA_PROTINFO | NLA_F_NESTED);
118 if (nest == NULL || br_port_fill_attrs(skb, port) < 0)
119 goto nla_put_failure;
120 nla_nest_end(skb, nest);
123 /* Check if the VID information is requested */
124 if (filter_mask & RTEXT_FILTER_BRVLAN) {
126 const struct net_port_vlans *pv;
127 struct bridge_vlan_info vinfo;
132 pv = nbp_get_vlan_info(port);
134 pv = br_get_vlan_info(br);
136 if (!pv || bitmap_empty(pv->vlan_bitmap, VLAN_N_VID))
139 af = nla_nest_start(skb, IFLA_AF_SPEC);
141 goto nla_put_failure;
143 pvid = br_get_pvid(pv);
144 for_each_set_bit(vid, pv->vlan_bitmap, VLAN_N_VID) {
148 vinfo.flags |= BRIDGE_VLAN_INFO_PVID;
150 if (test_bit(vid, pv->untagged_bitmap))
151 vinfo.flags |= BRIDGE_VLAN_INFO_UNTAGGED;
153 if (nla_put(skb, IFLA_BRIDGE_VLAN_INFO,
154 sizeof(vinfo), &vinfo))
155 goto nla_put_failure;
158 nla_nest_end(skb, af);
162 return nlmsg_end(skb, nlh);
165 nlmsg_cancel(skb, nlh);
170 * Notify listeners of a change in port information
172 void br_ifinfo_notify(int event, struct net_bridge_port *port)
181 net = dev_net(port->dev);
182 br_debug(port->br, "port %u(%s) event %d\n",
183 (unsigned int)port->port_no, port->dev->name, event);
185 skb = nlmsg_new(br_nlmsg_size(), GFP_ATOMIC);
189 err = br_fill_ifinfo(skb, port, 0, 0, event, 0, 0, port->dev);
191 /* -EMSGSIZE implies BUG in br_nlmsg_size() */
192 WARN_ON(err == -EMSGSIZE);
196 rtnl_notify(skb, net, 0, RTNLGRP_LINK, NULL, GFP_ATOMIC);
199 rtnl_set_sk_err(net, RTNLGRP_LINK, err);
204 * Dump information about all ports, in response to GETLINK
206 int br_getlink(struct sk_buff *skb, u32 pid, u32 seq,
207 struct net_device *dev, u32 filter_mask)
210 struct net_bridge_port *port = br_port_get_rtnl(dev);
212 if (!port && !(filter_mask & RTEXT_FILTER_BRVLAN))
215 err = br_fill_ifinfo(skb, port, pid, seq, RTM_NEWLINK, NLM_F_MULTI,
221 static const struct nla_policy ifla_br_policy[IFLA_MAX+1] = {
222 [IFLA_BRIDGE_FLAGS] = { .type = NLA_U16 },
223 [IFLA_BRIDGE_MODE] = { .type = NLA_U16 },
224 [IFLA_BRIDGE_VLAN_INFO] = { .type = NLA_BINARY,
225 .len = sizeof(struct bridge_vlan_info), },
228 static int br_afspec(struct net_bridge *br,
229 struct net_bridge_port *p,
230 struct nlattr *af_spec,
233 struct nlattr *tb[IFLA_BRIDGE_MAX+1];
236 err = nla_parse_nested(tb, IFLA_BRIDGE_MAX, af_spec, ifla_br_policy);
240 if (tb[IFLA_BRIDGE_VLAN_INFO]) {
241 struct bridge_vlan_info *vinfo;
243 vinfo = nla_data(tb[IFLA_BRIDGE_VLAN_INFO]);
245 if (!vinfo->vid || vinfo->vid >= VLAN_VID_MASK)
251 err = nbp_vlan_add(p, vinfo->vid, vinfo->flags);
255 if (vinfo->flags & BRIDGE_VLAN_INFO_MASTER)
256 err = br_vlan_add(p->br, vinfo->vid,
259 err = br_vlan_add(br, vinfo->vid, vinfo->flags);
265 nbp_vlan_delete(p, vinfo->vid);
266 if (vinfo->flags & BRIDGE_VLAN_INFO_MASTER)
267 br_vlan_delete(p->br, vinfo->vid);
269 br_vlan_delete(br, vinfo->vid);
277 static const struct nla_policy br_port_policy[IFLA_BRPORT_MAX + 1] = {
278 [IFLA_BRPORT_STATE] = { .type = NLA_U8 },
279 [IFLA_BRPORT_COST] = { .type = NLA_U32 },
280 [IFLA_BRPORT_PRIORITY] = { .type = NLA_U16 },
281 [IFLA_BRPORT_MODE] = { .type = NLA_U8 },
282 [IFLA_BRPORT_GUARD] = { .type = NLA_U8 },
283 [IFLA_BRPORT_PROTECT] = { .type = NLA_U8 },
284 [IFLA_BRPORT_FAST_LEAVE]= { .type = NLA_U8 },
285 [IFLA_BRPORT_LEARNING] = { .type = NLA_U8 },
286 [IFLA_BRPORT_UNICAST_FLOOD] = { .type = NLA_U8 },
289 /* Change the state of the port and notify spanning tree */
290 static int br_set_port_state(struct net_bridge_port *p, u8 state)
292 if (state > BR_STATE_BLOCKING)
295 /* if kernel STP is running, don't allow changes */
296 if (p->br->stp_enabled == BR_KERNEL_STP)
299 /* if device is not up, change is not allowed
300 * if link is not present, only allowable state is disabled
302 if (!netif_running(p->dev) ||
303 (!netif_oper_up(p->dev) && state != BR_STATE_DISABLED))
306 br_set_state(p, state);
308 br_port_state_selection(p->br);
312 /* Set/clear or port flags based on attribute */
313 static void br_set_port_flag(struct net_bridge_port *p, struct nlattr *tb[],
314 int attrtype, unsigned long mask)
317 u8 flag = nla_get_u8(tb[attrtype]);
325 /* Process bridge protocol info on port */
326 static int br_setport(struct net_bridge_port *p, struct nlattr *tb[])
329 unsigned long old_flags = p->flags;
331 br_set_port_flag(p, tb, IFLA_BRPORT_MODE, BR_HAIRPIN_MODE);
332 br_set_port_flag(p, tb, IFLA_BRPORT_GUARD, BR_BPDU_GUARD);
333 br_set_port_flag(p, tb, IFLA_BRPORT_FAST_LEAVE, BR_MULTICAST_FAST_LEAVE);
334 br_set_port_flag(p, tb, IFLA_BRPORT_PROTECT, BR_ROOT_BLOCK);
335 br_set_port_flag(p, tb, IFLA_BRPORT_LEARNING, BR_LEARNING);
336 br_set_port_flag(p, tb, IFLA_BRPORT_UNICAST_FLOOD, BR_FLOOD);
337 br_set_port_flag(p, tb, IFLA_BRPORT_PROXYARP, BR_PROXYARP);
339 if (tb[IFLA_BRPORT_COST]) {
340 err = br_stp_set_path_cost(p, nla_get_u32(tb[IFLA_BRPORT_COST]));
345 if (tb[IFLA_BRPORT_PRIORITY]) {
346 err = br_stp_set_port_priority(p, nla_get_u16(tb[IFLA_BRPORT_PRIORITY]));
351 if (tb[IFLA_BRPORT_STATE]) {
352 err = br_set_port_state(p, nla_get_u8(tb[IFLA_BRPORT_STATE]));
357 br_port_flags_change(p, old_flags ^ p->flags);
361 /* Change state and parameters on port. */
362 int br_setlink(struct net_device *dev, struct nlmsghdr *nlh)
364 struct nlattr *protinfo;
365 struct nlattr *afspec;
366 struct net_bridge_port *p;
367 struct nlattr *tb[IFLA_BRPORT_MAX + 1];
370 protinfo = nlmsg_find_attr(nlh, sizeof(struct ifinfomsg), IFLA_PROTINFO);
371 afspec = nlmsg_find_attr(nlh, sizeof(struct ifinfomsg), IFLA_AF_SPEC);
372 if (!protinfo && !afspec)
375 p = br_port_get_rtnl(dev);
376 /* We want to accept dev as bridge itself if the AF_SPEC
377 * is set to see if someone is setting vlan info on the bridge
383 if (protinfo->nla_type & NLA_F_NESTED) {
384 err = nla_parse_nested(tb, IFLA_BRPORT_MAX,
385 protinfo, br_port_policy);
389 spin_lock_bh(&p->br->lock);
390 err = br_setport(p, tb);
391 spin_unlock_bh(&p->br->lock);
393 /* Binary compatibility with old RSTP */
394 if (nla_len(protinfo) < sizeof(u8))
397 spin_lock_bh(&p->br->lock);
398 err = br_set_port_state(p, nla_get_u8(protinfo));
399 spin_unlock_bh(&p->br->lock);
406 err = br_afspec((struct net_bridge *)netdev_priv(dev), p,
407 afspec, RTM_SETLINK);
411 br_ifinfo_notify(RTM_NEWLINK, p);
417 /* Delete port information */
418 int br_dellink(struct net_device *dev, struct nlmsghdr *nlh)
420 struct nlattr *afspec;
421 struct net_bridge_port *p;
424 afspec = nlmsg_find_attr(nlh, sizeof(struct ifinfomsg), IFLA_AF_SPEC);
428 p = br_port_get_rtnl(dev);
429 /* We want to accept dev as bridge itself as well */
430 if (!p && !(dev->priv_flags & IFF_EBRIDGE))
433 err = br_afspec((struct net_bridge *)netdev_priv(dev), p,
434 afspec, RTM_DELLINK);
438 static int br_validate(struct nlattr *tb[], struct nlattr *data[])
440 if (tb[IFLA_ADDRESS]) {
441 if (nla_len(tb[IFLA_ADDRESS]) != ETH_ALEN)
443 if (!is_valid_ether_addr(nla_data(tb[IFLA_ADDRESS])))
444 return -EADDRNOTAVAIL;
450 static int br_dev_newlink(struct net *src_net, struct net_device *dev,
451 struct nlattr *tb[], struct nlattr *data[])
453 struct net_bridge *br = netdev_priv(dev);
455 if (tb[IFLA_ADDRESS]) {
456 spin_lock_bh(&br->lock);
457 br_stp_change_bridge_id(br, nla_data(tb[IFLA_ADDRESS]));
458 spin_unlock_bh(&br->lock);
461 return register_netdevice(dev);
464 static int br_port_slave_changelink(struct net_device *brdev,
465 struct net_device *dev,
467 struct nlattr *data[])
471 return br_setport(br_port_get_rtnl(dev), data);
474 static int br_port_fill_slave_info(struct sk_buff *skb,
475 const struct net_device *brdev,
476 const struct net_device *dev)
478 return br_port_fill_attrs(skb, br_port_get_rtnl(dev));
481 static size_t br_port_get_slave_size(const struct net_device *brdev,
482 const struct net_device *dev)
484 return br_port_info_size();
487 static const struct nla_policy br_policy[IFLA_BR_MAX + 1] = {
488 [IFLA_BR_FORWARD_DELAY] = { .type = NLA_U32 },
489 [IFLA_BR_HELLO_TIME] = { .type = NLA_U32 },
490 [IFLA_BR_MAX_AGE] = { .type = NLA_U32 },
493 static int br_changelink(struct net_device *brdev, struct nlattr *tb[],
494 struct nlattr *data[])
496 struct net_bridge *br = netdev_priv(brdev);
502 if (data[IFLA_BR_FORWARD_DELAY]) {
503 err = br_set_forward_delay(br, nla_get_u32(data[IFLA_BR_FORWARD_DELAY]));
508 if (data[IFLA_BR_HELLO_TIME]) {
509 err = br_set_hello_time(br, nla_get_u32(data[IFLA_BR_HELLO_TIME]));
514 if (data[IFLA_BR_MAX_AGE]) {
515 err = br_set_max_age(br, nla_get_u32(data[IFLA_BR_MAX_AGE]));
523 static size_t br_get_size(const struct net_device *brdev)
525 return nla_total_size(sizeof(u32)) + /* IFLA_BR_FORWARD_DELAY */
526 nla_total_size(sizeof(u32)) + /* IFLA_BR_HELLO_TIME */
527 nla_total_size(sizeof(u32)) + /* IFLA_BR_MAX_AGE */
531 static int br_fill_info(struct sk_buff *skb, const struct net_device *brdev)
533 struct net_bridge *br = netdev_priv(brdev);
534 u32 forward_delay = jiffies_to_clock_t(br->forward_delay);
535 u32 hello_time = jiffies_to_clock_t(br->hello_time);
536 u32 age_time = jiffies_to_clock_t(br->max_age);
538 if (nla_put_u32(skb, IFLA_BR_FORWARD_DELAY, forward_delay) ||
539 nla_put_u32(skb, IFLA_BR_HELLO_TIME, hello_time) ||
540 nla_put_u32(skb, IFLA_BR_MAX_AGE, age_time))
546 static size_t br_get_link_af_size(const struct net_device *dev)
548 struct net_port_vlans *pv;
550 if (br_port_exists(dev))
551 pv = nbp_get_vlan_info(br_port_get_rtnl(dev));
552 else if (dev->priv_flags & IFF_EBRIDGE)
553 pv = br_get_vlan_info((struct net_bridge *)netdev_priv(dev));
560 /* Each VLAN is returned in bridge_vlan_info along with flags */
561 return pv->num_vlans * nla_total_size(sizeof(struct bridge_vlan_info));
564 static struct rtnl_af_ops br_af_ops = {
566 .get_link_af_size = br_get_link_af_size,
569 struct rtnl_link_ops br_link_ops __read_mostly = {
571 .priv_size = sizeof(struct net_bridge),
572 .setup = br_dev_setup,
573 .maxtype = IFLA_BRPORT_MAX,
575 .validate = br_validate,
576 .newlink = br_dev_newlink,
577 .changelink = br_changelink,
578 .dellink = br_dev_delete,
579 .get_size = br_get_size,
580 .fill_info = br_fill_info,
582 .slave_maxtype = IFLA_BRPORT_MAX,
583 .slave_policy = br_port_policy,
584 .slave_changelink = br_port_slave_changelink,
585 .get_slave_size = br_port_get_slave_size,
586 .fill_slave_info = br_port_fill_slave_info,
589 int __init br_netlink_init(void)
594 rtnl_af_register(&br_af_ops);
596 err = rtnl_link_register(&br_link_ops);
603 rtnl_af_unregister(&br_af_ops);
608 void br_netlink_fini(void)
611 rtnl_af_unregister(&br_af_ops);
612 rtnl_link_unregister(&br_link_ops);