1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * Handle incoming frames
4 * Linux ethernet bridge
7 * Lennert Buytenhek <buytenh@gnu.org>
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
;
81 if (!p
|| p
->state
== BR_STATE_DISABLED
)
85 if (!br_allowed_ingress(p
->br
, nbp_vlan_group_rcu(p
), skb
, &vid
,
89 nbp_switchdev_frame_mark(p
, skb
);
91 /* insert into forwarding database after filtering to avoid spoofing */
93 if (p
->flags
& BR_LEARNING
)
94 br_fdb_update(br
, p
, eth_hdr(skb
)->h_source
, vid
, 0);
96 local_rcv
= !!(br
->dev
->flags
& IFF_PROMISC
);
97 if (is_multicast_ether_addr(eth_hdr(skb
)->h_dest
)) {
98 /* by definition the broadcast is also a multicast address */
99 if (is_broadcast_ether_addr(eth_hdr(skb
)->h_dest
)) {
100 pkt_type
= BR_PKT_BROADCAST
;
103 pkt_type
= BR_PKT_MULTICAST
;
104 if (br_multicast_rcv(br
, p
, skb
, vid
))
109 if (state
== BR_STATE_LEARNING
)
112 BR_INPUT_SKB_CB(skb
)->brdev
= br
->dev
;
113 BR_INPUT_SKB_CB(skb
)->src_port_isolated
= !!(p
->flags
& BR_ISOLATED
);
115 if (IS_ENABLED(CONFIG_INET
) &&
116 (skb
->protocol
== htons(ETH_P_ARP
) ||
117 skb
->protocol
== htons(ETH_P_RARP
))) {
118 br_do_proxy_suppress_arp(skb
, br
, vid
, p
);
119 } else if (IS_ENABLED(CONFIG_IPV6
) &&
120 skb
->protocol
== htons(ETH_P_IPV6
) &&
121 br_opt_get(br
, BROPT_NEIGH_SUPPRESS_ENABLED
) &&
122 pskb_may_pull(skb
, sizeof(struct ipv6hdr
) +
123 sizeof(struct nd_msg
)) &&
124 ipv6_hdr(skb
)->nexthdr
== IPPROTO_ICMPV6
) {
125 struct nd_msg
*msg
, _msg
;
127 msg
= br_is_nd_neigh_msg(skb
, &_msg
);
129 br_do_suppress_nd(skb
, br
, vid
, p
, msg
);
133 case BR_PKT_MULTICAST
:
134 mdst
= br_mdb_get(br
, skb
, vid
);
135 if ((mdst
|| BR_INPUT_SKB_CB_MROUTERS_ONLY(skb
)) &&
136 br_multicast_querier_exists(br
, eth_hdr(skb
))) {
137 if ((mdst
&& mdst
->host_joined
) ||
138 br_multicast_is_router(br
)) {
140 br
->dev
->stats
.multicast
++;
145 br
->dev
->stats
.multicast
++;
149 dst
= br_fdb_find_rcu(br
, eth_hdr(skb
)->h_dest
, vid
);
155 unsigned long now
= jiffies
;
157 if (test_bit(BR_FDB_LOCAL
, &dst
->flags
))
158 return br_pass_frame_up(skb
);
160 if (now
!= dst
->used
)
162 br_forward(dst
->dst
, skb
, local_rcv
, false);
165 br_flood(br
, skb
, pkt_type
, local_rcv
, false);
167 br_multicast_flood(mdst
, skb
, local_rcv
, false);
171 return br_pass_frame_up(skb
);
179 EXPORT_SYMBOL_GPL(br_handle_frame_finish
);
181 static void __br_handle_local_finish(struct sk_buff
*skb
)
183 struct net_bridge_port
*p
= br_port_get_rcu(skb
->dev
);
186 /* check if vlan is allowed, to avoid spoofing */
187 if ((p
->flags
& BR_LEARNING
) &&
188 nbp_state_should_learn(p
) &&
189 !br_opt_get(p
->br
, BROPT_NO_LL_LEARN
) &&
190 br_should_learn(p
, skb
, &vid
))
191 br_fdb_update(p
->br
, p
, eth_hdr(skb
)->h_source
, vid
, 0);
194 /* note: already called with rcu_read_lock */
195 static int br_handle_local_finish(struct net
*net
, struct sock
*sk
, struct sk_buff
*skb
)
197 __br_handle_local_finish(skb
);
199 /* return 1 to signal the okfn() was called so it's ok to use the skb */
203 static int nf_hook_bridge_pre(struct sk_buff
*skb
, struct sk_buff
**pskb
)
205 #ifdef CONFIG_NETFILTER_FAMILY_BRIDGE
206 struct nf_hook_entries
*e
= NULL
;
207 struct nf_hook_state state
;
208 unsigned int verdict
, i
;
212 net
= dev_net(skb
->dev
);
213 #ifdef HAVE_JUMP_LABEL
214 if (!static_key_false(&nf_hooks_needed
[NFPROTO_BRIDGE
][NF_BR_PRE_ROUTING
]))
218 e
= rcu_dereference(net
->nf
.hooks_bridge
[NF_BR_PRE_ROUTING
]);
222 nf_hook_state_init(&state
, NF_BR_PRE_ROUTING
,
223 NFPROTO_BRIDGE
, skb
->dev
, NULL
, NULL
,
224 net
, br_handle_frame_finish
);
226 for (i
= 0; i
< e
->num_hook_entries
; i
++) {
227 verdict
= nf_hook_entry_hookfn(&e
->hooks
[i
], skb
, &state
);
228 switch (verdict
& NF_VERDICT_MASK
) {
230 if (BR_INPUT_SKB_CB(skb
)->br_netfilter_broute
) {
232 return RX_HANDLER_PASS
;
237 return RX_HANDLER_CONSUMED
;
239 ret
= nf_queue(skb
, &state
, i
, verdict
);
242 return RX_HANDLER_CONSUMED
;
243 default: /* STOLEN */
244 return RX_HANDLER_CONSUMED
;
248 net
= dev_net(skb
->dev
);
249 br_handle_frame_finish(net
, NULL
, skb
);
251 br_handle_frame_finish(dev_net(skb
->dev
), NULL
, skb
);
253 return RX_HANDLER_CONSUMED
;
257 * Return NULL if skb is handled
258 * note: already called with rcu_read_lock
260 rx_handler_result_t
br_handle_frame(struct sk_buff
**pskb
)
262 struct net_bridge_port
*p
;
263 struct sk_buff
*skb
= *pskb
;
264 const unsigned char *dest
= eth_hdr(skb
)->h_dest
;
266 if (unlikely(skb
->pkt_type
== PACKET_LOOPBACK
))
267 return RX_HANDLER_PASS
;
269 if (!is_valid_ether_addr(eth_hdr(skb
)->h_source
))
272 skb
= skb_share_check(skb
, GFP_ATOMIC
);
274 return RX_HANDLER_CONSUMED
;
276 memset(skb
->cb
, 0, sizeof(struct br_input_skb_cb
));
278 p
= br_port_get_rcu(skb
->dev
);
279 if (p
->flags
& BR_VLAN_TUNNEL
) {
280 if (br_handle_ingress_vlan_tunnel(skb
, p
,
281 nbp_vlan_group_rcu(p
)))
285 if (unlikely(is_link_local_ether_addr(dest
))) {
286 u16 fwd_mask
= p
->br
->group_fwd_mask_required
;
289 * See IEEE 802.1D Table 7-10 Reserved addresses
292 * Bridge Group Address 01-80-C2-00-00-00
293 * (MAC Control) 802.3 01-80-C2-00-00-01
294 * (Link Aggregation) 802.3 01-80-C2-00-00-02
295 * 802.1X PAE address 01-80-C2-00-00-03
297 * 802.1AB LLDP 01-80-C2-00-00-0E
299 * Others reserved for future standardization
301 fwd_mask
|= p
->group_fwd_mask
;
303 case 0x00: /* Bridge Group Address */
304 /* If STP is turned off,
305 then must forward to keep loop detection */
306 if (p
->br
->stp_enabled
== BR_NO_STP
||
307 fwd_mask
& (1u << dest
[5]))
310 __br_handle_local_finish(skb
);
311 return RX_HANDLER_PASS
;
313 case 0x01: /* IEEE MAC (Pause) */
316 case 0x0E: /* 802.1AB LLDP */
317 fwd_mask
|= p
->br
->group_fwd_mask
;
318 if (fwd_mask
& (1u << dest
[5]))
321 __br_handle_local_finish(skb
);
322 return RX_HANDLER_PASS
;
325 /* Allow selective forwarding for most other protocols */
326 fwd_mask
|= p
->br
->group_fwd_mask
;
327 if (fwd_mask
& (1u << dest
[5]))
331 /* The else clause should be hit when nf_hook():
332 * - returns < 0 (drop/error)
333 * - returns = 0 (stolen/nf_queue)
334 * Thus return 1 from the okfn() to signal the skb is ok to pass
336 if (NF_HOOK(NFPROTO_BRIDGE
, NF_BR_LOCAL_IN
,
337 dev_net(skb
->dev
), NULL
, skb
, skb
->dev
, NULL
,
338 br_handle_local_finish
) == 1) {
339 return RX_HANDLER_PASS
;
341 return RX_HANDLER_CONSUMED
;
347 case BR_STATE_FORWARDING
:
348 case BR_STATE_LEARNING
:
349 if (ether_addr_equal(p
->br
->dev
->dev_addr
, dest
))
350 skb
->pkt_type
= PACKET_HOST
;
352 return nf_hook_bridge_pre(skb
, pskb
);
357 return RX_HANDLER_CONSUMED
;