Linux Audio

Check our new training course

Loading...
v5.4
  1// SPDX-License-Identifier: GPL-2.0-or-later
  2/*
  3 *	Spanning tree protocol; generic parts
  4 *	Linux ethernet bridge
  5 *
  6 *	Authors:
  7 *	Lennert Buytenhek		<buytenh@gnu.org>
 
 
 
 
 
  8 */
  9#include <linux/kernel.h>
 10#include <linux/rculist.h>
 11#include <net/switchdev.h>
 12
 13#include "br_private.h"
 14#include "br_private_stp.h"
 15
 16/* since time values in bpdu are in jiffies and then scaled (1/256)
 17 * before sending, make sure that is at least one STP tick.
 18 */
 19#define MESSAGE_AGE_INCR	((HZ / 256) + 1)
 20
 21static const char *const br_port_state_names[] = {
 22	[BR_STATE_DISABLED] = "disabled",
 23	[BR_STATE_LISTENING] = "listening",
 24	[BR_STATE_LEARNING] = "learning",
 25	[BR_STATE_FORWARDING] = "forwarding",
 26	[BR_STATE_BLOCKING] = "blocking",
 27};
 28
 29void br_set_state(struct net_bridge_port *p, unsigned int state)
 30{
 31	struct switchdev_attr attr = {
 32		.orig_dev = p->dev,
 33		.id = SWITCHDEV_ATTR_ID_PORT_STP_STATE,
 34		.flags = SWITCHDEV_F_DEFER,
 35		.u.stp_state = state,
 36	};
 37	int err;
 38
 39	p->state = state;
 40	err = switchdev_port_attr_set(p->dev, &attr);
 41	if (err && err != -EOPNOTSUPP)
 42		br_warn(p->br, "error setting offload STP state on port %u(%s)\n",
 43				(unsigned int) p->port_no, p->dev->name);
 44	else
 45		br_info(p->br, "port %u(%s) entered %s state\n",
 46				(unsigned int) p->port_no, p->dev->name,
 47				br_port_state_names[p->state]);
 48}
 49
 50/* called under bridge lock */
 51struct net_bridge_port *br_get_port(struct net_bridge *br, u16 port_no)
 52{
 53	struct net_bridge_port *p;
 54
 55	list_for_each_entry_rcu(p, &br->port_list, list) {
 56		if (p->port_no == port_no)
 57			return p;
 58	}
 59
 60	return NULL;
 61}
 62
 63/* called under bridge lock */
 64static int br_should_become_root_port(const struct net_bridge_port *p,
 65				      u16 root_port)
 66{
 67	struct net_bridge *br;
 68	struct net_bridge_port *rp;
 69	int t;
 70
 71	br = p->br;
 72	if (p->state == BR_STATE_DISABLED ||
 73	    br_is_designated_port(p))
 74		return 0;
 75
 76	if (memcmp(&br->bridge_id, &p->designated_root, 8) <= 0)
 77		return 0;
 78
 79	if (!root_port)
 80		return 1;
 81
 82	rp = br_get_port(br, root_port);
 83
 84	t = memcmp(&p->designated_root, &rp->designated_root, 8);
 85	if (t < 0)
 86		return 1;
 87	else if (t > 0)
 88		return 0;
 89
 90	if (p->designated_cost + p->path_cost <
 91	    rp->designated_cost + rp->path_cost)
 92		return 1;
 93	else if (p->designated_cost + p->path_cost >
 94		 rp->designated_cost + rp->path_cost)
 95		return 0;
 96
 97	t = memcmp(&p->designated_bridge, &rp->designated_bridge, 8);
 98	if (t < 0)
 99		return 1;
100	else if (t > 0)
101		return 0;
102
103	if (p->designated_port < rp->designated_port)
104		return 1;
105	else if (p->designated_port > rp->designated_port)
106		return 0;
107
108	if (p->port_id < rp->port_id)
109		return 1;
110
111	return 0;
112}
113
114static void br_root_port_block(const struct net_bridge *br,
115			       struct net_bridge_port *p)
116{
117
118	br_notice(br, "port %u(%s) tried to become root port (blocked)",
119		  (unsigned int) p->port_no, p->dev->name);
120
121	br_set_state(p, BR_STATE_LISTENING);
122	br_ifinfo_notify(RTM_NEWLINK, NULL, p);
123
124	if (br->forward_delay > 0)
125		mod_timer(&p->forward_delay_timer, jiffies + br->forward_delay);
126}
127
128/* called under bridge lock */
129static void br_root_selection(struct net_bridge *br)
130{
131	struct net_bridge_port *p;
132	u16 root_port = 0;
133
134	list_for_each_entry(p, &br->port_list, list) {
135		if (!br_should_become_root_port(p, root_port))
136			continue;
137
138		if (p->flags & BR_ROOT_BLOCK)
139			br_root_port_block(br, p);
140		else
141			root_port = p->port_no;
142	}
143
144	br->root_port = root_port;
145
146	if (!root_port) {
147		br->designated_root = br->bridge_id;
148		br->root_path_cost = 0;
149	} else {
150		p = br_get_port(br, root_port);
151		br->designated_root = p->designated_root;
152		br->root_path_cost = p->designated_cost + p->path_cost;
153	}
154}
155
156/* called under bridge lock */
157void br_become_root_bridge(struct net_bridge *br)
158{
159	br->max_age = br->bridge_max_age;
160	br->hello_time = br->bridge_hello_time;
161	br->forward_delay = br->bridge_forward_delay;
162	br_topology_change_detection(br);
163	del_timer(&br->tcn_timer);
164
165	if (br->dev->flags & IFF_UP) {
166		br_config_bpdu_generation(br);
167		mod_timer(&br->hello_timer, jiffies + br->hello_time);
168	}
169}
170
171/* called under bridge lock */
172void br_transmit_config(struct net_bridge_port *p)
173{
174	struct br_config_bpdu bpdu;
175	struct net_bridge *br;
176
177	if (timer_pending(&p->hold_timer)) {
178		p->config_pending = 1;
179		return;
180	}
181
182	br = p->br;
183
184	bpdu.topology_change = br->topology_change;
185	bpdu.topology_change_ack = p->topology_change_ack;
186	bpdu.root = br->designated_root;
187	bpdu.root_path_cost = br->root_path_cost;
188	bpdu.bridge_id = br->bridge_id;
189	bpdu.port_id = p->port_id;
190	if (br_is_root_bridge(br))
191		bpdu.message_age = 0;
192	else {
193		struct net_bridge_port *root
194			= br_get_port(br, br->root_port);
195		bpdu.message_age = (jiffies - root->designated_age)
196			+ MESSAGE_AGE_INCR;
197	}
198	bpdu.max_age = br->max_age;
199	bpdu.hello_time = br->hello_time;
200	bpdu.forward_delay = br->forward_delay;
201
202	if (bpdu.message_age < br->max_age) {
203		br_send_config_bpdu(p, &bpdu);
204		p->topology_change_ack = 0;
205		p->config_pending = 0;
206		if (p->br->stp_enabled == BR_KERNEL_STP)
207			mod_timer(&p->hold_timer,
208				  round_jiffies(jiffies + BR_HOLD_TIME));
209	}
210}
211
212/* called under bridge lock */
213static void br_record_config_information(struct net_bridge_port *p,
214					 const struct br_config_bpdu *bpdu)
215{
216	p->designated_root = bpdu->root;
217	p->designated_cost = bpdu->root_path_cost;
218	p->designated_bridge = bpdu->bridge_id;
219	p->designated_port = bpdu->port_id;
220	p->designated_age = jiffies - bpdu->message_age;
221
222	mod_timer(&p->message_age_timer, jiffies
223		  + (bpdu->max_age - bpdu->message_age));
224}
225
226/* called under bridge lock */
227static void br_record_config_timeout_values(struct net_bridge *br,
228					    const struct br_config_bpdu *bpdu)
229{
230	br->max_age = bpdu->max_age;
231	br->hello_time = bpdu->hello_time;
232	br->forward_delay = bpdu->forward_delay;
233	__br_set_topology_change(br, bpdu->topology_change);
234}
235
236/* called under bridge lock */
237void br_transmit_tcn(struct net_bridge *br)
238{
239	struct net_bridge_port *p;
240
241	p = br_get_port(br, br->root_port);
242	if (p)
243		br_send_tcn_bpdu(p);
244	else
245		br_notice(br, "root port %u not found for topology notice\n",
246			  br->root_port);
247}
248
249/* called under bridge lock */
250static int br_should_become_designated_port(const struct net_bridge_port *p)
251{
252	struct net_bridge *br;
253	int t;
254
255	br = p->br;
256	if (br_is_designated_port(p))
257		return 1;
258
259	if (memcmp(&p->designated_root, &br->designated_root, 8))
260		return 1;
261
262	if (br->root_path_cost < p->designated_cost)
263		return 1;
264	else if (br->root_path_cost > p->designated_cost)
265		return 0;
266
267	t = memcmp(&br->bridge_id, &p->designated_bridge, 8);
268	if (t < 0)
269		return 1;
270	else if (t > 0)
271		return 0;
272
273	if (p->port_id < p->designated_port)
274		return 1;
275
276	return 0;
277}
278
279/* called under bridge lock */
280static void br_designated_port_selection(struct net_bridge *br)
281{
282	struct net_bridge_port *p;
283
284	list_for_each_entry(p, &br->port_list, list) {
285		if (p->state != BR_STATE_DISABLED &&
286		    br_should_become_designated_port(p))
287			br_become_designated_port(p);
288
289	}
290}
291
292/* called under bridge lock */
293static int br_supersedes_port_info(const struct net_bridge_port *p,
294				   const struct br_config_bpdu *bpdu)
295{
296	int t;
297
298	t = memcmp(&bpdu->root, &p->designated_root, 8);
299	if (t < 0)
300		return 1;
301	else if (t > 0)
302		return 0;
303
304	if (bpdu->root_path_cost < p->designated_cost)
305		return 1;
306	else if (bpdu->root_path_cost > p->designated_cost)
307		return 0;
308
309	t = memcmp(&bpdu->bridge_id, &p->designated_bridge, 8);
310	if (t < 0)
311		return 1;
312	else if (t > 0)
313		return 0;
314
315	if (memcmp(&bpdu->bridge_id, &p->br->bridge_id, 8))
316		return 1;
317
318	if (bpdu->port_id <= p->designated_port)
319		return 1;
320
321	return 0;
322}
323
324/* called under bridge lock */
325static void br_topology_change_acknowledged(struct net_bridge *br)
326{
327	br->topology_change_detected = 0;
328	del_timer(&br->tcn_timer);
329}
330
331/* called under bridge lock */
332void br_topology_change_detection(struct net_bridge *br)
333{
334	int isroot = br_is_root_bridge(br);
335
336	if (br->stp_enabled != BR_KERNEL_STP)
337		return;
338
339	br_info(br, "topology change detected, %s\n",
340		isroot ? "propagating" : "sending tcn bpdu");
341
342	if (isroot) {
343		__br_set_topology_change(br, 1);
344		mod_timer(&br->topology_change_timer, jiffies
345			  + br->bridge_forward_delay + br->bridge_max_age);
346	} else if (!br->topology_change_detected) {
347		br_transmit_tcn(br);
348		mod_timer(&br->tcn_timer, jiffies + br->bridge_hello_time);
349	}
350
351	br->topology_change_detected = 1;
352}
353
354/* called under bridge lock */
355void br_config_bpdu_generation(struct net_bridge *br)
356{
357	struct net_bridge_port *p;
358
359	list_for_each_entry(p, &br->port_list, list) {
360		if (p->state != BR_STATE_DISABLED &&
361		    br_is_designated_port(p))
362			br_transmit_config(p);
363	}
364}
365
366/* called under bridge lock */
367static void br_reply(struct net_bridge_port *p)
368{
369	br_transmit_config(p);
370}
371
372/* called under bridge lock */
373void br_configuration_update(struct net_bridge *br)
374{
375	br_root_selection(br);
376	br_designated_port_selection(br);
377}
378
379/* called under bridge lock */
380void br_become_designated_port(struct net_bridge_port *p)
381{
382	struct net_bridge *br;
383
384	br = p->br;
385	p->designated_root = br->designated_root;
386	p->designated_cost = br->root_path_cost;
387	p->designated_bridge = br->bridge_id;
388	p->designated_port = p->port_id;
389}
390
391
392/* called under bridge lock */
393static void br_make_blocking(struct net_bridge_port *p)
394{
395	if (p->state != BR_STATE_DISABLED &&
396	    p->state != BR_STATE_BLOCKING) {
397		if (p->state == BR_STATE_FORWARDING ||
398		    p->state == BR_STATE_LEARNING)
399			br_topology_change_detection(p->br);
400
401		br_set_state(p, BR_STATE_BLOCKING);
402		br_ifinfo_notify(RTM_NEWLINK, NULL, p);
 
403
404		del_timer(&p->forward_delay_timer);
405	}
406}
407
408/* called under bridge lock */
409static void br_make_forwarding(struct net_bridge_port *p)
410{
411	struct net_bridge *br = p->br;
412
413	if (p->state != BR_STATE_BLOCKING)
414		return;
415
416	if (br->stp_enabled == BR_NO_STP || br->forward_delay == 0) {
417		br_set_state(p, BR_STATE_FORWARDING);
418		br_topology_change_detection(br);
419		del_timer(&p->forward_delay_timer);
420	} else if (br->stp_enabled == BR_KERNEL_STP)
421		br_set_state(p, BR_STATE_LISTENING);
422	else
423		br_set_state(p, BR_STATE_LEARNING);
424
425	br_ifinfo_notify(RTM_NEWLINK, NULL, p);
 
 
426
427	if (br->forward_delay != 0)
428		mod_timer(&p->forward_delay_timer, jiffies + br->forward_delay);
429}
430
431/* called under bridge lock */
432void br_port_state_selection(struct net_bridge *br)
433{
434	struct net_bridge_port *p;
435	unsigned int liveports = 0;
436
 
 
 
 
437	list_for_each_entry(p, &br->port_list, list) {
438		if (p->state == BR_STATE_DISABLED)
439			continue;
440
441		/* Don't change port states if userspace is handling STP */
442		if (br->stp_enabled != BR_USER_STP) {
443			if (p->port_no == br->root_port) {
444				p->config_pending = 0;
445				p->topology_change_ack = 0;
446				br_make_forwarding(p);
447			} else if (br_is_designated_port(p)) {
448				del_timer(&p->message_age_timer);
449				br_make_forwarding(p);
450			} else {
451				p->config_pending = 0;
452				p->topology_change_ack = 0;
453				br_make_blocking(p);
454			}
455		}
456
457		if (p->state != BR_STATE_BLOCKING)
458			br_multicast_enable_port(p);
459		/* Multicast is not disabled for the port when it goes in
460		 * blocking state because the timers will expire and stop by
461		 * themselves without sending more queries.
462		 */
463		if (p->state == BR_STATE_FORWARDING)
464			++liveports;
465	}
466
467	if (liveports == 0)
468		netif_carrier_off(br->dev);
469	else
470		netif_carrier_on(br->dev);
471}
472
473/* called under bridge lock */
474static void br_topology_change_acknowledge(struct net_bridge_port *p)
475{
476	p->topology_change_ack = 1;
477	br_transmit_config(p);
478}
479
480/* called under bridge lock */
481void br_received_config_bpdu(struct net_bridge_port *p,
482			     const struct br_config_bpdu *bpdu)
483{
484	struct net_bridge *br;
485	int was_root;
486
487	br = p->br;
488	was_root = br_is_root_bridge(br);
489
490	if (br_supersedes_port_info(p, bpdu)) {
491		br_record_config_information(p, bpdu);
492		br_configuration_update(br);
493		br_port_state_selection(br);
494
495		if (!br_is_root_bridge(br) && was_root) {
496			del_timer(&br->hello_timer);
497			if (br->topology_change_detected) {
498				del_timer(&br->topology_change_timer);
499				br_transmit_tcn(br);
500
501				mod_timer(&br->tcn_timer,
502					  jiffies + br->bridge_hello_time);
503			}
504		}
505
506		if (p->port_no == br->root_port) {
507			br_record_config_timeout_values(br, bpdu);
508			br_config_bpdu_generation(br);
509			if (bpdu->topology_change_ack)
510				br_topology_change_acknowledged(br);
511		}
512	} else if (br_is_designated_port(p)) {
513		br_reply(p);
514	}
515}
516
517/* called under bridge lock */
518void br_received_tcn_bpdu(struct net_bridge_port *p)
519{
520	if (br_is_designated_port(p)) {
521		br_info(p->br, "port %u(%s) received tcn bpdu\n",
522			(unsigned int) p->port_no, p->dev->name);
523
524		br_topology_change_detection(p->br);
525		br_topology_change_acknowledge(p);
526	}
527}
528
529/* Change bridge STP parameter */
530int br_set_hello_time(struct net_bridge *br, unsigned long val)
531{
532	unsigned long t = clock_t_to_jiffies(val);
533
534	if (t < BR_MIN_HELLO_TIME || t > BR_MAX_HELLO_TIME)
535		return -ERANGE;
536
537	spin_lock_bh(&br->lock);
538	br->bridge_hello_time = t;
539	if (br_is_root_bridge(br))
540		br->hello_time = br->bridge_hello_time;
541	spin_unlock_bh(&br->lock);
542	return 0;
543}
544
545int br_set_max_age(struct net_bridge *br, unsigned long val)
546{
547	unsigned long t = clock_t_to_jiffies(val);
548
549	if (t < BR_MIN_MAX_AGE || t > BR_MAX_MAX_AGE)
550		return -ERANGE;
551
552	spin_lock_bh(&br->lock);
553	br->bridge_max_age = t;
554	if (br_is_root_bridge(br))
555		br->max_age = br->bridge_max_age;
556	spin_unlock_bh(&br->lock);
557	return 0;
558
559}
560
561/* called under bridge lock */
562int __set_ageing_time(struct net_device *dev, unsigned long t)
563{
564	struct switchdev_attr attr = {
565		.orig_dev = dev,
566		.id = SWITCHDEV_ATTR_ID_BRIDGE_AGEING_TIME,
567		.flags = SWITCHDEV_F_SKIP_EOPNOTSUPP | SWITCHDEV_F_DEFER,
568		.u.ageing_time = jiffies_to_clock_t(t),
569	};
570	int err;
571
572	err = switchdev_port_attr_set(dev, &attr);
573	if (err && err != -EOPNOTSUPP)
574		return err;
575
576	return 0;
577}
578
579/* Set time interval that dynamic forwarding entries live
580 * For pure software bridge, allow values outside the 802.1
581 * standard specification for special cases:
582 *  0 - entry never ages (all permanant)
583 *  1 - entry disappears (no persistance)
584 *
585 * Offloaded switch entries maybe more restrictive
586 */
587int br_set_ageing_time(struct net_bridge *br, clock_t ageing_time)
588{
589	unsigned long t = clock_t_to_jiffies(ageing_time);
590	int err;
591
592	err = __set_ageing_time(br->dev, t);
593	if (err)
594		return err;
595
596	spin_lock_bh(&br->lock);
597	br->bridge_ageing_time = t;
598	br->ageing_time = t;
599	spin_unlock_bh(&br->lock);
600
601	mod_delayed_work(system_long_wq, &br->gc_work, 0);
602
603	return 0;
604}
605
606/* called under bridge lock */
607void __br_set_topology_change(struct net_bridge *br, unsigned char val)
608{
609	unsigned long t;
610	int err;
611
612	if (br->stp_enabled == BR_KERNEL_STP && br->topology_change != val) {
613		/* On topology change, set the bridge ageing time to twice the
614		 * forward delay. Otherwise, restore its default ageing time.
615		 */
616
617		if (val) {
618			t = 2 * br->forward_delay;
619			br_debug(br, "decreasing ageing time to %lu\n", t);
620		} else {
621			t = br->bridge_ageing_time;
622			br_debug(br, "restoring ageing time to %lu\n", t);
623		}
624
625		err = __set_ageing_time(br->dev, t);
626		if (err)
627			br_warn(br, "error offloading ageing time\n");
628		else
629			br->ageing_time = t;
630	}
631
632	br->topology_change = val;
633}
634
635void __br_set_forward_delay(struct net_bridge *br, unsigned long t)
636{
637	br->bridge_forward_delay = t;
638	if (br_is_root_bridge(br))
639		br->forward_delay = br->bridge_forward_delay;
640}
641
642int br_set_forward_delay(struct net_bridge *br, unsigned long val)
643{
644	unsigned long t = clock_t_to_jiffies(val);
645	int err = -ERANGE;
646
647	spin_lock_bh(&br->lock);
648	if (br->stp_enabled != BR_NO_STP &&
649	    (t < BR_MIN_FORWARD_DELAY || t > BR_MAX_FORWARD_DELAY))
650		goto unlock;
651
652	__br_set_forward_delay(br, t);
653	err = 0;
654
655unlock:
 
 
 
656	spin_unlock_bh(&br->lock);
657	return err;
658}
v3.1
 
  1/*
  2 *	Spanning tree protocol; generic parts
  3 *	Linux ethernet bridge
  4 *
  5 *	Authors:
  6 *	Lennert Buytenhek		<buytenh@gnu.org>
  7 *
  8 *	This program is free software; you can redistribute it and/or
  9 *	modify it under the terms of the GNU General Public License
 10 *	as published by the Free Software Foundation; either version
 11 *	2 of the License, or (at your option) any later version.
 12 */
 13#include <linux/kernel.h>
 14#include <linux/rculist.h>
 
 15
 16#include "br_private.h"
 17#include "br_private_stp.h"
 18
 19/* since time values in bpdu are in jiffies and then scaled (1/256)
 20 * before sending, make sure that is at least one.
 21 */
 22#define MESSAGE_AGE_INCR	((HZ < 256) ? 1 : (HZ/256))
 23
 24static const char *const br_port_state_names[] = {
 25	[BR_STATE_DISABLED] = "disabled",
 26	[BR_STATE_LISTENING] = "listening",
 27	[BR_STATE_LEARNING] = "learning",
 28	[BR_STATE_FORWARDING] = "forwarding",
 29	[BR_STATE_BLOCKING] = "blocking",
 30};
 31
 32void br_log_state(const struct net_bridge_port *p)
 33{
 34	br_info(p->br, "port %u(%s) entering %s state\n",
 35		(unsigned) p->port_no, p->dev->name,
 36		br_port_state_names[p->state]);
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 37}
 38
 39/* called under bridge lock */
 40struct net_bridge_port *br_get_port(struct net_bridge *br, u16 port_no)
 41{
 42	struct net_bridge_port *p;
 43
 44	list_for_each_entry_rcu(p, &br->port_list, list) {
 45		if (p->port_no == port_no)
 46			return p;
 47	}
 48
 49	return NULL;
 50}
 51
 52/* called under bridge lock */
 53static int br_should_become_root_port(const struct net_bridge_port *p,
 54				      u16 root_port)
 55{
 56	struct net_bridge *br;
 57	struct net_bridge_port *rp;
 58	int t;
 59
 60	br = p->br;
 61	if (p->state == BR_STATE_DISABLED ||
 62	    br_is_designated_port(p))
 63		return 0;
 64
 65	if (memcmp(&br->bridge_id, &p->designated_root, 8) <= 0)
 66		return 0;
 67
 68	if (!root_port)
 69		return 1;
 70
 71	rp = br_get_port(br, root_port);
 72
 73	t = memcmp(&p->designated_root, &rp->designated_root, 8);
 74	if (t < 0)
 75		return 1;
 76	else if (t > 0)
 77		return 0;
 78
 79	if (p->designated_cost + p->path_cost <
 80	    rp->designated_cost + rp->path_cost)
 81		return 1;
 82	else if (p->designated_cost + p->path_cost >
 83		 rp->designated_cost + rp->path_cost)
 84		return 0;
 85
 86	t = memcmp(&p->designated_bridge, &rp->designated_bridge, 8);
 87	if (t < 0)
 88		return 1;
 89	else if (t > 0)
 90		return 0;
 91
 92	if (p->designated_port < rp->designated_port)
 93		return 1;
 94	else if (p->designated_port > rp->designated_port)
 95		return 0;
 96
 97	if (p->port_id < rp->port_id)
 98		return 1;
 99
100	return 0;
101}
102
 
 
 
 
 
 
 
 
 
 
 
 
 
 
103/* called under bridge lock */
104static void br_root_selection(struct net_bridge *br)
105{
106	struct net_bridge_port *p;
107	u16 root_port = 0;
108
109	list_for_each_entry(p, &br->port_list, list) {
110		if (br_should_become_root_port(p, root_port))
 
 
 
 
 
111			root_port = p->port_no;
112	}
113
114	br->root_port = root_port;
115
116	if (!root_port) {
117		br->designated_root = br->bridge_id;
118		br->root_path_cost = 0;
119	} else {
120		p = br_get_port(br, root_port);
121		br->designated_root = p->designated_root;
122		br->root_path_cost = p->designated_cost + p->path_cost;
123	}
124}
125
126/* called under bridge lock */
127void br_become_root_bridge(struct net_bridge *br)
128{
129	br->max_age = br->bridge_max_age;
130	br->hello_time = br->bridge_hello_time;
131	br->forward_delay = br->bridge_forward_delay;
132	br_topology_change_detection(br);
133	del_timer(&br->tcn_timer);
134
135	if (br->dev->flags & IFF_UP) {
136		br_config_bpdu_generation(br);
137		mod_timer(&br->hello_timer, jiffies + br->hello_time);
138	}
139}
140
141/* called under bridge lock */
142void br_transmit_config(struct net_bridge_port *p)
143{
144	struct br_config_bpdu bpdu;
145	struct net_bridge *br;
146
147	if (timer_pending(&p->hold_timer)) {
148		p->config_pending = 1;
149		return;
150	}
151
152	br = p->br;
153
154	bpdu.topology_change = br->topology_change;
155	bpdu.topology_change_ack = p->topology_change_ack;
156	bpdu.root = br->designated_root;
157	bpdu.root_path_cost = br->root_path_cost;
158	bpdu.bridge_id = br->bridge_id;
159	bpdu.port_id = p->port_id;
160	if (br_is_root_bridge(br))
161		bpdu.message_age = 0;
162	else {
163		struct net_bridge_port *root
164			= br_get_port(br, br->root_port);
165		bpdu.message_age = (jiffies - root->designated_age)
166			+ MESSAGE_AGE_INCR;
167	}
168	bpdu.max_age = br->max_age;
169	bpdu.hello_time = br->hello_time;
170	bpdu.forward_delay = br->forward_delay;
171
172	if (bpdu.message_age < br->max_age) {
173		br_send_config_bpdu(p, &bpdu);
174		p->topology_change_ack = 0;
175		p->config_pending = 0;
176		mod_timer(&p->hold_timer,
177			  round_jiffies(jiffies + BR_HOLD_TIME));
 
178	}
179}
180
181/* called under bridge lock */
182static void br_record_config_information(struct net_bridge_port *p,
183					 const struct br_config_bpdu *bpdu)
184{
185	p->designated_root = bpdu->root;
186	p->designated_cost = bpdu->root_path_cost;
187	p->designated_bridge = bpdu->bridge_id;
188	p->designated_port = bpdu->port_id;
189	p->designated_age = jiffies + bpdu->message_age;
190
191	mod_timer(&p->message_age_timer, jiffies
192		  + (p->br->max_age - bpdu->message_age));
193}
194
195/* called under bridge lock */
196static void br_record_config_timeout_values(struct net_bridge *br,
197					    const struct br_config_bpdu *bpdu)
198{
199	br->max_age = bpdu->max_age;
200	br->hello_time = bpdu->hello_time;
201	br->forward_delay = bpdu->forward_delay;
202	br->topology_change = bpdu->topology_change;
203}
204
205/* called under bridge lock */
206void br_transmit_tcn(struct net_bridge *br)
207{
208	br_send_tcn_bpdu(br_get_port(br, br->root_port));
 
 
 
 
 
 
 
209}
210
211/* called under bridge lock */
212static int br_should_become_designated_port(const struct net_bridge_port *p)
213{
214	struct net_bridge *br;
215	int t;
216
217	br = p->br;
218	if (br_is_designated_port(p))
219		return 1;
220
221	if (memcmp(&p->designated_root, &br->designated_root, 8))
222		return 1;
223
224	if (br->root_path_cost < p->designated_cost)
225		return 1;
226	else if (br->root_path_cost > p->designated_cost)
227		return 0;
228
229	t = memcmp(&br->bridge_id, &p->designated_bridge, 8);
230	if (t < 0)
231		return 1;
232	else if (t > 0)
233		return 0;
234
235	if (p->port_id < p->designated_port)
236		return 1;
237
238	return 0;
239}
240
241/* called under bridge lock */
242static void br_designated_port_selection(struct net_bridge *br)
243{
244	struct net_bridge_port *p;
245
246	list_for_each_entry(p, &br->port_list, list) {
247		if (p->state != BR_STATE_DISABLED &&
248		    br_should_become_designated_port(p))
249			br_become_designated_port(p);
250
251	}
252}
253
254/* called under bridge lock */
255static int br_supersedes_port_info(const struct net_bridge_port *p,
256				   const struct br_config_bpdu *bpdu)
257{
258	int t;
259
260	t = memcmp(&bpdu->root, &p->designated_root, 8);
261	if (t < 0)
262		return 1;
263	else if (t > 0)
264		return 0;
265
266	if (bpdu->root_path_cost < p->designated_cost)
267		return 1;
268	else if (bpdu->root_path_cost > p->designated_cost)
269		return 0;
270
271	t = memcmp(&bpdu->bridge_id, &p->designated_bridge, 8);
272	if (t < 0)
273		return 1;
274	else if (t > 0)
275		return 0;
276
277	if (memcmp(&bpdu->bridge_id, &p->br->bridge_id, 8))
278		return 1;
279
280	if (bpdu->port_id <= p->designated_port)
281		return 1;
282
283	return 0;
284}
285
286/* called under bridge lock */
287static void br_topology_change_acknowledged(struct net_bridge *br)
288{
289	br->topology_change_detected = 0;
290	del_timer(&br->tcn_timer);
291}
292
293/* called under bridge lock */
294void br_topology_change_detection(struct net_bridge *br)
295{
296	int isroot = br_is_root_bridge(br);
297
298	if (br->stp_enabled != BR_KERNEL_STP)
299		return;
300
301	br_info(br, "topology change detected, %s\n",
302		isroot ? "propagating" : "sending tcn bpdu");
303
304	if (isroot) {
305		br->topology_change = 1;
306		mod_timer(&br->topology_change_timer, jiffies
307			  + br->bridge_forward_delay + br->bridge_max_age);
308	} else if (!br->topology_change_detected) {
309		br_transmit_tcn(br);
310		mod_timer(&br->tcn_timer, jiffies + br->bridge_hello_time);
311	}
312
313	br->topology_change_detected = 1;
314}
315
316/* called under bridge lock */
317void br_config_bpdu_generation(struct net_bridge *br)
318{
319	struct net_bridge_port *p;
320
321	list_for_each_entry(p, &br->port_list, list) {
322		if (p->state != BR_STATE_DISABLED &&
323		    br_is_designated_port(p))
324			br_transmit_config(p);
325	}
326}
327
328/* called under bridge lock */
329static void br_reply(struct net_bridge_port *p)
330{
331	br_transmit_config(p);
332}
333
334/* called under bridge lock */
335void br_configuration_update(struct net_bridge *br)
336{
337	br_root_selection(br);
338	br_designated_port_selection(br);
339}
340
341/* called under bridge lock */
342void br_become_designated_port(struct net_bridge_port *p)
343{
344	struct net_bridge *br;
345
346	br = p->br;
347	p->designated_root = br->designated_root;
348	p->designated_cost = br->root_path_cost;
349	p->designated_bridge = br->bridge_id;
350	p->designated_port = p->port_id;
351}
352
353
354/* called under bridge lock */
355static void br_make_blocking(struct net_bridge_port *p)
356{
357	if (p->state != BR_STATE_DISABLED &&
358	    p->state != BR_STATE_BLOCKING) {
359		if (p->state == BR_STATE_FORWARDING ||
360		    p->state == BR_STATE_LEARNING)
361			br_topology_change_detection(p->br);
362
363		p->state = BR_STATE_BLOCKING;
364		br_log_state(p);
365		br_ifinfo_notify(RTM_NEWLINK, p);
366
367		del_timer(&p->forward_delay_timer);
368	}
369}
370
371/* called under bridge lock */
372static void br_make_forwarding(struct net_bridge_port *p)
373{
374	struct net_bridge *br = p->br;
375
376	if (p->state != BR_STATE_BLOCKING)
377		return;
378
379	if (br->stp_enabled == BR_NO_STP || br->forward_delay == 0) {
380		p->state = BR_STATE_FORWARDING;
381		br_topology_change_detection(br);
382		del_timer(&p->forward_delay_timer);
383	} else if (br->stp_enabled == BR_KERNEL_STP)
384		p->state = BR_STATE_LISTENING;
385	else
386		p->state = BR_STATE_LEARNING;
387
388	br_multicast_enable_port(p);
389	br_log_state(p);
390	br_ifinfo_notify(RTM_NEWLINK, p);
391
392	if (br->forward_delay != 0)
393		mod_timer(&p->forward_delay_timer, jiffies + br->forward_delay);
394}
395
396/* called under bridge lock */
397void br_port_state_selection(struct net_bridge *br)
398{
399	struct net_bridge_port *p;
400	unsigned int liveports = 0;
401
402	/* Don't change port states if userspace is handling STP */
403	if (br->stp_enabled == BR_USER_STP)
404		return;
405
406	list_for_each_entry(p, &br->port_list, list) {
407		if (p->state == BR_STATE_DISABLED)
408			continue;
409
410		if (p->port_no == br->root_port) {
411			p->config_pending = 0;
412			p->topology_change_ack = 0;
413			br_make_forwarding(p);
414		} else if (br_is_designated_port(p)) {
415			del_timer(&p->message_age_timer);
416			br_make_forwarding(p);
417		} else {
418			p->config_pending = 0;
419			p->topology_change_ack = 0;
420			br_make_blocking(p);
 
 
 
421		}
422
 
 
 
 
 
 
423		if (p->state == BR_STATE_FORWARDING)
424			++liveports;
425	}
426
427	if (liveports == 0)
428		netif_carrier_off(br->dev);
429	else
430		netif_carrier_on(br->dev);
431}
432
433/* called under bridge lock */
434static void br_topology_change_acknowledge(struct net_bridge_port *p)
435{
436	p->topology_change_ack = 1;
437	br_transmit_config(p);
438}
439
440/* called under bridge lock */
441void br_received_config_bpdu(struct net_bridge_port *p,
442			     const struct br_config_bpdu *bpdu)
443{
444	struct net_bridge *br;
445	int was_root;
446
447	br = p->br;
448	was_root = br_is_root_bridge(br);
449
450	if (br_supersedes_port_info(p, bpdu)) {
451		br_record_config_information(p, bpdu);
452		br_configuration_update(br);
453		br_port_state_selection(br);
454
455		if (!br_is_root_bridge(br) && was_root) {
456			del_timer(&br->hello_timer);
457			if (br->topology_change_detected) {
458				del_timer(&br->topology_change_timer);
459				br_transmit_tcn(br);
460
461				mod_timer(&br->tcn_timer,
462					  jiffies + br->bridge_hello_time);
463			}
464		}
465
466		if (p->port_no == br->root_port) {
467			br_record_config_timeout_values(br, bpdu);
468			br_config_bpdu_generation(br);
469			if (bpdu->topology_change_ack)
470				br_topology_change_acknowledged(br);
471		}
472	} else if (br_is_designated_port(p)) {
473		br_reply(p);
474	}
475}
476
477/* called under bridge lock */
478void br_received_tcn_bpdu(struct net_bridge_port *p)
479{
480	if (br_is_designated_port(p)) {
481		br_info(p->br, "port %u(%s) received tcn bpdu\n",
482			(unsigned) p->port_no, p->dev->name);
483
484		br_topology_change_detection(p->br);
485		br_topology_change_acknowledge(p);
486	}
487}
488
489/* Change bridge STP parameter */
490int br_set_hello_time(struct net_bridge *br, unsigned long val)
491{
492	unsigned long t = clock_t_to_jiffies(val);
493
494	if (t < BR_MIN_HELLO_TIME || t > BR_MAX_HELLO_TIME)
495		return -ERANGE;
496
497	spin_lock_bh(&br->lock);
498	br->bridge_hello_time = t;
499	if (br_is_root_bridge(br))
500		br->hello_time = br->bridge_hello_time;
501	spin_unlock_bh(&br->lock);
502	return 0;
503}
504
505int br_set_max_age(struct net_bridge *br, unsigned long val)
506{
507	unsigned long t = clock_t_to_jiffies(val);
508
509	if (t < BR_MIN_MAX_AGE || t > BR_MAX_MAX_AGE)
510		return -ERANGE;
511
512	spin_lock_bh(&br->lock);
513	br->bridge_max_age = t;
514	if (br_is_root_bridge(br))
515		br->max_age = br->bridge_max_age;
516	spin_unlock_bh(&br->lock);
517	return 0;
518
519}
520
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
521int br_set_forward_delay(struct net_bridge *br, unsigned long val)
522{
523	unsigned long t = clock_t_to_jiffies(val);
 
524
 
525	if (br->stp_enabled != BR_NO_STP &&
526	    (t < BR_MIN_FORWARD_DELAY || t > BR_MAX_FORWARD_DELAY))
527		return -ERANGE;
 
 
 
528
529	spin_lock_bh(&br->lock);
530	br->bridge_forward_delay = t;
531	if (br_is_root_bridge(br))
532		br->forward_delay = br->bridge_forward_delay;
533	spin_unlock_bh(&br->lock);
534	return 0;
535}