1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Handle incoming frames
4 * Linux ethernet bridge
10 #include <linux/slab.h>
11 #include <linux/kernel.h>
12 #include <linux/netdevice.h>
13 #include <linux/etherdevice.h>
14 #include <linux/netfilter_bridge.h>
15 #ifdef CONFIG_NETFILTER_FAMILY_BRIDGE
16 #include <net/netfilter/nf_queue.h>
18 #include <linux/neighbour.h>
20 #include <linux/export.h>
21 #include <linux/rculist.h>
22 #include "br_private.h"
23 #include "br_private_tunnel.h"
26 br_netif_receive_skb(struct net *net, struct sock *sk, struct sk_buff *skb)
28 br_drop_fake_rtable(skb);
29 return netif_receive_skb(skb);
32 static int br_pass_frame_up(struct sk_buff *skb)
34 struct net_device *indev, *brdev = BR_INPUT_SKB_CB(skb)->brdev;
35 struct net_bridge *br = netdev_priv(brdev);
36 struct net_bridge_vlan_group *vg;
37 struct pcpu_sw_netstats *brstats = this_cpu_ptr(br->stats);
39 u64_stats_update_begin(&brstats->syncp);
40 brstats->rx_packets++;
41 brstats->rx_bytes += skb->len;
42 u64_stats_update_end(&brstats->syncp);
44 vg = br_vlan_group_rcu(br);
45 /* Bridge is just like any other port. Make sure the
46 * packet is allowed except in promisc modue when someone
47 * may be running packet capture.
49 if (!(brdev->flags & IFF_PROMISC) &&
50 !br_allowed_egress(vg, skb)) {
57 skb = br_handle_vlan(br, NULL, vg, skb);
60 /* update the multicast stats if the packet is IGMP/MLD */
61 br_multicast_count(br, NULL, skb, br_multicast_igmp_type(skb),
64 return NF_HOOK(NFPROTO_BRIDGE, NF_BR_LOCAL_IN,
65 dev_net(indev), NULL, skb, indev, NULL,
66 br_netif_receive_skb);
69 /* note: already called with rcu_read_lock */
70 int br_handle_frame_finish(struct net *net, struct sock *sk, struct sk_buff *skb)
72 struct net_bridge_port *p = br_port_get_rcu(skb->dev);
73 enum br_pkt_type pkt_type = BR_PKT_UNICAST;
74 struct net_bridge_fdb_entry *dst = NULL;
75 struct net_bridge_mdb_entry *mdst;
76 bool local_rcv, mcast_hit = false;
77 struct net_bridge *br;
80 if (!p || p->state == BR_STATE_DISABLED)
83 if (!br_allowed_ingress(p->br, nbp_vlan_group_rcu(p), skb, &vid))
86 nbp_switchdev_frame_mark(p, skb);
88 /* insert into forwarding database after filtering to avoid spoofing */
90 if (p->flags & BR_LEARNING)
91 br_fdb_update(br, p, eth_hdr(skb)->h_source, vid, 0);
93 local_rcv = !!(br->dev->flags & IFF_PROMISC);
94 if (is_multicast_ether_addr(eth_hdr(skb)->h_dest)) {
95 /* by definition the broadcast is also a multicast address */
96 if (is_broadcast_ether_addr(eth_hdr(skb)->h_dest)) {
97 pkt_type = BR_PKT_BROADCAST;
100 pkt_type = BR_PKT_MULTICAST;
101 if (br_multicast_rcv(br, p, skb, vid))
106 if (p->state == BR_STATE_LEARNING)
109 BR_INPUT_SKB_CB(skb)->brdev = br->dev;
110 BR_INPUT_SKB_CB(skb)->src_port_isolated = !!(p->flags & BR_ISOLATED);
112 if (IS_ENABLED(CONFIG_INET) &&
113 (skb->protocol == htons(ETH_P_ARP) ||
114 skb->protocol == htons(ETH_P_RARP))) {
115 br_do_proxy_suppress_arp(skb, br, vid, p);
116 } else if (IS_ENABLED(CONFIG_IPV6) &&
117 skb->protocol == htons(ETH_P_IPV6) &&
118 br_opt_get(br, BROPT_NEIGH_SUPPRESS_ENABLED) &&
119 pskb_may_pull(skb, sizeof(struct ipv6hdr) +
120 sizeof(struct nd_msg)) &&
121 ipv6_hdr(skb)->nexthdr == IPPROTO_ICMPV6) {
122 struct nd_msg *msg, _msg;
124 msg = br_is_nd_neigh_msg(skb, &_msg);
126 br_do_suppress_nd(skb, br, vid, p, msg);
130 case BR_PKT_MULTICAST:
131 mdst = br_mdb_get(br, skb, vid);
132 if ((mdst || BR_INPUT_SKB_CB_MROUTERS_ONLY(skb)) &&
133 br_multicast_querier_exists(br, eth_hdr(skb))) {
134 if ((mdst && mdst->host_joined) ||
135 br_multicast_is_router(br)) {
137 br->dev->stats.multicast++;
142 br->dev->stats.multicast++;
146 dst = br_fdb_find_rcu(br, eth_hdr(skb)->h_dest, vid);
152 unsigned long now = jiffies;
154 if (test_bit(BR_FDB_LOCAL, &dst->flags))
155 return br_pass_frame_up(skb);
157 if (now != dst->used)
159 br_forward(dst->dst, skb, local_rcv, false);
162 br_flood(br, skb, pkt_type, local_rcv, false);
164 br_multicast_flood(mdst, skb, local_rcv, false);
168 return br_pass_frame_up(skb);
176 EXPORT_SYMBOL_GPL(br_handle_frame_finish);
178 static void __br_handle_local_finish(struct sk_buff *skb)
180 struct net_bridge_port *p = br_port_get_rcu(skb->dev);
183 /* check if vlan is allowed, to avoid spoofing */
184 if ((p->flags & BR_LEARNING) &&
185 nbp_state_should_learn(p) &&
186 !br_opt_get(p->br, BROPT_NO_LL_LEARN) &&
187 br_should_learn(p, skb, &vid))
188 br_fdb_update(p->br, p, eth_hdr(skb)->h_source, vid, 0);
191 /* note: already called with rcu_read_lock */
192 static int br_handle_local_finish(struct net *net, struct sock *sk, struct sk_buff *skb)
194 __br_handle_local_finish(skb);
196 /* return 1 to signal the okfn() was called so it's ok to use the skb */
200 static int nf_hook_bridge_pre(struct sk_buff *skb, struct sk_buff **pskb)
202 #ifdef CONFIG_NETFILTER_FAMILY_BRIDGE
203 struct nf_hook_entries *e = NULL;
204 struct nf_hook_state state;
205 unsigned int verdict, i;
209 net = dev_net(skb->dev);
210 #ifdef HAVE_JUMP_LABEL
211 if (!static_key_false(&nf_hooks_needed[NFPROTO_BRIDGE][NF_BR_PRE_ROUTING]))
215 e = rcu_dereference(net->nf.hooks_bridge[NF_BR_PRE_ROUTING]);
219 nf_hook_state_init(&state, NF_BR_PRE_ROUTING,
220 NFPROTO_BRIDGE, skb->dev, NULL, NULL,
221 net, br_handle_frame_finish);
223 for (i = 0; i < e->num_hook_entries; i++) {
224 verdict = nf_hook_entry_hookfn(&e->hooks[i], skb, &state);
225 switch (verdict & NF_VERDICT_MASK) {
227 if (BR_INPUT_SKB_CB(skb)->br_netfilter_broute) {
229 return RX_HANDLER_PASS;
234 return RX_HANDLER_CONSUMED;
236 ret = nf_queue(skb, &state, i, verdict);
239 return RX_HANDLER_CONSUMED;
240 default: /* STOLEN */
241 return RX_HANDLER_CONSUMED;
245 net = dev_net(skb->dev);
246 br_handle_frame_finish(net, NULL, skb);
248 br_handle_frame_finish(dev_net(skb->dev), NULL, skb);
250 return RX_HANDLER_CONSUMED;
254 * Return NULL if skb is handled
255 * note: already called with rcu_read_lock
257 rx_handler_result_t br_handle_frame(struct sk_buff **pskb)
259 struct net_bridge_port *p;
260 struct sk_buff *skb = *pskb;
261 const unsigned char *dest = eth_hdr(skb)->h_dest;
263 if (unlikely(skb->pkt_type == PACKET_LOOPBACK))
264 return RX_HANDLER_PASS;
266 if (!is_valid_ether_addr(eth_hdr(skb)->h_source))
269 skb = skb_share_check(skb, GFP_ATOMIC);
271 return RX_HANDLER_CONSUMED;
273 memset(skb->cb, 0, sizeof(struct br_input_skb_cb));
275 p = br_port_get_rcu(skb->dev);
276 if (p->flags & BR_VLAN_TUNNEL) {
277 if (br_handle_ingress_vlan_tunnel(skb, p,
278 nbp_vlan_group_rcu(p)))
282 if (unlikely(is_link_local_ether_addr(dest))) {
283 u16 fwd_mask = p->br->group_fwd_mask_required;
286 * See IEEE 802.1D Table 7-10 Reserved addresses
289 * Bridge Group Address 01-80-C2-00-00-00
290 * (MAC Control) 802.3 01-80-C2-00-00-01
291 * (Link Aggregation) 802.3 01-80-C2-00-00-02
292 * 802.1X PAE address 01-80-C2-00-00-03
294 * 802.1AB LLDP 01-80-C2-00-00-0E
296 * Others reserved for future standardization
298 fwd_mask |= p->group_fwd_mask;
300 case 0x00: /* Bridge Group Address */
301 /* If STP is turned off,
302 then must forward to keep loop detection */
303 if (p->br->stp_enabled == BR_NO_STP ||
304 fwd_mask & (1u << dest[5]))
307 __br_handle_local_finish(skb);
308 return RX_HANDLER_PASS;
310 case 0x01: /* IEEE MAC (Pause) */
313 case 0x0E: /* 802.1AB LLDP */
314 fwd_mask |= p->br->group_fwd_mask;
315 if (fwd_mask & (1u << dest[5]))
318 __br_handle_local_finish(skb);
319 return RX_HANDLER_PASS;
322 /* Allow selective forwarding for most other protocols */
323 fwd_mask |= p->br->group_fwd_mask;
324 if (fwd_mask & (1u << dest[5]))
328 /* The else clause should be hit when nf_hook():
329 * - returns < 0 (drop/error)
330 * - returns = 0 (stolen/nf_queue)
331 * Thus return 1 from the okfn() to signal the skb is ok to pass
333 if (NF_HOOK(NFPROTO_BRIDGE, NF_BR_LOCAL_IN,
334 dev_net(skb->dev), NULL, skb, skb->dev, NULL,
335 br_handle_local_finish) == 1) {
336 return RX_HANDLER_PASS;
338 return RX_HANDLER_CONSUMED;
344 case BR_STATE_FORWARDING:
345 case BR_STATE_LEARNING:
346 if (ether_addr_equal(p->br->dev->dev_addr, dest))
347 skb->pkt_type = PACKET_HOST;
349 return nf_hook_bridge_pre(skb, pskb);
354 return RX_HANDLER_CONSUMED;