2 * include/net/tipc/tipc.h: Main include file for TIPC users
4 * Copyright (c) 2003-2006, Ericsson AB
5 * Copyright (c) 2005, 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.
42 #include <linux/tipc.h>
43 #include <linux/skbuff.h>
51 * TIPC operating mode routines
54 u32 tipc_get_addr(void);
56 #define TIPC_NOT_RUNNING 0
57 #define TIPC_NODE_MODE 1
58 #define TIPC_NET_MODE 2
60 typedef void (*tipc_mode_event)(void *usr_handle, int mode, u32 addr);
62 int tipc_attach(unsigned int *userref, tipc_mode_event, void *usr_handle);
64 void tipc_detach(unsigned int userref);
66 int tipc_get_mode(void);
69 * TIPC port manipulation routines
72 typedef void (*tipc_msg_err_event) (void *usr_handle,
75 unsigned char const *data,
78 struct tipc_portid const *attmpt_destid);
80 typedef void (*tipc_named_msg_err_event) (void *usr_handle,
83 unsigned char const *data,
86 struct tipc_name_seq const *attmpt_dest);
88 typedef void (*tipc_conn_shutdown_event) (void *usr_handle,
91 unsigned char const *data,
95 typedef void (*tipc_msg_event) (void *usr_handle,
98 unsigned char const *data,
100 unsigned int importance,
101 struct tipc_portid const *origin);
103 typedef void (*tipc_named_msg_event) (void *usr_handle,
105 struct sk_buff **buf,
106 unsigned char const *data,
108 unsigned int importance,
109 struct tipc_portid const *orig,
110 struct tipc_name_seq const *dest);
112 typedef void (*tipc_conn_msg_event) (void *usr_handle,
114 struct sk_buff **buf,
115 unsigned char const *data,
118 typedef void (*tipc_continue_event) (void *usr_handle,
121 int tipc_createport(unsigned int tipc_user,
123 unsigned int importance,
124 tipc_msg_err_event error_cb,
125 tipc_named_msg_err_event named_error_cb,
126 tipc_conn_shutdown_event conn_error_cb,
127 tipc_msg_event message_cb,
128 tipc_named_msg_event named_message_cb,
129 tipc_conn_msg_event conn_message_cb,
130 tipc_continue_event continue_event_cb,/* May be zero */
133 int tipc_deleteport(u32 portref);
135 int tipc_ownidentity(u32 portref, struct tipc_portid *port);
137 int tipc_portimportance(u32 portref, unsigned int *importance);
138 int tipc_set_portimportance(u32 portref, unsigned int importance);
140 int tipc_portunreliable(u32 portref, unsigned int *isunreliable);
141 int tipc_set_portunreliable(u32 portref, unsigned int isunreliable);
143 int tipc_portunreturnable(u32 portref, unsigned int *isunreturnable);
144 int tipc_set_portunreturnable(u32 portref, unsigned int isunreturnable);
146 int tipc_publish(u32 portref, unsigned int scope,
147 struct tipc_name_seq const *name_seq);
148 int tipc_withdraw(u32 portref, unsigned int scope,
149 struct tipc_name_seq const *name_seq); /* 0: all */
151 int tipc_connect2port(u32 portref, struct tipc_portid const *port);
153 int tipc_disconnect(u32 portref);
155 int tipc_shutdown(u32 ref); /* Sends SHUTDOWN msg */
157 int tipc_isconnected(u32 portref, int *isconnected);
159 int tipc_peer(u32 portref, struct tipc_portid *peer);
161 int tipc_ref_valid(u32 portref);
164 * TIPC messaging routines
167 #define TIPC_PORT_IMPORTANCE 100 /* send using current port setting */
170 int tipc_send(u32 portref,
171 unsigned int num_sect,
172 struct iovec const *msg_sect);
174 int tipc_send_buf(u32 portref,
178 int tipc_send2name(u32 portref,
179 struct tipc_name const *name,
180 u32 domain, /* 0:own zone */
181 unsigned int num_sect,
182 struct iovec const *msg_sect);
184 int tipc_send_buf2name(u32 portref,
185 struct tipc_name const *name,
190 int tipc_forward2name(u32 portref,
191 struct tipc_name const *name,
192 u32 domain, /*0: own zone */
193 unsigned int section_count,
194 struct iovec const *msg_sect,
195 struct tipc_portid const *origin,
196 unsigned int importance);
198 int tipc_forward_buf2name(u32 portref,
199 struct tipc_name const *name,
203 struct tipc_portid const *orig,
204 unsigned int importance);
206 int tipc_send2port(u32 portref,
207 struct tipc_portid const *dest,
208 unsigned int num_sect,
209 struct iovec const *msg_sect);
211 int tipc_send_buf2port(u32 portref,
212 struct tipc_portid const *dest,
216 int tipc_forward2port(u32 portref,
217 struct tipc_portid const *dest,
218 unsigned int num_sect,
219 struct iovec const *msg_sect,
220 struct tipc_portid const *origin,
221 unsigned int importance);
223 int tipc_forward_buf2port(u32 portref,
224 struct tipc_portid const *dest,
227 struct tipc_portid const *orig,
228 unsigned int importance);
230 int tipc_multicast(u32 portref,
231 struct tipc_name_seq const *seq,
232 u32 domain, /* 0:own zone */
233 unsigned int section_count,
234 struct iovec const *msg);
237 int tipc_multicast_buf(u32 portref,
238 struct tipc_name_seq const *seq,
239 u32 domain, /* 0:own zone */
245 * TIPC subscription routines
248 int tipc_ispublished(struct tipc_name const *name);
251 * Get number of available nodes within specified domain (excluding own node)
254 unsigned int tipc_available_nodes(const u32 domain);