net/bridge/br_mdb.c
Source file repositories/reference/linux-study-clean/net/bridge/br_mdb.c
File Facts
- System
- Linux kernel
- Corpus path
net/bridge/br_mdb.c- Extension
.c- Size
- 43053 bytes
- Lines
- 1723
- Domain
- Networking Core
- Bucket
- Sockets, Protocols, Packet Path, And Network Policy
- Inferred role
- Networking Core: implementation source
- Status
- source implementation candidate
Why This File Exists
Networking stack implementation surface: socket APIs, protocol dispatch, packet flow, routing, filtering, and network namespaces.
- Networking stack implementation surface: socket APIs, protocol dispatch, packet flow, routing, filtering, and network namespaces.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/err.hlinux/igmp.hlinux/kernel.hlinux/netdevice.hlinux/rculist.hlinux/skbuff.hlinux/if_ether.hnet/ip.hnet/netlink.hnet/switchdev.hnet/ipv6.hnet/addrconf.hbr_private.h
Detected Declarations
struct br_mdb_flush_descfunction br_ip4_rports_get_timerfunction br_ip6_rports_get_timerfunction __br_rports_one_sizefunction br_rports_sizefunction br_rports_fill_infofunction list_for_each_entry_rcufunction __mdb_entry_fill_flagsfunction __mdb_entry_to_br_ipfunction __mdb_fill_srcsfunction hlist_for_each_entry_rcufunction htonsfunction __mdb_fill_infofunction br_mdb_fill_infofunction hlist_for_each_entry_rcufunction br_mdb_dumpfunction nlmsg_populate_mdb_fillfunction rtnl_mdb_nlmsg_pg_sizefunction hlist_for_each_entryfunction rtnl_mdb_nlmsg_sizefunction __br_mdb_notifyfunction br_mdb_notifyfunction br_mdb_flag_change_notifyfunction nlmsg_populate_rtr_fillfunction rtnl_rtr_nlmsg_sizefunction br_rtr_notifyfunction is_valid_mdb_sourcefunction __br_mdb_choose_contextfunction br_mdb_replace_group_sgfunction br_mdb_add_group_sgfunction br_mdb_add_group_src_fwdfunction br_mdb_add_group_srcfunction br_mdb_del_group_srcfunction br_mdb_add_group_srcsfunction br_mdb_replace_group_srcsfunction hlist_for_each_entry_safefunction br_mdb_replace_group_star_gfunction br_mdb_add_group_star_gfunction br_mdb_add_groupfunction __br_mdb_addfunction br_mdb_config_src_entry_initfunction br_mdb_config_src_list_initfunction nla_for_each_nestedfunction br_mdb_config_src_list_finifunction br_mdb_config_attrs_initfunction br_mdb_config_initfunction br_mdb_config_finifunction br_mdb_add
Annotated Snippet
struct br_mdb_flush_desc {
u32 port_ifindex;
u16 vid;
u8 rt_protocol;
u8 state;
u8 state_mask;
};
static const struct nla_policy br_mdbe_attrs_del_bulk_pol[MDBE_ATTR_MAX + 1] = {
[MDBE_ATTR_RTPROT] = NLA_POLICY_MIN(NLA_U8, RTPROT_STATIC),
[MDBE_ATTR_STATE_MASK] = NLA_POLICY_MASK(NLA_U8, MDB_PERMANENT),
};
static int br_mdb_flush_desc_init(struct br_mdb_flush_desc *desc,
struct nlattr *tb[],
struct netlink_ext_ack *extack)
{
struct br_mdb_entry *entry = nla_data(tb[MDBA_SET_ENTRY]);
struct nlattr *mdbe_attrs[MDBE_ATTR_MAX + 1];
int err;
desc->port_ifindex = entry->ifindex;
desc->vid = entry->vid;
desc->state = entry->state;
if (!tb[MDBA_SET_ENTRY_ATTRS])
return 0;
err = nla_parse_nested(mdbe_attrs, MDBE_ATTR_MAX,
tb[MDBA_SET_ENTRY_ATTRS],
br_mdbe_attrs_del_bulk_pol, extack);
if (err)
return err;
if (mdbe_attrs[MDBE_ATTR_STATE_MASK])
desc->state_mask = nla_get_u8(mdbe_attrs[MDBE_ATTR_STATE_MASK]);
if (mdbe_attrs[MDBE_ATTR_RTPROT])
desc->rt_protocol = nla_get_u8(mdbe_attrs[MDBE_ATTR_RTPROT]);
return 0;
}
static void br_mdb_flush_host(struct net_bridge *br,
struct net_bridge_mdb_entry *mp,
const struct br_mdb_flush_desc *desc)
{
u8 state;
if (desc->port_ifindex && desc->port_ifindex != br->dev->ifindex)
return;
if (desc->rt_protocol)
return;
state = br_group_is_l2(&mp->addr) ? MDB_PERMANENT : 0;
if (desc->state_mask && (state & desc->state_mask) != desc->state)
return;
br_multicast_host_leave(mp, true);
if (!mp->ports && netif_running(br->dev))
mod_timer(&mp->timer, jiffies);
}
static void br_mdb_flush_pgs(struct net_bridge *br,
struct net_bridge_mdb_entry *mp,
const struct br_mdb_flush_desc *desc)
{
struct net_bridge_port_group __rcu **pp;
struct net_bridge_port_group *p;
for (pp = &mp->ports; (p = mlock_dereference(*pp, br)) != NULL;) {
u8 state;
if (desc->port_ifindex &&
desc->port_ifindex != p->key.port->dev->ifindex) {
pp = &p->next;
continue;
}
if (desc->rt_protocol && desc->rt_protocol != p->rt_protocol) {
pp = &p->next;
continue;
}
state = p->flags & MDB_PG_FLAGS_PERMANENT ? MDB_PERMANENT : 0;
if (desc->state_mask &&
(state & desc->state_mask) != desc->state) {
pp = &p->next;
continue;
Annotation
- Immediate include surface: `linux/err.h`, `linux/igmp.h`, `linux/kernel.h`, `linux/netdevice.h`, `linux/rculist.h`, `linux/skbuff.h`, `linux/if_ether.h`, `net/ip.h`.
- Detected declarations: `struct br_mdb_flush_desc`, `function br_ip4_rports_get_timer`, `function br_ip6_rports_get_timer`, `function __br_rports_one_size`, `function br_rports_size`, `function br_rports_fill_info`, `function list_for_each_entry_rcu`, `function __mdb_entry_fill_flags`, `function __mdb_entry_to_br_ip`, `function __mdb_fill_srcs`.
- Atlas domain: Networking Core / Sockets, Protocols, Packet Path, And Network Policy.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.