2 * net/tipc/node.h: Include file for TIPC node management routines
4 * Copyright (c) 2000-2006, 2014, Ericsson AB
5 * Copyright (c) 2005, 2010-2014, Wind River Systems
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions are met:
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.
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.
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.
46 * Out-of-range value for node signature
48 #define INVALID_NODE_SIG 0x10000
50 /* Flags used to take different actions according to flag type
51 * TIPC_WAIT_PEER_LINKS_DOWN: wait to see that peer's links are down
52 * TIPC_WAIT_OWN_LINKS_DOWN: wait until peer node is declared down
53 * TIPC_NOTIFY_NODE_DOWN: notify node is down
54 * TIPC_NOTIFY_NODE_UP: notify node is up
55 * TIPC_DISTRIBUTE_NAME: publish or withdraw link state name type
58 TIPC_WAIT_PEER_LINKS_DOWN
= (1 << 1),
59 TIPC_WAIT_OWN_LINKS_DOWN
= (1 << 2),
60 TIPC_NOTIFY_NODE_DOWN
= (1 << 3),
61 TIPC_NOTIFY_NODE_UP
= (1 << 4),
62 TIPC_WAKEUP_USERS
= (1 << 5),
63 TIPC_WAKEUP_BCAST_USERS
= (1 << 6),
64 TIPC_NOTIFY_LINK_UP
= (1 << 7),
65 TIPC_NOTIFY_LINK_DOWN
= (1 << 8)
69 * struct tipc_node_bclink - TIPC node bclink structure
70 * @acked: sequence # of last outbound b'cast message acknowledged by node
71 * @last_in: sequence # of last in-sequence b'cast message received from node
72 * @last_sent: sequence # of last b'cast message sent by node
73 * @oos_state: state tracker for handling OOS b'cast messages
74 * @deferred_size: number of OOS b'cast messages in deferred queue
75 * @deferred_head: oldest OOS b'cast message received from node
76 * @deferred_tail: newest OOS b'cast message received from node
77 * @reasm_buf: broadcast reassembly queue head from node
78 * @recv_permitted: true if node is allowed to receive b'cast messages
80 struct tipc_node_bclink
{
86 struct sk_buff
*deferred_head
;
87 struct sk_buff
*deferred_tail
;
88 struct sk_buff
*reasm_buf
;
93 * struct tipc_node - TIPC node structure
94 * @addr: network address of node
95 * @lock: spinlock governing access to structure
96 * @hash: links to adjacent nodes in unsorted hash chain
97 * @active_links: pointers to active links to node
98 * @links: pointers to all links to node
99 * @action_flags: bit mask of different types of node actions
100 * @bclink: broadcast-related info
101 * @list: links to adjacent nodes in sorted list of cluster's nodes
102 * @working_links: number of working links to node (both active and standby)
103 * @link_cnt: number of links to node
104 * @signature: node instance identifier
105 * @link_id: local and remote bearer ids of changing link, if any
106 * @publ_list: list of publications
107 * @rcu: rcu struct for tipc_node
112 struct hlist_node hash
;
113 struct tipc_link
*active_links
[2];
115 struct tipc_link
*links
[MAX_BEARERS
];
116 unsigned int action_flags
;
117 struct tipc_node_bclink bclink
;
118 struct list_head list
;
123 struct list_head publ_list
;
124 struct sk_buff_head waiting_sks
;
125 struct list_head conn_sks
;
129 extern struct list_head tipc_node_list
;
131 struct tipc_node
*tipc_node_find(u32 addr
);
132 struct tipc_node
*tipc_node_create(u32 addr
);
133 void tipc_node_stop(void);
134 void tipc_node_attach_link(struct tipc_node
*n_ptr
, struct tipc_link
*l_ptr
);
135 void tipc_node_detach_link(struct tipc_node
*n_ptr
, struct tipc_link
*l_ptr
);
136 void tipc_node_link_down(struct tipc_node
*n_ptr
, struct tipc_link
*l_ptr
);
137 void tipc_node_link_up(struct tipc_node
*n_ptr
, struct tipc_link
*l_ptr
);
138 int tipc_node_active_links(struct tipc_node
*n_ptr
);
139 int tipc_node_is_up(struct tipc_node
*n_ptr
);
140 struct sk_buff
*tipc_node_get_links(const void *req_tlv_area
, int req_tlv_space
);
141 struct sk_buff
*tipc_node_get_nodes(const void *req_tlv_area
, int req_tlv_space
);
142 int tipc_node_get_linkname(u32 bearer_id
, u32 node
, char *linkname
, size_t len
);
143 void tipc_node_unlock(struct tipc_node
*node
);
144 int tipc_node_add_conn(u32 dnode
, u32 port
, u32 peer_port
);
145 void tipc_node_remove_conn(u32 dnode
, u32 port
);
147 int tipc_nl_node_dump(struct sk_buff
*skb
, struct netlink_callback
*cb
);
149 static inline void tipc_node_lock(struct tipc_node
*node
)
151 spin_lock_bh(&node
->lock
);
154 static inline bool tipc_node_blocked(struct tipc_node
*node
)
156 return (node
->action_flags
& (TIPC_WAIT_PEER_LINKS_DOWN
|
157 TIPC_NOTIFY_NODE_DOWN
| TIPC_WAIT_OWN_LINKS_DOWN
));
160 static inline uint
tipc_node_get_mtu(u32 addr
, u32 selector
)
162 struct tipc_node
*node
;
165 node
= tipc_node_find(addr
);
168 mtu
= node
->act_mtus
[selector
& 1];