blob: a3bfd40649125721809b51ca419770d6321dd8ad [file] [log] [blame]
Per Lidenb97bf3f2006-01-02 19:04:38 +01001/*
2 * net/tipc/bcast.c: TIPC broadcast code
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +09003 *
Per Liden593a5f22006-01-11 19:14:19 +01004 * Copyright (c) 2004-2006, Ericsson AB
Per Lidenb97bf3f2006-01-02 19:04:38 +01005 * Copyright (c) 2004, Intel Corporation.
6 * Copyright (c) 2005, Wind River Systems
Per Lidenb97bf3f2006-01-02 19:04:38 +01007 * All rights reserved.
8 *
Per Liden9ea1fd32006-01-11 13:30:43 +01009 * Redistribution and use in source and binary forms, with or without
Per Lidenb97bf3f2006-01-02 19:04:38 +010010 * modification, are permitted provided that the following conditions are met:
11 *
Per Liden9ea1fd32006-01-11 13:30:43 +010012 * 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.
Per Lidenb97bf3f2006-01-02 19:04:38 +010020 *
Per Liden9ea1fd32006-01-11 13:30:43 +010021 * 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.
24 *
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
Per Lidenb97bf3f2006-01-02 19:04:38 +010035 * POSSIBILITY OF SUCH DAMAGE.
36 */
37
38#include "core.h"
39#include "msg.h"
40#include "dbg.h"
41#include "link.h"
42#include "net.h"
43#include "node.h"
44#include "port.h"
45#include "addr.h"
46#include "node_subscr.h"
47#include "name_distr.h"
48#include "bearer.h"
49#include "name_table.h"
50#include "bcast.h"
51
Per Lidenb97bf3f2006-01-02 19:04:38 +010052#define MAX_PKT_DEFAULT_MCAST 1500 /* bcast link max packet size (fixed) */
53
54#define BCLINK_WIN_DEFAULT 20 /* bcast link window size (default) */
55
56#define BCLINK_LOG_BUF_SIZE 0
57
Allan Stephensd356eeb2006-06-25 23:40:01 -070058/*
59 * Loss rate for incoming broadcast frames; used to test retransmission code.
60 * Set to N to cause every N'th frame to be discarded; 0 => don't discard any.
61 */
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +090062
Allan Stephensd356eeb2006-06-25 23:40:01 -070063#define TIPC_BCAST_LOSS_RATE 0
64
Per Lidenb97bf3f2006-01-02 19:04:38 +010065/**
66 * struct bcbearer_pair - a pair of bearers used by broadcast link
67 * @primary: pointer to primary bearer
68 * @secondary: pointer to secondary bearer
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +090069 *
70 * Bearers must have same priority and same set of reachable destinations
Per Lidenb97bf3f2006-01-02 19:04:38 +010071 * to be paired.
72 */
73
74struct bcbearer_pair {
75 struct bearer *primary;
76 struct bearer *secondary;
77};
78
79/**
80 * struct bcbearer - bearer used by broadcast link
81 * @bearer: (non-standard) broadcast bearer structure
82 * @media: (non-standard) broadcast media structure
83 * @bpairs: array of bearer pairs
Allan Stephens65f51ef2006-06-25 23:53:20 -070084 * @bpairs_temp: temporary array of bearer pairs used by tipc_bcbearer_sort()
85 * @remains: temporary node map used by tipc_bcbearer_send()
86 * @remains_new: temporary node map used tipc_bcbearer_send()
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +090087 *
Allan Stephens65f51ef2006-06-25 23:53:20 -070088 * Note: The fields labelled "temporary" are incorporated into the bearer
89 * to avoid consuming potentially limited stack space through the use of
90 * large local variables within multicast routines. Concurrent access is
91 * prevented through use of the spinlock "bc_lock".
Per Lidenb97bf3f2006-01-02 19:04:38 +010092 */
93
94struct bcbearer {
95 struct bearer bearer;
96 struct media media;
97 struct bcbearer_pair bpairs[MAX_BEARERS];
Per Liden16cb4b32006-01-13 22:22:22 +010098 struct bcbearer_pair bpairs_temp[TIPC_MAX_LINK_PRI + 1];
David S. Miller6c000552008-09-02 23:38:32 -070099 struct tipc_node_map remains;
100 struct tipc_node_map remains_new;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100101};
102
103/**
104 * struct bclink - link used for broadcast messages
105 * @link: (non-standard) broadcast link structure
106 * @node: (non-standard) node structure representing b'cast link's peer node
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900107 *
Per Lidenb97bf3f2006-01-02 19:04:38 +0100108 * Handles sequence numbering, fragmentation, bundling, etc.
109 */
110
111struct bclink {
112 struct link link;
David S. Miller6c000552008-09-02 23:38:32 -0700113 struct tipc_node node;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100114};
115
116
117static struct bcbearer *bcbearer = NULL;
118static struct bclink *bclink = NULL;
119static struct link *bcl = NULL;
Ingo Molnar34af9462006-06-27 02:53:55 -0700120static DEFINE_SPINLOCK(bc_lock);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100121
Stephen Hemminger4b704d52009-03-18 19:11:29 -0700122const char tipc_bclink_name[] = "multicast-link";
Per Lidenb97bf3f2006-01-02 19:04:38 +0100123
124
Sam Ravnborg05790c62006-03-20 22:37:04 -0800125static u32 buf_seqno(struct sk_buff *buf)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100126{
127 return msg_seqno(buf_msg(buf));
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900128}
Per Lidenb97bf3f2006-01-02 19:04:38 +0100129
Sam Ravnborg05790c62006-03-20 22:37:04 -0800130static u32 bcbuf_acks(struct sk_buff *buf)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100131{
David S. Miller880b0052006-01-12 13:22:32 -0800132 return (u32)(unsigned long)TIPC_SKB_CB(buf)->handle;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100133}
134
Sam Ravnborg05790c62006-03-20 22:37:04 -0800135static void bcbuf_set_acks(struct sk_buff *buf, u32 acks)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100136{
David S. Miller880b0052006-01-12 13:22:32 -0800137 TIPC_SKB_CB(buf)->handle = (void *)(unsigned long)acks;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100138}
139
Sam Ravnborg05790c62006-03-20 22:37:04 -0800140static void bcbuf_decr_acks(struct sk_buff *buf)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100141{
142 bcbuf_set_acks(buf, bcbuf_acks(buf) - 1);
143}
144
145
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900146/**
Per Lidenb97bf3f2006-01-02 19:04:38 +0100147 * bclink_set_gap - set gap according to contents of current deferred pkt queue
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900148 *
Per Lidenb97bf3f2006-01-02 19:04:38 +0100149 * Called with 'node' locked, bc_lock unlocked
150 */
151
David S. Miller6c000552008-09-02 23:38:32 -0700152static void bclink_set_gap(struct tipc_node *n_ptr)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100153{
154 struct sk_buff *buf = n_ptr->bclink.deferred_head;
155
156 n_ptr->bclink.gap_after = n_ptr->bclink.gap_to =
157 mod(n_ptr->bclink.last_in);
158 if (unlikely(buf != NULL))
159 n_ptr->bclink.gap_to = mod(buf_seqno(buf) - 1);
160}
161
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900162/**
Per Lidenb97bf3f2006-01-02 19:04:38 +0100163 * bclink_ack_allowed - test if ACK or NACK message can be sent at this moment
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900164 *
Per Lidenb97bf3f2006-01-02 19:04:38 +0100165 * This mechanism endeavours to prevent all nodes in network from trying
166 * to ACK or NACK at the same time.
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900167 *
Per Lidenb97bf3f2006-01-02 19:04:38 +0100168 * Note: TIPC uses a different trigger to distribute ACKs than it does to
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900169 * distribute NACKs, but tries to use the same spacing (divide by 16).
Per Lidenb97bf3f2006-01-02 19:04:38 +0100170 */
171
Sam Ravnborg05790c62006-03-20 22:37:04 -0800172static int bclink_ack_allowed(u32 n)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100173{
174 return((n % TIPC_MIN_LINK_WIN) == tipc_own_tag);
175}
176
177
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900178/**
Per Lidenb97bf3f2006-01-02 19:04:38 +0100179 * bclink_retransmit_pkt - retransmit broadcast packets
180 * @after: sequence number of last packet to *not* retransmit
181 * @to: sequence number of last packet to retransmit
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900182 *
Allan Stephensd356eeb2006-06-25 23:40:01 -0700183 * Called with bc_lock locked
Per Lidenb97bf3f2006-01-02 19:04:38 +0100184 */
185
186static void bclink_retransmit_pkt(u32 after, u32 to)
187{
188 struct sk_buff *buf;
189
Per Lidenb97bf3f2006-01-02 19:04:38 +0100190 buf = bcl->first_out;
191 while (buf && less_eq(buf_seqno(buf), after)) {
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900192 buf = buf->next;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100193 }
Allan Stephensd356eeb2006-06-25 23:40:01 -0700194 tipc_link_retransmit(bcl, buf, mod(to - after));
Per Lidenb97bf3f2006-01-02 19:04:38 +0100195}
196
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900197/**
Per Liden4323add2006-01-18 00:38:21 +0100198 * tipc_bclink_acknowledge - handle acknowledgement of broadcast packets
Per Lidenb97bf3f2006-01-02 19:04:38 +0100199 * @n_ptr: node that sent acknowledgement info
200 * @acked: broadcast sequence # that has been acknowledged
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900201 *
Per Lidenb97bf3f2006-01-02 19:04:38 +0100202 * Node is locked, bc_lock unlocked.
203 */
204
David S. Miller6c000552008-09-02 23:38:32 -0700205void tipc_bclink_acknowledge(struct tipc_node *n_ptr, u32 acked)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100206{
207 struct sk_buff *crs;
208 struct sk_buff *next;
209 unsigned int released = 0;
210
211 if (less_eq(acked, n_ptr->bclink.acked))
212 return;
213
214 spin_lock_bh(&bc_lock);
215
216 /* Skip over packets that node has previously acknowledged */
217
218 crs = bcl->first_out;
219 while (crs && less_eq(buf_seqno(crs), n_ptr->bclink.acked)) {
220 crs = crs->next;
221 }
222
223 /* Update packets that node is now acknowledging */
224
225 while (crs && less_eq(buf_seqno(crs), acked)) {
226 next = crs->next;
227 bcbuf_decr_acks(crs);
228 if (bcbuf_acks(crs) == 0) {
229 bcl->first_out = next;
230 bcl->out_queue_size--;
231 buf_discard(crs);
232 released = 1;
233 }
234 crs = next;
235 }
236 n_ptr->bclink.acked = acked;
237
238 /* Try resolving broadcast link congestion, if necessary */
239
240 if (unlikely(bcl->next_out))
Per Liden4323add2006-01-18 00:38:21 +0100241 tipc_link_push_queue(bcl);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100242 if (unlikely(released && !list_empty(&bcl->waiting_ports)))
Per Liden4323add2006-01-18 00:38:21 +0100243 tipc_link_wakeup_ports(bcl, 0);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100244 spin_unlock_bh(&bc_lock);
245}
246
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900247/**
Per Lidenb97bf3f2006-01-02 19:04:38 +0100248 * bclink_send_ack - unicast an ACK msg
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900249 *
Per Liden4323add2006-01-18 00:38:21 +0100250 * tipc_net_lock and node lock set
Per Lidenb97bf3f2006-01-02 19:04:38 +0100251 */
252
David S. Miller6c000552008-09-02 23:38:32 -0700253static void bclink_send_ack(struct tipc_node *n_ptr)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100254{
255 struct link *l_ptr = n_ptr->active_links[n_ptr->addr & 1];
256
257 if (l_ptr != NULL)
Per Liden4323add2006-01-18 00:38:21 +0100258 tipc_link_send_proto_msg(l_ptr, STATE_MSG, 0, 0, 0, 0, 0);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100259}
260
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900261/**
Per Lidenb97bf3f2006-01-02 19:04:38 +0100262 * bclink_send_nack- broadcast a NACK msg
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900263 *
Per Liden4323add2006-01-18 00:38:21 +0100264 * tipc_net_lock and node lock set
Per Lidenb97bf3f2006-01-02 19:04:38 +0100265 */
266
David S. Miller6c000552008-09-02 23:38:32 -0700267static void bclink_send_nack(struct tipc_node *n_ptr)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100268{
269 struct sk_buff *buf;
270 struct tipc_msg *msg;
271
272 if (!less(n_ptr->bclink.gap_after, n_ptr->bclink.gap_to))
273 return;
274
275 buf = buf_acquire(INT_H_SIZE);
276 if (buf) {
277 msg = buf_msg(buf);
278 msg_init(msg, BCAST_PROTOCOL, STATE_MSG,
Allan Stephens75715212008-06-04 17:37:34 -0700279 INT_H_SIZE, n_ptr->addr);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100280 msg_set_mc_netid(msg, tipc_net_id);
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900281 msg_set_bcast_ack(msg, mod(n_ptr->bclink.last_in));
Per Lidenb97bf3f2006-01-02 19:04:38 +0100282 msg_set_bcgap_after(msg, n_ptr->bclink.gap_after);
283 msg_set_bcgap_to(msg, n_ptr->bclink.gap_to);
284 msg_set_bcast_tag(msg, tipc_own_tag);
285
Sam Ravnborg1fc54d82006-03-20 22:36:47 -0800286 if (tipc_bearer_send(&bcbearer->bearer, buf, NULL)) {
Per Lidenb97bf3f2006-01-02 19:04:38 +0100287 bcl->stats.sent_nacks++;
288 buf_discard(buf);
289 } else {
Per Liden4323add2006-01-18 00:38:21 +0100290 tipc_bearer_schedule(bcl->b_ptr, bcl);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100291 bcl->proto_msg_queue = buf;
292 bcl->stats.bearer_congs++;
293 }
294
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900295 /*
Per Lidenb97bf3f2006-01-02 19:04:38 +0100296 * Ensure we doesn't send another NACK msg to the node
297 * until 16 more deferred messages arrive from it
298 * (i.e. helps prevent all nodes from NACK'ing at same time)
299 */
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900300
Per Lidenb97bf3f2006-01-02 19:04:38 +0100301 n_ptr->bclink.nack_sync = tipc_own_tag;
302 }
303}
304
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900305/**
Per Liden4323add2006-01-18 00:38:21 +0100306 * tipc_bclink_check_gap - send a NACK if a sequence gap exists
Per Lidenb97bf3f2006-01-02 19:04:38 +0100307 *
Per Liden4323add2006-01-18 00:38:21 +0100308 * tipc_net_lock and node lock set
Per Lidenb97bf3f2006-01-02 19:04:38 +0100309 */
310
David S. Miller6c000552008-09-02 23:38:32 -0700311void tipc_bclink_check_gap(struct tipc_node *n_ptr, u32 last_sent)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100312{
313 if (!n_ptr->bclink.supported ||
314 less_eq(last_sent, mod(n_ptr->bclink.last_in)))
315 return;
316
317 bclink_set_gap(n_ptr);
318 if (n_ptr->bclink.gap_after == n_ptr->bclink.gap_to)
319 n_ptr->bclink.gap_to = last_sent;
320 bclink_send_nack(n_ptr);
321}
322
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900323/**
Per Liden4323add2006-01-18 00:38:21 +0100324 * tipc_bclink_peek_nack - process a NACK msg meant for another node
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900325 *
Per Liden4323add2006-01-18 00:38:21 +0100326 * Only tipc_net_lock set.
Per Lidenb97bf3f2006-01-02 19:04:38 +0100327 */
328
Adrian Bunk988f0882006-03-20 22:37:52 -0800329static void tipc_bclink_peek_nack(u32 dest, u32 sender_tag, u32 gap_after, u32 gap_to)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100330{
David S. Miller6c000552008-09-02 23:38:32 -0700331 struct tipc_node *n_ptr = tipc_node_find(dest);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100332 u32 my_after, my_to;
333
Per Liden4323add2006-01-18 00:38:21 +0100334 if (unlikely(!n_ptr || !tipc_node_is_up(n_ptr)))
Per Lidenb97bf3f2006-01-02 19:04:38 +0100335 return;
Per Liden4323add2006-01-18 00:38:21 +0100336 tipc_node_lock(n_ptr);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100337 /*
338 * Modify gap to suppress unnecessary NACKs from this node
339 */
340 my_after = n_ptr->bclink.gap_after;
341 my_to = n_ptr->bclink.gap_to;
342
343 if (less_eq(gap_after, my_after)) {
344 if (less(my_after, gap_to) && less(gap_to, my_to))
345 n_ptr->bclink.gap_after = gap_to;
346 else if (less_eq(my_to, gap_to))
347 n_ptr->bclink.gap_to = n_ptr->bclink.gap_after;
348 } else if (less_eq(gap_after, my_to)) {
349 if (less_eq(my_to, gap_to))
350 n_ptr->bclink.gap_to = gap_after;
351 } else {
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900352 /*
Per Lidenb97bf3f2006-01-02 19:04:38 +0100353 * Expand gap if missing bufs not in deferred queue:
354 */
355 struct sk_buff *buf = n_ptr->bclink.deferred_head;
356 u32 prev = n_ptr->bclink.gap_to;
357
358 for (; buf; buf = buf->next) {
359 u32 seqno = buf_seqno(buf);
360
Eric Sesterhenn3ac90212006-06-25 23:41:15 -0700361 if (mod(seqno - prev) != 1) {
Per Lidenb97bf3f2006-01-02 19:04:38 +0100362 buf = NULL;
Eric Sesterhenn3ac90212006-06-25 23:41:15 -0700363 break;
364 }
Per Lidenb97bf3f2006-01-02 19:04:38 +0100365 if (seqno == gap_after)
366 break;
367 prev = seqno;
368 }
369 if (buf == NULL)
370 n_ptr->bclink.gap_to = gap_after;
371 }
372 /*
373 * Some nodes may send a complementary NACK now:
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900374 */
Per Lidenb97bf3f2006-01-02 19:04:38 +0100375 if (bclink_ack_allowed(sender_tag + 1)) {
376 if (n_ptr->bclink.gap_to != n_ptr->bclink.gap_after) {
377 bclink_send_nack(n_ptr);
378 bclink_set_gap(n_ptr);
379 }
380 }
Per Liden4323add2006-01-18 00:38:21 +0100381 tipc_node_unlock(n_ptr);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100382}
383
384/**
Per Liden4323add2006-01-18 00:38:21 +0100385 * tipc_bclink_send_msg - broadcast a packet to all nodes in cluster
Per Lidenb97bf3f2006-01-02 19:04:38 +0100386 */
387
Per Liden4323add2006-01-18 00:38:21 +0100388int tipc_bclink_send_msg(struct sk_buff *buf)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100389{
390 int res;
391
392 spin_lock_bh(&bc_lock);
393
Per Liden4323add2006-01-18 00:38:21 +0100394 res = tipc_link_send_buf(bcl, buf);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100395 if (unlikely(res == -ELINKCONG))
396 buf_discard(buf);
397 else
398 bcl->stats.sent_info++;
399
400 if (bcl->out_queue_size > bcl->stats.max_queue_sz)
401 bcl->stats.max_queue_sz = bcl->out_queue_size;
402 bcl->stats.queue_sz_counts++;
403 bcl->stats.accu_queue_sz += bcl->out_queue_size;
404
405 spin_unlock_bh(&bc_lock);
406 return res;
407}
408
409/**
Per Liden4323add2006-01-18 00:38:21 +0100410 * tipc_bclink_recv_pkt - receive a broadcast packet, and deliver upwards
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900411 *
Per Liden4323add2006-01-18 00:38:21 +0100412 * tipc_net_lock is read_locked, no other locks set
Per Lidenb97bf3f2006-01-02 19:04:38 +0100413 */
414
Per Liden4323add2006-01-18 00:38:21 +0100415void tipc_bclink_recv_pkt(struct sk_buff *buf)
Allan Stephensd356eeb2006-06-25 23:40:01 -0700416{
417#if (TIPC_BCAST_LOSS_RATE)
418 static int rx_count = 0;
419#endif
Per Lidenb97bf3f2006-01-02 19:04:38 +0100420 struct tipc_msg *msg = buf_msg(buf);
David S. Miller6c000552008-09-02 23:38:32 -0700421 struct tipc_node* node = tipc_node_find(msg_prevnode(msg));
Per Lidenb97bf3f2006-01-02 19:04:38 +0100422 u32 next_in;
423 u32 seqno;
424 struct sk_buff *deferred;
425
426 msg_dbg(msg, "<BC<<<");
427
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900428 if (unlikely(!node || !tipc_node_is_up(node) || !node->bclink.supported ||
Per Lidenb97bf3f2006-01-02 19:04:38 +0100429 (msg_mc_netid(msg) != tipc_net_id))) {
430 buf_discard(buf);
431 return;
432 }
433
434 if (unlikely(msg_user(msg) == BCAST_PROTOCOL)) {
435 msg_dbg(msg, "<BCNACK<<<");
436 if (msg_destnode(msg) == tipc_own_addr) {
Per Liden4323add2006-01-18 00:38:21 +0100437 tipc_node_lock(node);
438 tipc_bclink_acknowledge(node, msg_bcast_ack(msg));
439 tipc_node_unlock(node);
Allan Stephensd356eeb2006-06-25 23:40:01 -0700440 spin_lock_bh(&bc_lock);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100441 bcl->stats.recv_nacks++;
Allan Stephensd356eeb2006-06-25 23:40:01 -0700442 bcl->owner->next = node; /* remember requestor */
Per Lidenb97bf3f2006-01-02 19:04:38 +0100443 bclink_retransmit_pkt(msg_bcgap_after(msg),
444 msg_bcgap_to(msg));
Allan Stephensd356eeb2006-06-25 23:40:01 -0700445 bcl->owner->next = NULL;
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900446 spin_unlock_bh(&bc_lock);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100447 } else {
Per Liden4323add2006-01-18 00:38:21 +0100448 tipc_bclink_peek_nack(msg_destnode(msg),
Adrian Bunk988f0882006-03-20 22:37:52 -0800449 msg_bcast_tag(msg),
450 msg_bcgap_after(msg),
451 msg_bcgap_to(msg));
Per Lidenb97bf3f2006-01-02 19:04:38 +0100452 }
453 buf_discard(buf);
454 return;
455 }
456
Allan Stephensd356eeb2006-06-25 23:40:01 -0700457#if (TIPC_BCAST_LOSS_RATE)
458 if (++rx_count == TIPC_BCAST_LOSS_RATE) {
459 rx_count = 0;
460 buf_discard(buf);
461 return;
462 }
463#endif
464
Per Liden4323add2006-01-18 00:38:21 +0100465 tipc_node_lock(node);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100466receive:
467 deferred = node->bclink.deferred_head;
468 next_in = mod(node->bclink.last_in + 1);
469 seqno = msg_seqno(msg);
470
471 if (likely(seqno == next_in)) {
472 bcl->stats.recv_info++;
473 node->bclink.last_in++;
474 bclink_set_gap(node);
475 if (unlikely(bclink_ack_allowed(seqno))) {
476 bclink_send_ack(node);
477 bcl->stats.sent_acks++;
478 }
479 if (likely(msg_isdata(msg))) {
Per Liden4323add2006-01-18 00:38:21 +0100480 tipc_node_unlock(node);
481 tipc_port_recv_mcast(buf, NULL);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100482 } else if (msg_user(msg) == MSG_BUNDLER) {
483 bcl->stats.recv_bundles++;
484 bcl->stats.recv_bundled += msg_msgcnt(msg);
Per Liden4323add2006-01-18 00:38:21 +0100485 tipc_node_unlock(node);
486 tipc_link_recv_bundle(buf);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100487 } else if (msg_user(msg) == MSG_FRAGMENTER) {
488 bcl->stats.recv_fragments++;
Per Liden4323add2006-01-18 00:38:21 +0100489 if (tipc_link_recv_fragment(&node->bclink.defragm,
490 &buf, &msg))
Per Lidenb97bf3f2006-01-02 19:04:38 +0100491 bcl->stats.recv_fragmented++;
Per Liden4323add2006-01-18 00:38:21 +0100492 tipc_node_unlock(node);
493 tipc_net_route_msg(buf);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100494 } else {
Per Liden4323add2006-01-18 00:38:21 +0100495 tipc_node_unlock(node);
496 tipc_net_route_msg(buf);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100497 }
498 if (deferred && (buf_seqno(deferred) == mod(next_in + 1))) {
Per Liden4323add2006-01-18 00:38:21 +0100499 tipc_node_lock(node);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100500 buf = deferred;
501 msg = buf_msg(buf);
502 node->bclink.deferred_head = deferred->next;
503 goto receive;
504 }
505 return;
506 } else if (less(next_in, seqno)) {
507 u32 gap_after = node->bclink.gap_after;
508 u32 gap_to = node->bclink.gap_to;
509
Per Liden4323add2006-01-18 00:38:21 +0100510 if (tipc_link_defer_pkt(&node->bclink.deferred_head,
511 &node->bclink.deferred_tail,
512 buf)) {
Per Lidenb97bf3f2006-01-02 19:04:38 +0100513 node->bclink.nack_sync++;
514 bcl->stats.deferred_recv++;
515 if (seqno == mod(gap_after + 1))
516 node->bclink.gap_after = seqno;
517 else if (less(gap_after, seqno) && less(seqno, gap_to))
518 node->bclink.gap_to = seqno;
519 }
520 if (bclink_ack_allowed(node->bclink.nack_sync)) {
521 if (gap_to != gap_after)
522 bclink_send_nack(node);
523 bclink_set_gap(node);
524 }
525 } else {
526 bcl->stats.duplicates++;
527 buf_discard(buf);
528 }
Per Liden4323add2006-01-18 00:38:21 +0100529 tipc_node_unlock(node);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100530}
531
Per Liden4323add2006-01-18 00:38:21 +0100532u32 tipc_bclink_get_last_sent(void)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100533{
534 u32 last_sent = mod(bcl->next_out_no - 1);
535
536 if (bcl->next_out)
537 last_sent = mod(buf_seqno(bcl->next_out) - 1);
538 return last_sent;
539}
540
David S. Miller6c000552008-09-02 23:38:32 -0700541u32 tipc_bclink_acks_missing(struct tipc_node *n_ptr)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100542{
543 return (n_ptr->bclink.supported &&
Per Liden4323add2006-01-18 00:38:21 +0100544 (tipc_bclink_get_last_sent() != n_ptr->bclink.acked));
Per Lidenb97bf3f2006-01-02 19:04:38 +0100545}
546
547
548/**
Per Liden4323add2006-01-18 00:38:21 +0100549 * tipc_bcbearer_send - send a packet through the broadcast pseudo-bearer
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900550 *
Per Lidenb97bf3f2006-01-02 19:04:38 +0100551 * Send through as many bearers as necessary to reach all nodes
552 * that support TIPC multicasting.
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900553 *
Per Lidenb97bf3f2006-01-02 19:04:38 +0100554 * Returns 0 if packet sent successfully, non-zero if not
555 */
556
Adrian Bunk988f0882006-03-20 22:37:52 -0800557static int tipc_bcbearer_send(struct sk_buff *buf,
558 struct tipc_bearer *unused1,
559 struct tipc_media_addr *unused2)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100560{
561 static int send_count = 0;
562
Per Lidenb97bf3f2006-01-02 19:04:38 +0100563 int bp_index;
564 int swap_time;
565
566 /* Prepare buffer for broadcasting (if first time trying to send it) */
567
568 if (likely(!msg_non_seq(buf_msg(buf)))) {
569 struct tipc_msg *msg;
570
Per Liden4323add2006-01-18 00:38:21 +0100571 assert(tipc_cltr_bcast_nodes.count != 0);
572 bcbuf_set_acks(buf, tipc_cltr_bcast_nodes.count);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100573 msg = buf_msg(buf);
Allan Stephens40aecb12008-06-04 17:54:48 -0700574 msg_set_non_seq(msg, 1);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100575 msg_set_mc_netid(msg, tipc_net_id);
576 }
577
578 /* Determine if bearer pairs should be swapped following this attempt */
579
580 if ((swap_time = (++send_count >= 10)))
581 send_count = 0;
582
583 /* Send buffer over bearers until all targets reached */
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900584
Allan Stephens65f51ef2006-06-25 23:53:20 -0700585 bcbearer->remains = tipc_cltr_bcast_nodes;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100586
587 for (bp_index = 0; bp_index < MAX_BEARERS; bp_index++) {
588 struct bearer *p = bcbearer->bpairs[bp_index].primary;
589 struct bearer *s = bcbearer->bpairs[bp_index].secondary;
590
591 if (!p)
592 break; /* no more bearers to try */
593
Allan Stephens65f51ef2006-06-25 23:53:20 -0700594 tipc_nmap_diff(&bcbearer->remains, &p->nodes, &bcbearer->remains_new);
595 if (bcbearer->remains_new.count == bcbearer->remains.count)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100596 continue; /* bearer pair doesn't add anything */
597
598 if (!p->publ.blocked &&
599 !p->media->send_msg(buf, &p->publ, &p->media->bcast_addr)) {
600 if (swap_time && s && !s->publ.blocked)
601 goto swap;
602 else
603 goto update;
604 }
605
606 if (!s || s->publ.blocked ||
607 s->media->send_msg(buf, &s->publ, &s->media->bcast_addr))
608 continue; /* unable to send using bearer pair */
609swap:
610 bcbearer->bpairs[bp_index].primary = s;
611 bcbearer->bpairs[bp_index].secondary = p;
612update:
Allan Stephens65f51ef2006-06-25 23:53:20 -0700613 if (bcbearer->remains_new.count == 0)
Allan Stephens0e35fd52008-07-14 22:44:01 -0700614 return 0;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100615
Allan Stephens65f51ef2006-06-25 23:53:20 -0700616 bcbearer->remains = bcbearer->remains_new;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100617 }
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900618
Per Lidenb97bf3f2006-01-02 19:04:38 +0100619 /* Unable to reach all targets */
620
621 bcbearer->bearer.publ.blocked = 1;
622 bcl->stats.bearer_congs++;
Allan Stephens0e35fd52008-07-14 22:44:01 -0700623 return 1;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100624}
625
626/**
Per Liden4323add2006-01-18 00:38:21 +0100627 * tipc_bcbearer_sort - create sets of bearer pairs used by broadcast bearer
Per Lidenb97bf3f2006-01-02 19:04:38 +0100628 */
629
Per Liden4323add2006-01-18 00:38:21 +0100630void tipc_bcbearer_sort(void)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100631{
632 struct bcbearer_pair *bp_temp = bcbearer->bpairs_temp;
633 struct bcbearer_pair *bp_curr;
634 int b_index;
635 int pri;
636
637 spin_lock_bh(&bc_lock);
638
639 /* Group bearers by priority (can assume max of two per priority) */
640
641 memset(bp_temp, 0, sizeof(bcbearer->bpairs_temp));
642
643 for (b_index = 0; b_index < MAX_BEARERS; b_index++) {
Per Liden4323add2006-01-18 00:38:21 +0100644 struct bearer *b = &tipc_bearers[b_index];
Per Lidenb97bf3f2006-01-02 19:04:38 +0100645
646 if (!b->active || !b->nodes.count)
647 continue;
648
649 if (!bp_temp[b->priority].primary)
650 bp_temp[b->priority].primary = b;
651 else
652 bp_temp[b->priority].secondary = b;
653 }
654
655 /* Create array of bearer pairs for broadcasting */
656
657 bp_curr = bcbearer->bpairs;
658 memset(bcbearer->bpairs, 0, sizeof(bcbearer->bpairs));
659
Per Liden16cb4b32006-01-13 22:22:22 +0100660 for (pri = TIPC_MAX_LINK_PRI; pri >= 0; pri--) {
Per Lidenb97bf3f2006-01-02 19:04:38 +0100661
662 if (!bp_temp[pri].primary)
663 continue;
664
665 bp_curr->primary = bp_temp[pri].primary;
666
667 if (bp_temp[pri].secondary) {
Per Liden4323add2006-01-18 00:38:21 +0100668 if (tipc_nmap_equal(&bp_temp[pri].primary->nodes,
669 &bp_temp[pri].secondary->nodes)) {
Per Lidenb97bf3f2006-01-02 19:04:38 +0100670 bp_curr->secondary = bp_temp[pri].secondary;
671 } else {
672 bp_curr++;
673 bp_curr->primary = bp_temp[pri].secondary;
674 }
675 }
676
677 bp_curr++;
678 }
679
680 spin_unlock_bh(&bc_lock);
681}
682
683/**
Per Liden4323add2006-01-18 00:38:21 +0100684 * tipc_bcbearer_push - resolve bearer congestion
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900685 *
Per Lidenb97bf3f2006-01-02 19:04:38 +0100686 * Forces bclink to push out any unsent packets, until all packets are gone
687 * or congestion reoccurs.
688 * No locks set when function called
689 */
690
Per Liden4323add2006-01-18 00:38:21 +0100691void tipc_bcbearer_push(void)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100692{
693 struct bearer *b_ptr;
694
695 spin_lock_bh(&bc_lock);
696 b_ptr = &bcbearer->bearer;
697 if (b_ptr->publ.blocked) {
698 b_ptr->publ.blocked = 0;
Per Liden4323add2006-01-18 00:38:21 +0100699 tipc_bearer_lock_push(b_ptr);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100700 }
701 spin_unlock_bh(&bc_lock);
702}
703
704
Per Liden4323add2006-01-18 00:38:21 +0100705int tipc_bclink_stats(char *buf, const u32 buf_size)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100706{
707 struct print_buf pb;
708
709 if (!bcl)
710 return 0;
711
Per Liden4323add2006-01-18 00:38:21 +0100712 tipc_printbuf_init(&pb, buf, buf_size);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100713
714 spin_lock_bh(&bc_lock);
715
716 tipc_printf(&pb, "Link <%s>\n"
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900717 " Window:%u packets\n",
Per Lidenb97bf3f2006-01-02 19:04:38 +0100718 bcl->name, bcl->queue_limit[0]);
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900719 tipc_printf(&pb, " RX packets:%u fragments:%u/%u bundles:%u/%u\n",
Per Lidenb97bf3f2006-01-02 19:04:38 +0100720 bcl->stats.recv_info,
721 bcl->stats.recv_fragments,
722 bcl->stats.recv_fragmented,
723 bcl->stats.recv_bundles,
724 bcl->stats.recv_bundled);
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900725 tipc_printf(&pb, " TX packets:%u fragments:%u/%u bundles:%u/%u\n",
Per Lidenb97bf3f2006-01-02 19:04:38 +0100726 bcl->stats.sent_info,
727 bcl->stats.sent_fragments,
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900728 bcl->stats.sent_fragmented,
Per Lidenb97bf3f2006-01-02 19:04:38 +0100729 bcl->stats.sent_bundles,
730 bcl->stats.sent_bundled);
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900731 tipc_printf(&pb, " RX naks:%u defs:%u dups:%u\n",
Per Lidenb97bf3f2006-01-02 19:04:38 +0100732 bcl->stats.recv_nacks,
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900733 bcl->stats.deferred_recv,
Per Lidenb97bf3f2006-01-02 19:04:38 +0100734 bcl->stats.duplicates);
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900735 tipc_printf(&pb, " TX naks:%u acks:%u dups:%u\n",
736 bcl->stats.sent_nacks,
737 bcl->stats.sent_acks,
Per Lidenb97bf3f2006-01-02 19:04:38 +0100738 bcl->stats.retransmitted);
739 tipc_printf(&pb, " Congestion bearer:%u link:%u Send queue max:%u avg:%u\n",
740 bcl->stats.bearer_congs,
741 bcl->stats.link_congs,
742 bcl->stats.max_queue_sz,
743 bcl->stats.queue_sz_counts
744 ? (bcl->stats.accu_queue_sz / bcl->stats.queue_sz_counts)
745 : 0);
746
747 spin_unlock_bh(&bc_lock);
Per Liden4323add2006-01-18 00:38:21 +0100748 return tipc_printbuf_validate(&pb);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100749}
750
Per Liden4323add2006-01-18 00:38:21 +0100751int tipc_bclink_reset_stats(void)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100752{
753 if (!bcl)
754 return -ENOPROTOOPT;
755
756 spin_lock_bh(&bc_lock);
757 memset(&bcl->stats, 0, sizeof(bcl->stats));
758 spin_unlock_bh(&bc_lock);
Allan Stephens0e35fd52008-07-14 22:44:01 -0700759 return 0;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100760}
761
Per Liden4323add2006-01-18 00:38:21 +0100762int tipc_bclink_set_queue_limits(u32 limit)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100763{
764 if (!bcl)
765 return -ENOPROTOOPT;
766 if ((limit < TIPC_MIN_LINK_WIN) || (limit > TIPC_MAX_LINK_WIN))
767 return -EINVAL;
768
769 spin_lock_bh(&bc_lock);
Per Liden4323add2006-01-18 00:38:21 +0100770 tipc_link_set_queue_limits(bcl, limit);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100771 spin_unlock_bh(&bc_lock);
Allan Stephens0e35fd52008-07-14 22:44:01 -0700772 return 0;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100773}
774
Per Liden4323add2006-01-18 00:38:21 +0100775int tipc_bclink_init(void)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100776{
Arnaldo Carvalho de Melo2710b572006-11-21 01:22:12 -0200777 bcbearer = kzalloc(sizeof(*bcbearer), GFP_ATOMIC);
778 bclink = kzalloc(sizeof(*bclink), GFP_ATOMIC);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100779 if (!bcbearer || !bclink) {
780 nomem:
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900781 warn("Multicast link creation failed, no memory\n");
Per Lidenb97bf3f2006-01-02 19:04:38 +0100782 kfree(bcbearer);
783 bcbearer = NULL;
784 kfree(bclink);
785 bclink = NULL;
786 return -ENOMEM;
787 }
788
Per Lidenb97bf3f2006-01-02 19:04:38 +0100789 INIT_LIST_HEAD(&bcbearer->bearer.cong_links);
790 bcbearer->bearer.media = &bcbearer->media;
Per Liden4323add2006-01-18 00:38:21 +0100791 bcbearer->media.send_msg = tipc_bcbearer_send;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100792 sprintf(bcbearer->media.name, "tipc-multicast");
793
794 bcl = &bclink->link;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100795 INIT_LIST_HEAD(&bcl->waiting_ports);
796 bcl->next_out_no = 1;
Ingo Molnar34af9462006-06-27 02:53:55 -0700797 spin_lock_init(&bclink->node.lock);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100798 bcl->owner = &bclink->node;
YOSHIFUJI Hideakic4307282007-02-09 23:25:21 +0900799 bcl->max_pkt = MAX_PKT_DEFAULT_MCAST;
Per Liden4323add2006-01-18 00:38:21 +0100800 tipc_link_set_queue_limits(bcl, BCLINK_WIN_DEFAULT);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100801 bcl->b_ptr = &bcbearer->bearer;
802 bcl->state = WORKING_WORKING;
Stephen Hemminger4b704d52009-03-18 19:11:29 -0700803 strlcpy(bcl->name, tipc_bclink_name, TIPC_MAX_LINK_NAME);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100804
805 if (BCLINK_LOG_BUF_SIZE) {
806 char *pb = kmalloc(BCLINK_LOG_BUF_SIZE, GFP_ATOMIC);
807
808 if (!pb)
809 goto nomem;
Per Liden4323add2006-01-18 00:38:21 +0100810 tipc_printbuf_init(&bcl->print_buf, pb, BCLINK_LOG_BUF_SIZE);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100811 }
812
Allan Stephens0e35fd52008-07-14 22:44:01 -0700813 return 0;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100814}
815
Per Liden4323add2006-01-18 00:38:21 +0100816void tipc_bclink_stop(void)
Per Lidenb97bf3f2006-01-02 19:04:38 +0100817{
818 spin_lock_bh(&bc_lock);
819 if (bcbearer) {
Per Liden4323add2006-01-18 00:38:21 +0100820 tipc_link_stop(bcl);
Per Lidenb97bf3f2006-01-02 19:04:38 +0100821 if (BCLINK_LOG_BUF_SIZE)
822 kfree(bcl->print_buf.buf);
823 bcl = NULL;
824 kfree(bclink);
825 bclink = NULL;
826 kfree(bcbearer);
827 bcbearer = NULL;
828 }
829 spin_unlock_bh(&bc_lock);
830}
831