1*53ee8cc1Swenshuai.xi /*
2*53ee8cc1Swenshuai.xi * include/linux/tipc.h: Include file for TIPC socket interface
3*53ee8cc1Swenshuai.xi *
4*53ee8cc1Swenshuai.xi * Copyright (c) 2003-2006, Ericsson AB
5*53ee8cc1Swenshuai.xi * Copyright (c) 2005, Wind River Systems
6*53ee8cc1Swenshuai.xi * All rights reserved.
7*53ee8cc1Swenshuai.xi *
8*53ee8cc1Swenshuai.xi * Redistribution and use in source and binary forms, with or without
9*53ee8cc1Swenshuai.xi * modification, are permitted provided that the following conditions are met:
10*53ee8cc1Swenshuai.xi *
11*53ee8cc1Swenshuai.xi * 1. Redistributions of source code must retain the above copyright
12*53ee8cc1Swenshuai.xi * notice, this list of conditions and the following disclaimer.
13*53ee8cc1Swenshuai.xi * 2. Redistributions in binary form must reproduce the above copyright
14*53ee8cc1Swenshuai.xi * notice, this list of conditions and the following disclaimer in the
15*53ee8cc1Swenshuai.xi * documentation and/or other materials provided with the distribution.
16*53ee8cc1Swenshuai.xi * 3. Neither the names of the copyright holders nor the names of its
17*53ee8cc1Swenshuai.xi * contributors may be used to endorse or promote products derived from
18*53ee8cc1Swenshuai.xi * this software without specific prior written permission.
19*53ee8cc1Swenshuai.xi *
20*53ee8cc1Swenshuai.xi * Alternatively, this software may be distributed under the terms of the
21*53ee8cc1Swenshuai.xi * GNU General Public License ("GPL") version 2 as published by the Free
22*53ee8cc1Swenshuai.xi * Software Foundation.
23*53ee8cc1Swenshuai.xi *
24*53ee8cc1Swenshuai.xi * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
25*53ee8cc1Swenshuai.xi * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26*53ee8cc1Swenshuai.xi * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27*53ee8cc1Swenshuai.xi * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
28*53ee8cc1Swenshuai.xi * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
29*53ee8cc1Swenshuai.xi * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30*53ee8cc1Swenshuai.xi * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31*53ee8cc1Swenshuai.xi * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
32*53ee8cc1Swenshuai.xi * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33*53ee8cc1Swenshuai.xi * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
34*53ee8cc1Swenshuai.xi * POSSIBILITY OF SUCH DAMAGE.
35*53ee8cc1Swenshuai.xi */
36*53ee8cc1Swenshuai.xi
37*53ee8cc1Swenshuai.xi #ifndef _LINUX_TIPC_H_
38*53ee8cc1Swenshuai.xi #define _LINUX_TIPC_H_
39*53ee8cc1Swenshuai.xi
40*53ee8cc1Swenshuai.xi #include <linux/types.h>
41*53ee8cc1Swenshuai.xi
42*53ee8cc1Swenshuai.xi /*
43*53ee8cc1Swenshuai.xi * TIPC addressing primitives
44*53ee8cc1Swenshuai.xi */
45*53ee8cc1Swenshuai.xi
46*53ee8cc1Swenshuai.xi struct tipc_portid {
47*53ee8cc1Swenshuai.xi __u32 ref;
48*53ee8cc1Swenshuai.xi __u32 node;
49*53ee8cc1Swenshuai.xi };
50*53ee8cc1Swenshuai.xi
51*53ee8cc1Swenshuai.xi struct tipc_name {
52*53ee8cc1Swenshuai.xi __u32 type;
53*53ee8cc1Swenshuai.xi __u32 instance;
54*53ee8cc1Swenshuai.xi };
55*53ee8cc1Swenshuai.xi
56*53ee8cc1Swenshuai.xi struct tipc_name_seq {
57*53ee8cc1Swenshuai.xi __u32 type;
58*53ee8cc1Swenshuai.xi __u32 lower;
59*53ee8cc1Swenshuai.xi __u32 upper;
60*53ee8cc1Swenshuai.xi };
61*53ee8cc1Swenshuai.xi
tipc_addr(unsigned int zone,unsigned int cluster,unsigned int node)62*53ee8cc1Swenshuai.xi static __inline__ __u32 tipc_addr(unsigned int zone,
63*53ee8cc1Swenshuai.xi unsigned int cluster,
64*53ee8cc1Swenshuai.xi unsigned int node)
65*53ee8cc1Swenshuai.xi {
66*53ee8cc1Swenshuai.xi return (zone << 24) | (cluster << 12) | node;
67*53ee8cc1Swenshuai.xi }
68*53ee8cc1Swenshuai.xi
tipc_zone(__u32 addr)69*53ee8cc1Swenshuai.xi static __inline__ unsigned int tipc_zone(__u32 addr)
70*53ee8cc1Swenshuai.xi {
71*53ee8cc1Swenshuai.xi return addr >> 24;
72*53ee8cc1Swenshuai.xi }
73*53ee8cc1Swenshuai.xi
tipc_cluster(__u32 addr)74*53ee8cc1Swenshuai.xi static __inline__ unsigned int tipc_cluster(__u32 addr)
75*53ee8cc1Swenshuai.xi {
76*53ee8cc1Swenshuai.xi return (addr >> 12) & 0xfff;
77*53ee8cc1Swenshuai.xi }
78*53ee8cc1Swenshuai.xi
tipc_node(__u32 addr)79*53ee8cc1Swenshuai.xi static __inline__ unsigned int tipc_node(__u32 addr)
80*53ee8cc1Swenshuai.xi {
81*53ee8cc1Swenshuai.xi return addr & 0xfff;
82*53ee8cc1Swenshuai.xi }
83*53ee8cc1Swenshuai.xi
84*53ee8cc1Swenshuai.xi /*
85*53ee8cc1Swenshuai.xi * Application-accessible port name types
86*53ee8cc1Swenshuai.xi */
87*53ee8cc1Swenshuai.xi
88*53ee8cc1Swenshuai.xi #define TIPC_CFG_SRV 0 /* configuration service name type */
89*53ee8cc1Swenshuai.xi #define TIPC_TOP_SRV 1 /* topology service name type */
90*53ee8cc1Swenshuai.xi #define TIPC_RESERVED_TYPES 64 /* lowest user-publishable name type */
91*53ee8cc1Swenshuai.xi
92*53ee8cc1Swenshuai.xi /*
93*53ee8cc1Swenshuai.xi * Publication scopes when binding port names and port name sequences
94*53ee8cc1Swenshuai.xi */
95*53ee8cc1Swenshuai.xi
96*53ee8cc1Swenshuai.xi #define TIPC_ZONE_SCOPE 1
97*53ee8cc1Swenshuai.xi #define TIPC_CLUSTER_SCOPE 2
98*53ee8cc1Swenshuai.xi #define TIPC_NODE_SCOPE 3
99*53ee8cc1Swenshuai.xi
100*53ee8cc1Swenshuai.xi /*
101*53ee8cc1Swenshuai.xi * Limiting values for messages
102*53ee8cc1Swenshuai.xi */
103*53ee8cc1Swenshuai.xi
104*53ee8cc1Swenshuai.xi #define TIPC_MAX_USER_MSG_SIZE 66000
105*53ee8cc1Swenshuai.xi
106*53ee8cc1Swenshuai.xi /*
107*53ee8cc1Swenshuai.xi * Message importance levels
108*53ee8cc1Swenshuai.xi */
109*53ee8cc1Swenshuai.xi
110*53ee8cc1Swenshuai.xi #define TIPC_LOW_IMPORTANCE 0 /* default */
111*53ee8cc1Swenshuai.xi #define TIPC_MEDIUM_IMPORTANCE 1
112*53ee8cc1Swenshuai.xi #define TIPC_HIGH_IMPORTANCE 2
113*53ee8cc1Swenshuai.xi #define TIPC_CRITICAL_IMPORTANCE 3
114*53ee8cc1Swenshuai.xi
115*53ee8cc1Swenshuai.xi /*
116*53ee8cc1Swenshuai.xi * Msg rejection/connection shutdown reasons
117*53ee8cc1Swenshuai.xi */
118*53ee8cc1Swenshuai.xi
119*53ee8cc1Swenshuai.xi #define TIPC_OK 0
120*53ee8cc1Swenshuai.xi #define TIPC_ERR_NO_NAME 1
121*53ee8cc1Swenshuai.xi #define TIPC_ERR_NO_PORT 2
122*53ee8cc1Swenshuai.xi #define TIPC_ERR_NO_NODE 3
123*53ee8cc1Swenshuai.xi #define TIPC_ERR_OVERLOAD 4
124*53ee8cc1Swenshuai.xi #define TIPC_CONN_SHUTDOWN 5
125*53ee8cc1Swenshuai.xi
126*53ee8cc1Swenshuai.xi /*
127*53ee8cc1Swenshuai.xi * TIPC topology subscription service definitions
128*53ee8cc1Swenshuai.xi */
129*53ee8cc1Swenshuai.xi
130*53ee8cc1Swenshuai.xi #define TIPC_SUB_PORTS 0x01 /* filter for port availability */
131*53ee8cc1Swenshuai.xi #define TIPC_SUB_SERVICE 0x02 /* filter for service availability */
132*53ee8cc1Swenshuai.xi #define TIPC_SUB_CANCEL 0x04 /* cancel a subscription */
133*53ee8cc1Swenshuai.xi #if 0
134*53ee8cc1Swenshuai.xi /* The following filter options are not currently implemented */
135*53ee8cc1Swenshuai.xi #define TIPC_SUB_NO_BIND_EVTS 0x04 /* filter out "publish" events */
136*53ee8cc1Swenshuai.xi #define TIPC_SUB_NO_UNBIND_EVTS 0x08 /* filter out "withdraw" events */
137*53ee8cc1Swenshuai.xi #define TIPC_SUB_SINGLE_EVT 0x10 /* expire after first event */
138*53ee8cc1Swenshuai.xi #endif
139*53ee8cc1Swenshuai.xi
140*53ee8cc1Swenshuai.xi #define TIPC_WAIT_FOREVER ~0 /* timeout for permanent subscription */
141*53ee8cc1Swenshuai.xi
142*53ee8cc1Swenshuai.xi struct tipc_subscr {
143*53ee8cc1Swenshuai.xi struct tipc_name_seq seq; /* name sequence of interest */
144*53ee8cc1Swenshuai.xi __u32 timeout; /* subscription duration (in ms) */
145*53ee8cc1Swenshuai.xi __u32 filter; /* bitmask of filter options */
146*53ee8cc1Swenshuai.xi char usr_handle[8]; /* available for subscriber use */
147*53ee8cc1Swenshuai.xi };
148*53ee8cc1Swenshuai.xi
149*53ee8cc1Swenshuai.xi #define TIPC_PUBLISHED 1 /* publication event */
150*53ee8cc1Swenshuai.xi #define TIPC_WITHDRAWN 2 /* withdraw event */
151*53ee8cc1Swenshuai.xi #define TIPC_SUBSCR_TIMEOUT 3 /* subscription timeout event */
152*53ee8cc1Swenshuai.xi
153*53ee8cc1Swenshuai.xi struct tipc_event {
154*53ee8cc1Swenshuai.xi __u32 event; /* event type */
155*53ee8cc1Swenshuai.xi __u32 found_lower; /* matching name seq instances */
156*53ee8cc1Swenshuai.xi __u32 found_upper; /* " " " " */
157*53ee8cc1Swenshuai.xi struct tipc_portid port; /* associated port */
158*53ee8cc1Swenshuai.xi struct tipc_subscr s; /* associated subscription */
159*53ee8cc1Swenshuai.xi };
160*53ee8cc1Swenshuai.xi
161*53ee8cc1Swenshuai.xi /*
162*53ee8cc1Swenshuai.xi * Socket API
163*53ee8cc1Swenshuai.xi */
164*53ee8cc1Swenshuai.xi
165*53ee8cc1Swenshuai.xi #ifndef AF_TIPC
166*53ee8cc1Swenshuai.xi #define AF_TIPC 30
167*53ee8cc1Swenshuai.xi #endif
168*53ee8cc1Swenshuai.xi
169*53ee8cc1Swenshuai.xi #ifndef PF_TIPC
170*53ee8cc1Swenshuai.xi #define PF_TIPC AF_TIPC
171*53ee8cc1Swenshuai.xi #endif
172*53ee8cc1Swenshuai.xi
173*53ee8cc1Swenshuai.xi #ifndef SOL_TIPC
174*53ee8cc1Swenshuai.xi #define SOL_TIPC 271
175*53ee8cc1Swenshuai.xi #endif
176*53ee8cc1Swenshuai.xi
177*53ee8cc1Swenshuai.xi #define TIPC_ADDR_NAMESEQ 1
178*53ee8cc1Swenshuai.xi #define TIPC_ADDR_MCAST 1
179*53ee8cc1Swenshuai.xi #define TIPC_ADDR_NAME 2
180*53ee8cc1Swenshuai.xi #define TIPC_ADDR_ID 3
181*53ee8cc1Swenshuai.xi
182*53ee8cc1Swenshuai.xi struct sockaddr_tipc {
183*53ee8cc1Swenshuai.xi unsigned short family;
184*53ee8cc1Swenshuai.xi unsigned char addrtype;
185*53ee8cc1Swenshuai.xi signed char scope;
186*53ee8cc1Swenshuai.xi union {
187*53ee8cc1Swenshuai.xi struct tipc_portid id;
188*53ee8cc1Swenshuai.xi struct tipc_name_seq nameseq;
189*53ee8cc1Swenshuai.xi struct {
190*53ee8cc1Swenshuai.xi struct tipc_name name;
191*53ee8cc1Swenshuai.xi __u32 domain; /* 0: own zone */
192*53ee8cc1Swenshuai.xi } name;
193*53ee8cc1Swenshuai.xi } addr;
194*53ee8cc1Swenshuai.xi };
195*53ee8cc1Swenshuai.xi
196*53ee8cc1Swenshuai.xi /*
197*53ee8cc1Swenshuai.xi * Ancillary data objects supported by recvmsg()
198*53ee8cc1Swenshuai.xi */
199*53ee8cc1Swenshuai.xi
200*53ee8cc1Swenshuai.xi #define TIPC_ERRINFO 1 /* error info */
201*53ee8cc1Swenshuai.xi #define TIPC_RETDATA 2 /* returned data */
202*53ee8cc1Swenshuai.xi #define TIPC_DESTNAME 3 /* destination name */
203*53ee8cc1Swenshuai.xi
204*53ee8cc1Swenshuai.xi /*
205*53ee8cc1Swenshuai.xi * TIPC-specific socket option values
206*53ee8cc1Swenshuai.xi */
207*53ee8cc1Swenshuai.xi
208*53ee8cc1Swenshuai.xi #define TIPC_IMPORTANCE 127 /* Default: TIPC_LOW_IMPORTANCE */
209*53ee8cc1Swenshuai.xi #define TIPC_SRC_DROPPABLE 128 /* Default: 0 (resend congested msg) */
210*53ee8cc1Swenshuai.xi #define TIPC_DEST_DROPPABLE 129 /* Default: based on socket type */
211*53ee8cc1Swenshuai.xi #define TIPC_CONN_TIMEOUT 130 /* Default: 8000 (ms) */
212*53ee8cc1Swenshuai.xi
213*53ee8cc1Swenshuai.xi #endif
214