2 * include/net/tipc/tipc.h: Main include file for TIPC users
4 * Copyright (c) 2003-2006, Ericsson AB
5 * Copyright (c) 2005,2010 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>
50 * TIPC operating mode routines
53 #define TIPC_NOT_RUNNING 0
54 #define TIPC_NODE_MODE 1
55 #define TIPC_NET_MODE 2
57 typedef void (*tipc_mode_event)(void *usr_handle, int mode, u32 addr);
59 int tipc_attach(unsigned int *userref, tipc_mode_event, void *usr_handle);
61 void tipc_detach(unsigned int userref);
64 * TIPC port manipulation routines
67 typedef void (*tipc_msg_err_event) (void *usr_handle,
70 unsigned char const *data,
73 struct tipc_portid const *attmpt_destid);
75 typedef void (*tipc_named_msg_err_event) (void *usr_handle,
78 unsigned char const *data,
81 struct tipc_name_seq const *attmpt_dest);
83 typedef void (*tipc_conn_shutdown_event) (void *usr_handle,
86 unsigned char const *data,
90 typedef void (*tipc_msg_event) (void *usr_handle,
93 unsigned char const *data,
95 unsigned int importance,
96 struct tipc_portid const *origin);
98 typedef void (*tipc_named_msg_event) (void *usr_handle,
100 struct sk_buff **buf,
101 unsigned char const *data,
103 unsigned int importance,
104 struct tipc_portid const *orig,
105 struct tipc_name_seq const *dest);
107 typedef void (*tipc_conn_msg_event) (void *usr_handle,
109 struct sk_buff **buf,
110 unsigned char const *data,
113 typedef void (*tipc_continue_event) (void *usr_handle,
116 int tipc_createport(unsigned int tipc_user,
118 unsigned int importance,
119 tipc_msg_err_event error_cb,
120 tipc_named_msg_err_event named_error_cb,
121 tipc_conn_shutdown_event conn_error_cb,
122 tipc_msg_event message_cb,
123 tipc_named_msg_event named_message_cb,
124 tipc_conn_msg_event conn_message_cb,
125 tipc_continue_event continue_event_cb,
128 int tipc_deleteport(u32 portref);
130 int tipc_ownidentity(u32 portref, struct tipc_portid *port);
132 int tipc_portimportance(u32 portref, unsigned int *importance);
133 int tipc_set_portimportance(u32 portref, unsigned int importance);
135 int tipc_portunreliable(u32 portref, unsigned int *isunreliable);
136 int tipc_set_portunreliable(u32 portref, unsigned int isunreliable);
138 int tipc_portunreturnable(u32 portref, unsigned int *isunreturnable);
139 int tipc_set_portunreturnable(u32 portref, unsigned int isunreturnable);
141 int tipc_publish(u32 portref, unsigned int scope,
142 struct tipc_name_seq const *name_seq);
143 int tipc_withdraw(u32 portref, unsigned int scope,
144 struct tipc_name_seq const *name_seq);
146 int tipc_connect2port(u32 portref, struct tipc_portid const *port);
148 int tipc_disconnect(u32 portref);
150 int tipc_shutdown(u32 ref);
153 * TIPC messaging routines
156 #define TIPC_PORT_IMPORTANCE 100 /* send using current port setting */
159 int tipc_send(u32 portref,
160 unsigned int num_sect,
161 struct iovec const *msg_sect);
163 int tipc_send2name(u32 portref,
164 struct tipc_name const *name,
166 unsigned int num_sect,
167 struct iovec const *msg_sect);
169 int tipc_send2port(u32 portref,
170 struct tipc_portid const *dest,
171 unsigned int num_sect,
172 struct iovec const *msg_sect);
174 int tipc_send_buf2port(u32 portref,
175 struct tipc_portid const *dest,
179 int tipc_multicast(u32 portref,
180 struct tipc_name_seq const *seq,
181 u32 domain, /* currently unused */
182 unsigned int section_count,
183 struct iovec const *msg);