2 * net/tipc/bcast.c: TIPC broadcast code
4 * Copyright (c) 2004-2006, 2014-2017, Ericsson AB
5 * Copyright (c) 2004, Intel Corporation.
6 * Copyright (c) 2005, 2010-2011, Wind River Systems
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions are met:
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in the
16 * documentation and/or other materials provided with the distribution.
17 * 3. Neither the names of the copyright holders nor the names of its
18 * contributors may be used to endorse or promote products derived from
19 * this software without specific prior written permission.
21 * Alternatively, this software may be distributed under the terms of the
22 * GNU General Public License ("GPL") version 2 as published by the Free
23 * Software Foundation.
25 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
26 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
27 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
28 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
29 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
30 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
31 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
32 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
33 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
34 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
35 * POSSIBILITY OF SUCH DAMAGE.
38 #include <linux/tipc_config.h>
43 #include "name_table.h"
45 #define BCLINK_WIN_DEFAULT 50 /* bcast link window size (default) */
46 #define BCLINK_WIN_MIN 32 /* bcast minimum link window size */
48 const char tipc_bclink_name
[] = "broadcast-link";
51 * struct tipc_bc_base - base structure for keeping broadcast send state
52 * @link: broadcast send link structure
53 * @inputq: data input queue; will only carry SOCK_WAKEUP messages
54 * @dest: array keeping number of reachable destinations per bearer
55 * @primary_bearer: a bearer having links to all broadcast destinations, if any
56 * @bcast_support: indicates if primary bearer, if any, supports broadcast
57 * @rcast_support: indicates if all peer nodes support replicast
58 * @rc_ratio: dest count as percentage of cluster size where send method changes
59 * @bc_threshold: calculated drom rc_ratio; if dests > threshold use broadcast
62 struct tipc_link
*link
;
63 struct sk_buff_head inputq
;
64 int dests
[MAX_BEARERS
];
72 static struct tipc_bc_base
*tipc_bc_base(struct net
*net
)
74 return tipc_net(net
)->bcbase
;
77 /* tipc_bcast_get_mtu(): -get the MTU currently used by broadcast link
78 * Note: the MTU is decremented to give room for a tunnel header, in
79 * case the message needs to be sent as replicast
81 int tipc_bcast_get_mtu(struct net
*net
)
83 return tipc_link_mtu(tipc_bc_sndlink(net
)) - INT_H_SIZE
;
86 void tipc_bcast_disable_rcast(struct net
*net
)
88 tipc_bc_base(net
)->rcast_support
= false;
91 static void tipc_bcbase_calc_bc_threshold(struct net
*net
)
93 struct tipc_bc_base
*bb
= tipc_bc_base(net
);
94 int cluster_size
= tipc_link_bc_peers(tipc_bc_sndlink(net
));
96 bb
->bc_threshold
= 1 + (cluster_size
* bb
->rc_ratio
/ 100);
99 /* tipc_bcbase_select_primary(): find a bearer with links to all destinations,
100 * if any, and make it primary bearer
102 static void tipc_bcbase_select_primary(struct net
*net
)
104 struct tipc_bc_base
*bb
= tipc_bc_base(net
);
105 int all_dests
= tipc_link_bc_peers(bb
->link
);
108 bb
->primary_bearer
= INVALID_BEARER_ID
;
109 bb
->bcast_support
= true;
114 for (i
= 0; i
< MAX_BEARERS
; i
++) {
118 mtu
= tipc_bearer_mtu(net
, i
);
119 if (mtu
< tipc_link_mtu(bb
->link
))
120 tipc_link_set_mtu(bb
->link
, mtu
);
121 bb
->bcast_support
&= tipc_bearer_bcast_support(net
, i
);
122 if (bb
->dests
[i
] < all_dests
)
125 bb
->primary_bearer
= i
;
127 /* Reduce risk that all nodes select same primary */
128 if ((i
^ tipc_own_addr(net
)) & 1)
131 prim
= bb
->primary_bearer
;
132 if (prim
!= INVALID_BEARER_ID
)
133 bb
->bcast_support
= tipc_bearer_bcast_support(net
, prim
);
136 void tipc_bcast_inc_bearer_dst_cnt(struct net
*net
, int bearer_id
)
138 struct tipc_bc_base
*bb
= tipc_bc_base(net
);
140 tipc_bcast_lock(net
);
141 bb
->dests
[bearer_id
]++;
142 tipc_bcbase_select_primary(net
);
143 tipc_bcast_unlock(net
);
146 void tipc_bcast_dec_bearer_dst_cnt(struct net
*net
, int bearer_id
)
148 struct tipc_bc_base
*bb
= tipc_bc_base(net
);
150 tipc_bcast_lock(net
);
151 bb
->dests
[bearer_id
]--;
152 tipc_bcbase_select_primary(net
);
153 tipc_bcast_unlock(net
);
156 /* tipc_bcbase_xmit - broadcast a packet queue across one or more bearers
158 * Note that number of reachable destinations, as indicated in the dests[]
159 * array, may transitionally differ from the number of destinations indicated
160 * in each sent buffer. We can sustain this. Excess destination nodes will
161 * drop and never acknowledge the unexpected packets, and missing destinations
162 * will either require retransmission (if they are just about to be added to
163 * the bearer), or be removed from the buffer's 'ackers' counter (if they
166 static void tipc_bcbase_xmit(struct net
*net
, struct sk_buff_head
*xmitq
)
169 struct tipc_bc_base
*bb
= tipc_bc_base(net
);
170 struct sk_buff
*skb
, *_skb
;
171 struct sk_buff_head _xmitq
;
173 if (skb_queue_empty(xmitq
))
176 /* The typical case: at least one bearer has links to all nodes */
177 bearer_id
= bb
->primary_bearer
;
178 if (bearer_id
>= 0) {
179 tipc_bearer_bc_xmit(net
, bearer_id
, xmitq
);
183 /* We have to transmit across all bearers */
184 skb_queue_head_init(&_xmitq
);
185 for (bearer_id
= 0; bearer_id
< MAX_BEARERS
; bearer_id
++) {
186 if (!bb
->dests
[bearer_id
])
189 skb_queue_walk(xmitq
, skb
) {
190 _skb
= pskb_copy_for_clone(skb
, GFP_ATOMIC
);
193 __skb_queue_tail(&_xmitq
, _skb
);
195 tipc_bearer_bc_xmit(net
, bearer_id
, &_xmitq
);
197 __skb_queue_purge(xmitq
);
198 __skb_queue_purge(&_xmitq
);
201 static void tipc_bcast_select_xmit_method(struct net
*net
, int dests
,
202 struct tipc_mc_method
*method
)
204 struct tipc_bc_base
*bb
= tipc_bc_base(net
);
205 unsigned long exp
= method
->expires
;
207 /* Broadcast supported by used bearer/bearers? */
208 if (!bb
->bcast_support
) {
209 method
->rcast
= true;
212 /* Any destinations which don't support replicast ? */
213 if (!bb
->rcast_support
) {
214 method
->rcast
= false;
217 /* Can current method be changed ? */
218 method
->expires
= jiffies
+ TIPC_METHOD_EXPIRE
;
219 if (method
->mandatory
|| time_before(jiffies
, exp
))
222 /* Determine method to use now */
223 method
->rcast
= dests
<= bb
->bc_threshold
;
226 /* tipc_bcast_xmit - broadcast the buffer chain to all external nodes
227 * @net: the applicable net namespace
228 * @pkts: chain of buffers containing message
229 * @cong_link_cnt: set to 1 if broadcast link is congested, otherwise 0
230 * Consumes the buffer chain.
231 * Returns 0 if success, otherwise errno: -EHOSTUNREACH,-EMSGSIZE
233 static int tipc_bcast_xmit(struct net
*net
, struct sk_buff_head
*pkts
,
236 struct tipc_link
*l
= tipc_bc_sndlink(net
);
237 struct sk_buff_head xmitq
;
240 skb_queue_head_init(&xmitq
);
241 tipc_bcast_lock(net
);
242 if (tipc_link_bc_peers(l
))
243 rc
= tipc_link_xmit(l
, pkts
, &xmitq
);
244 tipc_bcast_unlock(net
);
245 tipc_bcbase_xmit(net
, &xmitq
);
246 __skb_queue_purge(pkts
);
247 if (rc
== -ELINKCONG
) {
254 /* tipc_rcast_xmit - replicate and send a message to given destination nodes
255 * @net: the applicable net namespace
256 * @pkts: chain of buffers containing message
257 * @dests: list of destination nodes
258 * @cong_link_cnt: returns number of congested links
259 * @cong_links: returns identities of congested links
260 * Returns 0 if success, otherwise errno
262 static int tipc_rcast_xmit(struct net
*net
, struct sk_buff_head
*pkts
,
263 struct tipc_nlist
*dests
, u16
*cong_link_cnt
)
265 struct tipc_dest
*dst
, *tmp
;
266 struct sk_buff_head _pkts
;
269 selector
= msg_link_selector(buf_msg(skb_peek(pkts
)));
270 skb_queue_head_init(&_pkts
);
272 list_for_each_entry_safe(dst
, tmp
, &dests
->list
, list
) {
274 if (!tipc_msg_pskb_copy(dnode
, pkts
, &_pkts
))
277 /* Any other return value than -ELINKCONG is ignored */
278 if (tipc_node_xmit(net
, &_pkts
, dnode
, selector
) == -ELINKCONG
)
284 /* tipc_mcast_xmit - deliver message to indicated destination nodes
285 * and to identified node local sockets
286 * @net: the applicable net namespace
287 * @pkts: chain of buffers containing message
288 * @method: send method to be used
289 * @dests: destination nodes for message.
290 * @cong_link_cnt: returns number of encountered congested destination links
291 * Consumes buffer chain.
292 * Returns 0 if success, otherwise errno
294 int tipc_mcast_xmit(struct net
*net
, struct sk_buff_head
*pkts
,
295 struct tipc_mc_method
*method
, struct tipc_nlist
*dests
,
298 struct sk_buff_head inputq
, localq
;
301 skb_queue_head_init(&inputq
);
302 skb_queue_head_init(&localq
);
304 /* Clone packets before they are consumed by next call */
305 if (dests
->local
&& !tipc_msg_reassemble(pkts
, &localq
)) {
309 /* Send according to determined transmit method */
311 tipc_bcast_select_xmit_method(net
, dests
->remote
, method
);
313 rc
= tipc_rcast_xmit(net
, pkts
, dests
, cong_link_cnt
);
315 rc
= tipc_bcast_xmit(net
, pkts
, cong_link_cnt
);
319 tipc_sk_mcast_rcv(net
, &localq
, &inputq
);
321 /* This queue should normally be empty by now */
322 __skb_queue_purge(pkts
);
326 /* tipc_bcast_rcv - receive a broadcast packet, and deliver to rcv link
328 * RCU is locked, no other locks set
330 int tipc_bcast_rcv(struct net
*net
, struct tipc_link
*l
, struct sk_buff
*skb
)
332 struct tipc_msg
*hdr
= buf_msg(skb
);
333 struct sk_buff_head
*inputq
= &tipc_bc_base(net
)->inputq
;
334 struct sk_buff_head xmitq
;
337 __skb_queue_head_init(&xmitq
);
339 if (msg_mc_netid(hdr
) != tipc_netid(net
) || !tipc_link_is_up(l
)) {
344 tipc_bcast_lock(net
);
345 if (msg_user(hdr
) == BCAST_PROTOCOL
)
346 rc
= tipc_link_bc_nack_rcv(l
, skb
, &xmitq
);
348 rc
= tipc_link_rcv(l
, skb
, NULL
);
349 tipc_bcast_unlock(net
);
351 tipc_bcbase_xmit(net
, &xmitq
);
353 /* Any socket wakeup messages ? */
354 if (!skb_queue_empty(inputq
))
355 tipc_sk_rcv(net
, inputq
);
360 /* tipc_bcast_ack_rcv - receive and handle a broadcast acknowledge
362 * RCU is locked, no other locks set
364 void tipc_bcast_ack_rcv(struct net
*net
, struct tipc_link
*l
,
365 struct tipc_msg
*hdr
)
367 struct sk_buff_head
*inputq
= &tipc_bc_base(net
)->inputq
;
368 u16 acked
= msg_bcast_ack(hdr
);
369 struct sk_buff_head xmitq
;
371 /* Ignore bc acks sent by peer before bcast synch point was received */
372 if (msg_bc_ack_invalid(hdr
))
375 __skb_queue_head_init(&xmitq
);
377 tipc_bcast_lock(net
);
378 tipc_link_bc_ack_rcv(l
, acked
, &xmitq
);
379 tipc_bcast_unlock(net
);
381 tipc_bcbase_xmit(net
, &xmitq
);
383 /* Any socket wakeup messages ? */
384 if (!skb_queue_empty(inputq
))
385 tipc_sk_rcv(net
, inputq
);
388 /* tipc_bcast_synch_rcv - check and update rcv link with peer's send state
390 * RCU is locked, no other locks set
392 int tipc_bcast_sync_rcv(struct net
*net
, struct tipc_link
*l
,
393 struct tipc_msg
*hdr
)
395 struct sk_buff_head
*inputq
= &tipc_bc_base(net
)->inputq
;
396 struct sk_buff_head xmitq
;
399 __skb_queue_head_init(&xmitq
);
401 tipc_bcast_lock(net
);
402 if (msg_type(hdr
) != STATE_MSG
) {
403 tipc_link_bc_init_rcv(l
, hdr
);
404 } else if (!msg_bc_ack_invalid(hdr
)) {
405 tipc_link_bc_ack_rcv(l
, msg_bcast_ack(hdr
), &xmitq
);
406 rc
= tipc_link_bc_sync_rcv(l
, hdr
, &xmitq
);
408 tipc_bcast_unlock(net
);
410 tipc_bcbase_xmit(net
, &xmitq
);
412 /* Any socket wakeup messages ? */
413 if (!skb_queue_empty(inputq
))
414 tipc_sk_rcv(net
, inputq
);
418 /* tipc_bcast_add_peer - add a peer node to broadcast link and bearer
420 * RCU is locked, node lock is set
422 void tipc_bcast_add_peer(struct net
*net
, struct tipc_link
*uc_l
,
423 struct sk_buff_head
*xmitq
)
425 struct tipc_link
*snd_l
= tipc_bc_sndlink(net
);
427 tipc_bcast_lock(net
);
428 tipc_link_add_bc_peer(snd_l
, uc_l
, xmitq
);
429 tipc_bcbase_select_primary(net
);
430 tipc_bcbase_calc_bc_threshold(net
);
431 tipc_bcast_unlock(net
);
434 /* tipc_bcast_remove_peer - remove a peer node from broadcast link and bearer
436 * RCU is locked, node lock is set
438 void tipc_bcast_remove_peer(struct net
*net
, struct tipc_link
*rcv_l
)
440 struct tipc_link
*snd_l
= tipc_bc_sndlink(net
);
441 struct sk_buff_head
*inputq
= &tipc_bc_base(net
)->inputq
;
442 struct sk_buff_head xmitq
;
444 __skb_queue_head_init(&xmitq
);
446 tipc_bcast_lock(net
);
447 tipc_link_remove_bc_peer(snd_l
, rcv_l
, &xmitq
);
448 tipc_bcbase_select_primary(net
);
449 tipc_bcbase_calc_bc_threshold(net
);
450 tipc_bcast_unlock(net
);
452 tipc_bcbase_xmit(net
, &xmitq
);
454 /* Any socket wakeup messages ? */
455 if (!skb_queue_empty(inputq
))
456 tipc_sk_rcv(net
, inputq
);
459 int tipc_bclink_reset_stats(struct net
*net
)
461 struct tipc_link
*l
= tipc_bc_sndlink(net
);
466 tipc_bcast_lock(net
);
467 tipc_link_reset_stats(l
);
468 tipc_bcast_unlock(net
);
472 static int tipc_bc_link_set_queue_limits(struct net
*net
, u32 limit
)
474 struct tipc_link
*l
= tipc_bc_sndlink(net
);
478 if (limit
< BCLINK_WIN_MIN
)
479 limit
= BCLINK_WIN_MIN
;
480 if (limit
> TIPC_MAX_LINK_WIN
)
482 tipc_bcast_lock(net
);
483 tipc_link_set_queue_limits(l
, limit
);
484 tipc_bcast_unlock(net
);
488 int tipc_nl_bc_link_set(struct net
*net
, struct nlattr
*attrs
[])
492 struct nlattr
*props
[TIPC_NLA_PROP_MAX
+ 1];
494 if (!attrs
[TIPC_NLA_LINK_PROP
])
497 err
= tipc_nl_parse_link_prop(attrs
[TIPC_NLA_LINK_PROP
], props
);
501 if (!props
[TIPC_NLA_PROP_WIN
])
504 win
= nla_get_u32(props
[TIPC_NLA_PROP_WIN
]);
506 return tipc_bc_link_set_queue_limits(net
, win
);
509 int tipc_bcast_init(struct net
*net
)
511 struct tipc_net
*tn
= tipc_net(net
);
512 struct tipc_bc_base
*bb
= NULL
;
513 struct tipc_link
*l
= NULL
;
515 bb
= kzalloc(sizeof(*bb
), GFP_KERNEL
);
519 spin_lock_init(&tipc_net(net
)->bclock
);
521 if (!tipc_link_bc_create(net
, 0, 0,
533 bb
->rcast_support
= true;
541 void tipc_bcast_stop(struct net
*net
)
543 struct tipc_net
*tn
= net_generic(net
, tipc_net_id
);
550 void tipc_nlist_init(struct tipc_nlist
*nl
, u32 self
)
552 memset(nl
, 0, sizeof(*nl
));
553 INIT_LIST_HEAD(&nl
->list
);
557 void tipc_nlist_add(struct tipc_nlist
*nl
, u32 node
)
559 if (node
== nl
->self
)
561 else if (tipc_dest_push(&nl
->list
, node
, 0))
565 void tipc_nlist_del(struct tipc_nlist
*nl
, u32 node
)
567 if (node
== nl
->self
)
569 else if (tipc_dest_del(&nl
->list
, node
, 0))
573 void tipc_nlist_purge(struct tipc_nlist
*nl
)
575 tipc_dest_list_purge(&nl
->list
);