node.c 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615
  1. /*
  2. * net/tipc/node.c: TIPC node management routines
  3. *
  4. * Copyright (c) 2000-2006, 2012-2015, Ericsson AB
  5. * Copyright (c) 2005-2006, 2010-2014, Wind River Systems
  6. * All rights reserved.
  7. *
  8. * Redistribution and use in source and binary forms, with or without
  9. * modification, are permitted provided that the following conditions are met:
  10. *
  11. * 1. Redistributions of source code must retain the above copyright
  12. * notice, this list of conditions and the following disclaimer.
  13. * 2. Redistributions in binary form must reproduce the above copyright
  14. * notice, this list of conditions and the following disclaimer in the
  15. * documentation and/or other materials provided with the distribution.
  16. * 3. Neither the names of the copyright holders nor the names of its
  17. * contributors may be used to endorse or promote products derived from
  18. * this software without specific prior written permission.
  19. *
  20. * Alternatively, this software may be distributed under the terms of the
  21. * GNU General Public License ("GPL") version 2 as published by the Free
  22. * Software Foundation.
  23. *
  24. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  25. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  27. * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  28. * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  29. * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  30. * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  31. * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  32. * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  33. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  34. * POSSIBILITY OF SUCH DAMAGE.
  35. */
  36. #include "core.h"
  37. #include "link.h"
  38. #include "node.h"
  39. #include "name_distr.h"
  40. #include "socket.h"
  41. #include "bcast.h"
  42. static void node_lost_contact(struct tipc_node *n_ptr);
  43. static void node_established_contact(struct tipc_node *n_ptr);
  44. static void tipc_node_delete(struct tipc_node *node);
  45. struct tipc_sock_conn {
  46. u32 port;
  47. u32 peer_port;
  48. u32 peer_node;
  49. struct list_head list;
  50. };
  51. static const struct nla_policy tipc_nl_node_policy[TIPC_NLA_NODE_MAX + 1] = {
  52. [TIPC_NLA_NODE_UNSPEC] = { .type = NLA_UNSPEC },
  53. [TIPC_NLA_NODE_ADDR] = { .type = NLA_U32 },
  54. [TIPC_NLA_NODE_UP] = { .type = NLA_FLAG }
  55. };
  56. /*
  57. * A trivial power-of-two bitmask technique is used for speed, since this
  58. * operation is done for every incoming TIPC packet. The number of hash table
  59. * entries has been chosen so that no hash chain exceeds 8 nodes and will
  60. * usually be much smaller (typically only a single node).
  61. */
  62. static unsigned int tipc_hashfn(u32 addr)
  63. {
  64. return addr & (NODE_HTABLE_SIZE - 1);
  65. }
  66. static void tipc_node_kref_release(struct kref *kref)
  67. {
  68. struct tipc_node *node = container_of(kref, struct tipc_node, kref);
  69. tipc_node_delete(node);
  70. }
  71. void tipc_node_put(struct tipc_node *node)
  72. {
  73. kref_put(&node->kref, tipc_node_kref_release);
  74. }
  75. static void tipc_node_get(struct tipc_node *node)
  76. {
  77. kref_get(&node->kref);
  78. }
  79. /*
  80. * tipc_node_find - locate specified node object, if it exists
  81. */
  82. struct tipc_node *tipc_node_find(struct net *net, u32 addr)
  83. {
  84. struct tipc_net *tn = net_generic(net, tipc_net_id);
  85. struct tipc_node *node;
  86. if (unlikely(!in_own_cluster_exact(net, addr)))
  87. return NULL;
  88. rcu_read_lock();
  89. hlist_for_each_entry_rcu(node, &tn->node_htable[tipc_hashfn(addr)],
  90. hash) {
  91. if (node->addr == addr) {
  92. tipc_node_get(node);
  93. rcu_read_unlock();
  94. return node;
  95. }
  96. }
  97. rcu_read_unlock();
  98. return NULL;
  99. }
  100. struct tipc_node *tipc_node_create(struct net *net, u32 addr)
  101. {
  102. struct tipc_net *tn = net_generic(net, tipc_net_id);
  103. struct tipc_node *n_ptr, *temp_node;
  104. spin_lock_bh(&tn->node_list_lock);
  105. n_ptr = tipc_node_find(net, addr);
  106. if (n_ptr)
  107. goto exit;
  108. n_ptr = kzalloc(sizeof(*n_ptr), GFP_ATOMIC);
  109. if (!n_ptr) {
  110. pr_warn("Node creation failed, no memory\n");
  111. goto exit;
  112. }
  113. n_ptr->addr = addr;
  114. n_ptr->net = net;
  115. kref_init(&n_ptr->kref);
  116. spin_lock_init(&n_ptr->lock);
  117. INIT_HLIST_NODE(&n_ptr->hash);
  118. INIT_LIST_HEAD(&n_ptr->list);
  119. INIT_LIST_HEAD(&n_ptr->publ_list);
  120. INIT_LIST_HEAD(&n_ptr->conn_sks);
  121. __skb_queue_head_init(&n_ptr->bclink.deferdq);
  122. hlist_add_head_rcu(&n_ptr->hash, &tn->node_htable[tipc_hashfn(addr)]);
  123. list_for_each_entry_rcu(temp_node, &tn->node_list, list) {
  124. if (n_ptr->addr < temp_node->addr)
  125. break;
  126. }
  127. list_add_tail_rcu(&n_ptr->list, &temp_node->list);
  128. n_ptr->action_flags = TIPC_WAIT_PEER_LINKS_DOWN;
  129. n_ptr->signature = INVALID_NODE_SIG;
  130. tipc_node_get(n_ptr);
  131. exit:
  132. spin_unlock_bh(&tn->node_list_lock);
  133. return n_ptr;
  134. }
  135. static void tipc_node_delete(struct tipc_node *node)
  136. {
  137. list_del_rcu(&node->list);
  138. hlist_del_rcu(&node->hash);
  139. kfree_rcu(node, rcu);
  140. }
  141. void tipc_node_stop(struct net *net)
  142. {
  143. struct tipc_net *tn = net_generic(net, tipc_net_id);
  144. struct tipc_node *node, *t_node;
  145. spin_lock_bh(&tn->node_list_lock);
  146. list_for_each_entry_safe(node, t_node, &tn->node_list, list)
  147. tipc_node_put(node);
  148. spin_unlock_bh(&tn->node_list_lock);
  149. }
  150. int tipc_node_add_conn(struct net *net, u32 dnode, u32 port, u32 peer_port)
  151. {
  152. struct tipc_node *node;
  153. struct tipc_sock_conn *conn;
  154. int err = 0;
  155. if (in_own_node(net, dnode))
  156. return 0;
  157. node = tipc_node_find(net, dnode);
  158. if (!node) {
  159. pr_warn("Connecting sock to node 0x%x failed\n", dnode);
  160. return -EHOSTUNREACH;
  161. }
  162. conn = kmalloc(sizeof(*conn), GFP_ATOMIC);
  163. if (!conn) {
  164. err = -EHOSTUNREACH;
  165. goto exit;
  166. }
  167. conn->peer_node = dnode;
  168. conn->port = port;
  169. conn->peer_port = peer_port;
  170. tipc_node_lock(node);
  171. list_add_tail(&conn->list, &node->conn_sks);
  172. tipc_node_unlock(node);
  173. exit:
  174. tipc_node_put(node);
  175. return err;
  176. }
  177. void tipc_node_remove_conn(struct net *net, u32 dnode, u32 port)
  178. {
  179. struct tipc_node *node;
  180. struct tipc_sock_conn *conn, *safe;
  181. if (in_own_node(net, dnode))
  182. return;
  183. node = tipc_node_find(net, dnode);
  184. if (!node)
  185. return;
  186. tipc_node_lock(node);
  187. list_for_each_entry_safe(conn, safe, &node->conn_sks, list) {
  188. if (port != conn->port)
  189. continue;
  190. list_del(&conn->list);
  191. kfree(conn);
  192. }
  193. tipc_node_unlock(node);
  194. tipc_node_put(node);
  195. }
  196. /**
  197. * tipc_node_link_up - handle addition of link
  198. *
  199. * Link becomes active (alone or shared) or standby, depending on its priority.
  200. */
  201. void tipc_node_link_up(struct tipc_node *n, int bearer_id)
  202. {
  203. struct tipc_link_entry **actv = &n->active_links[0];
  204. struct tipc_link_entry *le = &n->links[bearer_id];
  205. struct tipc_link *l = le->link;
  206. /* Leave room for tunnel header when returning 'mtu' to users: */
  207. n->links[bearer_id].mtu = l->mtu - INT_H_SIZE;
  208. n->working_links++;
  209. n->action_flags |= TIPC_NOTIFY_LINK_UP;
  210. n->link_id = l->peer_bearer_id << 16 | l->bearer_id;
  211. pr_debug("Established link <%s> on network plane %c\n",
  212. l->name, l->net_plane);
  213. /* No active links ? => take both active slots */
  214. if (!actv[0]) {
  215. actv[0] = le;
  216. actv[1] = le;
  217. node_established_contact(n);
  218. return;
  219. }
  220. if (l->priority < actv[0]->link->priority) {
  221. pr_debug("New link <%s> becomes standby\n", l->name);
  222. return;
  223. }
  224. tipc_link_dup_queue_xmit(actv[0]->link, l);
  225. /* Take one active slot if applicable */
  226. if (l->priority == actv[0]->link->priority) {
  227. actv[0] = le;
  228. return;
  229. }
  230. /* Higher prio than current active? => take both active slots */
  231. pr_debug("Old l <%s> becomes standby\n", actv[0]->link->name);
  232. if (actv[1] != actv[0])
  233. pr_debug("Old link <%s> now standby\n", actv[1]->link->name);
  234. actv[0] = le;
  235. actv[1] = le;
  236. }
  237. /**
  238. * node_select_active_links - select which working links should be active
  239. */
  240. static void node_select_active_links(struct tipc_node *n)
  241. {
  242. struct tipc_link_entry **actv = &n->active_links[0];
  243. struct tipc_link *l;
  244. u32 b, highest = 0;
  245. actv[0] = NULL;
  246. actv[1] = NULL;
  247. for (b = 0; b < MAX_BEARERS; b++) {
  248. l = n->links[b].link;
  249. if (!l || !tipc_link_is_up(l) || (l->priority < highest))
  250. continue;
  251. if (l->priority > highest) {
  252. highest = l->priority;
  253. actv[0] = &n->links[b];
  254. actv[1] = &n->links[b];
  255. continue;
  256. }
  257. actv[1] = &n->links[b];
  258. }
  259. }
  260. /**
  261. * tipc_node_link_down - handle loss of link
  262. */
  263. void tipc_node_link_down(struct tipc_node *n, int bearer_id)
  264. {
  265. struct tipc_link_entry **actv = &n->active_links[0];
  266. struct tipc_link_entry *le = &n->links[bearer_id];
  267. struct tipc_link *l = le->link;
  268. n->working_links--;
  269. n->action_flags |= TIPC_NOTIFY_LINK_DOWN;
  270. n->link_id = l->peer_bearer_id << 16 | l->bearer_id;
  271. if (!tipc_link_is_active(l)) {
  272. pr_debug("Lost standby link <%s> on network plane %c\n",
  273. l->name, l->net_plane);
  274. return;
  275. }
  276. pr_debug("Lost link <%s> on network plane %c\n",
  277. l->name, l->net_plane);
  278. /* Resdistribute active slots if applicable */
  279. if (actv[0] == le)
  280. actv[0] = actv[1];
  281. if (actv[1] == le)
  282. actv[1] = actv[0];
  283. /* Last link of this priority? => select other ones if available */
  284. if (actv[0] == le)
  285. node_select_active_links(n);
  286. if (tipc_node_is_up(n))
  287. tipc_link_failover_send_queue(l);
  288. else
  289. node_lost_contact(n);
  290. }
  291. bool tipc_node_is_up(struct tipc_node *n)
  292. {
  293. return n->active_links[0];
  294. }
  295. void tipc_node_attach_link(struct tipc_node *n_ptr, struct tipc_link *l_ptr)
  296. {
  297. n_ptr->links[l_ptr->bearer_id].link = l_ptr;
  298. n_ptr->link_cnt++;
  299. }
  300. void tipc_node_detach_link(struct tipc_node *n_ptr, struct tipc_link *l_ptr)
  301. {
  302. int i;
  303. for (i = 0; i < MAX_BEARERS; i++) {
  304. if (l_ptr != n_ptr->links[i].link)
  305. continue;
  306. n_ptr->links[i].link = NULL;
  307. n_ptr->link_cnt--;
  308. }
  309. }
  310. static void node_established_contact(struct tipc_node *n_ptr)
  311. {
  312. n_ptr->action_flags |= TIPC_NOTIFY_NODE_UP;
  313. n_ptr->bclink.oos_state = 0;
  314. n_ptr->bclink.acked = tipc_bclink_get_last_sent(n_ptr->net);
  315. tipc_bclink_add_node(n_ptr->net, n_ptr->addr);
  316. }
  317. static void node_lost_contact(struct tipc_node *n_ptr)
  318. {
  319. char addr_string[16];
  320. struct tipc_sock_conn *conn, *safe;
  321. struct list_head *conns = &n_ptr->conn_sks;
  322. struct sk_buff *skb;
  323. struct tipc_net *tn = net_generic(n_ptr->net, tipc_net_id);
  324. uint i;
  325. pr_debug("Lost contact with %s\n",
  326. tipc_addr_string_fill(addr_string, n_ptr->addr));
  327. /* Flush broadcast link info associated with lost node */
  328. if (n_ptr->bclink.recv_permitted) {
  329. __skb_queue_purge(&n_ptr->bclink.deferdq);
  330. if (n_ptr->bclink.reasm_buf) {
  331. kfree_skb(n_ptr->bclink.reasm_buf);
  332. n_ptr->bclink.reasm_buf = NULL;
  333. }
  334. tipc_bclink_remove_node(n_ptr->net, n_ptr->addr);
  335. tipc_bclink_acknowledge(n_ptr, INVALID_LINK_SEQ);
  336. n_ptr->bclink.recv_permitted = false;
  337. }
  338. /* Abort any ongoing link failover */
  339. for (i = 0; i < MAX_BEARERS; i++) {
  340. struct tipc_link *l_ptr = n_ptr->links[i].link;
  341. if (!l_ptr)
  342. continue;
  343. l_ptr->flags &= ~LINK_FAILINGOVER;
  344. l_ptr->failover_checkpt = 0;
  345. l_ptr->failover_pkts = 0;
  346. kfree_skb(l_ptr->failover_skb);
  347. l_ptr->failover_skb = NULL;
  348. tipc_link_reset_fragments(l_ptr);
  349. }
  350. n_ptr->action_flags &= ~TIPC_WAIT_OWN_LINKS_DOWN;
  351. /* Prevent re-contact with node until cleanup is done */
  352. n_ptr->action_flags |= TIPC_WAIT_PEER_LINKS_DOWN;
  353. /* Notify publications from this node */
  354. n_ptr->action_flags |= TIPC_NOTIFY_NODE_DOWN;
  355. /* Notify sockets connected to node */
  356. list_for_each_entry_safe(conn, safe, conns, list) {
  357. skb = tipc_msg_create(TIPC_CRITICAL_IMPORTANCE, TIPC_CONN_MSG,
  358. SHORT_H_SIZE, 0, tn->own_addr,
  359. conn->peer_node, conn->port,
  360. conn->peer_port, TIPC_ERR_NO_NODE);
  361. if (likely(skb)) {
  362. skb_queue_tail(n_ptr->inputq, skb);
  363. n_ptr->action_flags |= TIPC_MSG_EVT;
  364. }
  365. list_del(&conn->list);
  366. kfree(conn);
  367. }
  368. }
  369. /**
  370. * tipc_node_get_linkname - get the name of a link
  371. *
  372. * @bearer_id: id of the bearer
  373. * @node: peer node address
  374. * @linkname: link name output buffer
  375. *
  376. * Returns 0 on success
  377. */
  378. int tipc_node_get_linkname(struct net *net, u32 bearer_id, u32 addr,
  379. char *linkname, size_t len)
  380. {
  381. struct tipc_link *link;
  382. int err = -EINVAL;
  383. struct tipc_node *node = tipc_node_find(net, addr);
  384. if (!node)
  385. return err;
  386. if (bearer_id >= MAX_BEARERS)
  387. goto exit;
  388. tipc_node_lock(node);
  389. link = node->links[bearer_id].link;
  390. if (link) {
  391. strncpy(linkname, link->name, len);
  392. err = 0;
  393. }
  394. exit:
  395. tipc_node_unlock(node);
  396. tipc_node_put(node);
  397. return err;
  398. }
  399. void tipc_node_unlock(struct tipc_node *node)
  400. {
  401. struct net *net = node->net;
  402. u32 addr = 0;
  403. u32 flags = node->action_flags;
  404. u32 link_id = 0;
  405. struct list_head *publ_list;
  406. struct sk_buff_head *inputq = node->inputq;
  407. struct sk_buff_head *namedq;
  408. if (likely(!flags || (flags == TIPC_MSG_EVT))) {
  409. node->action_flags = 0;
  410. spin_unlock_bh(&node->lock);
  411. if (flags == TIPC_MSG_EVT)
  412. tipc_sk_rcv(net, inputq);
  413. return;
  414. }
  415. addr = node->addr;
  416. link_id = node->link_id;
  417. namedq = node->namedq;
  418. publ_list = &node->publ_list;
  419. node->action_flags &= ~(TIPC_MSG_EVT |
  420. TIPC_NOTIFY_NODE_DOWN | TIPC_NOTIFY_NODE_UP |
  421. TIPC_NOTIFY_LINK_DOWN | TIPC_NOTIFY_LINK_UP |
  422. TIPC_WAKEUP_BCAST_USERS | TIPC_BCAST_MSG_EVT |
  423. TIPC_NAMED_MSG_EVT | TIPC_BCAST_RESET);
  424. spin_unlock_bh(&node->lock);
  425. if (flags & TIPC_NOTIFY_NODE_DOWN)
  426. tipc_publ_notify(net, publ_list, addr);
  427. if (flags & TIPC_WAKEUP_BCAST_USERS)
  428. tipc_bclink_wakeup_users(net);
  429. if (flags & TIPC_NOTIFY_NODE_UP)
  430. tipc_named_node_up(net, addr);
  431. if (flags & TIPC_NOTIFY_LINK_UP)
  432. tipc_nametbl_publish(net, TIPC_LINK_STATE, addr, addr,
  433. TIPC_NODE_SCOPE, link_id, addr);
  434. if (flags & TIPC_NOTIFY_LINK_DOWN)
  435. tipc_nametbl_withdraw(net, TIPC_LINK_STATE, addr,
  436. link_id, addr);
  437. if (flags & TIPC_MSG_EVT)
  438. tipc_sk_rcv(net, inputq);
  439. if (flags & TIPC_NAMED_MSG_EVT)
  440. tipc_named_rcv(net, namedq);
  441. if (flags & TIPC_BCAST_MSG_EVT)
  442. tipc_bclink_input(net);
  443. if (flags & TIPC_BCAST_RESET)
  444. tipc_link_reset_all(node);
  445. }
  446. /* Caller should hold node lock for the passed node */
  447. static int __tipc_nl_add_node(struct tipc_nl_msg *msg, struct tipc_node *node)
  448. {
  449. void *hdr;
  450. struct nlattr *attrs;
  451. hdr = genlmsg_put(msg->skb, msg->portid, msg->seq, &tipc_genl_family,
  452. NLM_F_MULTI, TIPC_NL_NODE_GET);
  453. if (!hdr)
  454. return -EMSGSIZE;
  455. attrs = nla_nest_start(msg->skb, TIPC_NLA_NODE);
  456. if (!attrs)
  457. goto msg_full;
  458. if (nla_put_u32(msg->skb, TIPC_NLA_NODE_ADDR, node->addr))
  459. goto attr_msg_full;
  460. if (tipc_node_is_up(node))
  461. if (nla_put_flag(msg->skb, TIPC_NLA_NODE_UP))
  462. goto attr_msg_full;
  463. nla_nest_end(msg->skb, attrs);
  464. genlmsg_end(msg->skb, hdr);
  465. return 0;
  466. attr_msg_full:
  467. nla_nest_cancel(msg->skb, attrs);
  468. msg_full:
  469. genlmsg_cancel(msg->skb, hdr);
  470. return -EMSGSIZE;
  471. }
  472. int tipc_nl_node_dump(struct sk_buff *skb, struct netlink_callback *cb)
  473. {
  474. int err;
  475. struct net *net = sock_net(skb->sk);
  476. struct tipc_net *tn = net_generic(net, tipc_net_id);
  477. int done = cb->args[0];
  478. int last_addr = cb->args[1];
  479. struct tipc_node *node;
  480. struct tipc_nl_msg msg;
  481. if (done)
  482. return 0;
  483. msg.skb = skb;
  484. msg.portid = NETLINK_CB(cb->skb).portid;
  485. msg.seq = cb->nlh->nlmsg_seq;
  486. rcu_read_lock();
  487. if (last_addr) {
  488. node = tipc_node_find(net, last_addr);
  489. if (!node) {
  490. rcu_read_unlock();
  491. /* We never set seq or call nl_dump_check_consistent()
  492. * this means that setting prev_seq here will cause the
  493. * consistence check to fail in the netlink callback
  494. * handler. Resulting in the NLMSG_DONE message having
  495. * the NLM_F_DUMP_INTR flag set if the node state
  496. * changed while we released the lock.
  497. */
  498. cb->prev_seq = 1;
  499. return -EPIPE;
  500. }
  501. tipc_node_put(node);
  502. }
  503. list_for_each_entry_rcu(node, &tn->node_list, list) {
  504. if (last_addr) {
  505. if (node->addr == last_addr)
  506. last_addr = 0;
  507. else
  508. continue;
  509. }
  510. tipc_node_lock(node);
  511. err = __tipc_nl_add_node(&msg, node);
  512. if (err) {
  513. last_addr = node->addr;
  514. tipc_node_unlock(node);
  515. goto out;
  516. }
  517. tipc_node_unlock(node);
  518. }
  519. done = 1;
  520. out:
  521. cb->args[0] = done;
  522. cb->args[1] = last_addr;
  523. rcu_read_unlock();
  524. return skb->len;
  525. }