blob: a5b994a204d26f9aff34f3e8058b068eeec3a78f [file] [log] [blame]
Per Lidenb97bf3f2006-01-02 19:04:38 +01001/*
Per Lidenea714cc2006-01-11 12:28:47 +01002 * include/linux/tipc.h: Include file for TIPC socket interface
Allan Stephens0e659672010-12-31 18:59:32 +00003 *
Per Liden9da1c8b2006-01-11 18:40:41 +01004 * Copyright (c) 2003-2006, Ericsson AB
Allan Stephens77c81e02011-01-18 13:37:09 -05005 * Copyright (c) 2005, 2010-2011, Wind River Systems
Per Lidenb97bf3f2006-01-02 19:04:38 +01006 * All rights reserved.
7 *
Per Liden9ea1fd32006-01-11 13:30:43 +01008 * Redistribution and use in source and binary forms, with or without
Per Lidenb97bf3f2006-01-02 19:04:38 +01009 * modification, are permitted provided that the following conditions are met:
10 *
Per Liden9ea1fd32006-01-11 13:30:43 +010011 * 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.
Per Lidenb97bf3f2006-01-02 19:04:38 +010019 *
Per Liden9ea1fd32006-01-11 13:30:43 +010020 * 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
Per Lidenb97bf3f2006-01-02 19:04:38 +010034 * POSSIBILITY OF SUCH DAMAGE.
35 */
36
37#ifndef _LINUX_TIPC_H_
38#define _LINUX_TIPC_H_
39
40#include <linux/types.h>
Per Lidenb97bf3f2006-01-02 19:04:38 +010041
42/*
43 * TIPC addressing primitives
44 */
Allan Stephens0e659672010-12-31 18:59:32 +000045
Per Lidenb97bf3f2006-01-02 19:04:38 +010046struct tipc_portid {
47 __u32 ref;
48 __u32 node;
49};
50
51struct tipc_name {
52 __u32 type;
53 __u32 instance;
54};
55
56struct tipc_name_seq {
57 __u32 type;
58 __u32 lower;
59 __u32 upper;
60};
61
62static inline __u32 tipc_addr(unsigned int zone,
63 unsigned int cluster,
64 unsigned int node)
65{
Per Lidenea714cc2006-01-11 12:28:47 +010066 return (zone << 24) | (cluster << 12) | node;
Per Lidenb97bf3f2006-01-02 19:04:38 +010067}
68
69static inline unsigned int tipc_zone(__u32 addr)
70{
Per Lidenea714cc2006-01-11 12:28:47 +010071 return addr >> 24;
Per Lidenb97bf3f2006-01-02 19:04:38 +010072}
73
74static inline unsigned int tipc_cluster(__u32 addr)
75{
Per Lidenea714cc2006-01-11 12:28:47 +010076 return (addr >> 12) & 0xfff;
Per Lidenb97bf3f2006-01-02 19:04:38 +010077}
78
79static inline unsigned int tipc_node(__u32 addr)
80{
Per Lidenea714cc2006-01-11 12:28:47 +010081 return addr & 0xfff;
Per Lidenb97bf3f2006-01-02 19:04:38 +010082}
83
84/*
85 * Application-accessible port name types
86 */
87
Per Lidenea714cc2006-01-11 12:28:47 +010088#define TIPC_CFG_SRV 0 /* configuration service name type */
89#define TIPC_TOP_SRV 1 /* topology service name type */
Per Lidenb97bf3f2006-01-02 19:04:38 +010090#define TIPC_RESERVED_TYPES 64 /* lowest user-publishable name type */
91
Allan Stephens0e659672010-12-31 18:59:32 +000092/*
Per Lidenb97bf3f2006-01-02 19:04:38 +010093 * Publication scopes when binding port names and port name sequences
94 */
95
Per Lidenea714cc2006-01-11 12:28:47 +010096#define TIPC_ZONE_SCOPE 1
97#define TIPC_CLUSTER_SCOPE 2
98#define TIPC_NODE_SCOPE 3
Per Lidenb97bf3f2006-01-02 19:04:38 +010099
100/*
101 * Limiting values for messages
102 */
103
Per Lidenea714cc2006-01-11 12:28:47 +0100104#define TIPC_MAX_USER_MSG_SIZE 66000
Per Lidenb97bf3f2006-01-02 19:04:38 +0100105
Per Lidenea714cc2006-01-11 12:28:47 +0100106/*
Per Lidenb97bf3f2006-01-02 19:04:38 +0100107 * Message importance levels
108 */
109
Allan Stephens8e1c2982010-05-11 14:30:09 +0000110#define TIPC_LOW_IMPORTANCE 0
Per Lidenb97bf3f2006-01-02 19:04:38 +0100111#define TIPC_MEDIUM_IMPORTANCE 1
112#define TIPC_HIGH_IMPORTANCE 2
113#define TIPC_CRITICAL_IMPORTANCE 3
114
Allan Stephens0e659672010-12-31 18:59:32 +0000115/*
Per Lidenb97bf3f2006-01-02 19:04:38 +0100116 * Msg rejection/connection shutdown reasons
117 */
118
119#define TIPC_OK 0
120#define TIPC_ERR_NO_NAME 1
121#define TIPC_ERR_NO_PORT 2
122#define TIPC_ERR_NO_NODE 3
123#define TIPC_ERR_OVERLOAD 4
124#define TIPC_CONN_SHUTDOWN 5
125
126/*
127 * TIPC topology subscription service definitions
128 */
129
Allan Stephens0e659672010-12-31 18:59:32 +0000130#define TIPC_SUB_PORTS 0x01 /* filter for port availability */
131#define TIPC_SUB_SERVICE 0x02 /* filter for service availability */
132#define TIPC_SUB_CANCEL 0x04 /* cancel a subscription */
Per Lidenb97bf3f2006-01-02 19:04:38 +0100133
Allan Stephens0e659672010-12-31 18:59:32 +0000134#define TIPC_WAIT_FOREVER (~0) /* timeout for permanent subscription */
Per Lidenb97bf3f2006-01-02 19:04:38 +0100135
136struct tipc_subscr {
Neil Horman8c974432010-10-21 01:06:15 +0000137 struct tipc_name_seq seq; /* name sequence of interest */
138 __u32 timeout; /* subscription duration (in ms) */
Allan Stephens0e659672010-12-31 18:59:32 +0000139 __u32 filter; /* bitmask of filter options */
Neil Horman8c974432010-10-21 01:06:15 +0000140 char usr_handle[8]; /* available for subscriber use */
Per Lidenb97bf3f2006-01-02 19:04:38 +0100141};
142
Per Lidenea714cc2006-01-11 12:28:47 +0100143#define TIPC_PUBLISHED 1 /* publication event */
144#define TIPC_WITHDRAWN 2 /* withdraw event */
145#define TIPC_SUBSCR_TIMEOUT 3 /* subscription timeout event */
Per Lidenb97bf3f2006-01-02 19:04:38 +0100146
147struct tipc_event {
Neil Horman8c974432010-10-21 01:06:15 +0000148 __u32 event; /* event type */
149 __u32 found_lower; /* matching name seq instances */
150 __u32 found_upper; /* " " " " */
151 struct tipc_portid port; /* associated port */
152 struct tipc_subscr s; /* associated subscription */
Per Lidenb97bf3f2006-01-02 19:04:38 +0100153};
154
155/*
156 * Socket API
157 */
158
159#ifndef AF_TIPC
160#define AF_TIPC 30
161#endif
162
163#ifndef PF_TIPC
164#define PF_TIPC AF_TIPC
165#endif
166
167#ifndef SOL_TIPC
168#define SOL_TIPC 271
169#endif
170
Per Lidenea714cc2006-01-11 12:28:47 +0100171#define TIPC_ADDR_NAMESEQ 1
172#define TIPC_ADDR_MCAST 1
173#define TIPC_ADDR_NAME 2
174#define TIPC_ADDR_ID 3
Per Lidenb97bf3f2006-01-02 19:04:38 +0100175
176struct sockaddr_tipc {
177 unsigned short family;
178 unsigned char addrtype;
179 signed char scope;
180 union {
181 struct tipc_portid id;
182 struct tipc_name_seq nameseq;
183 struct {
184 struct tipc_name name;
Allan Stephens8e1c2982010-05-11 14:30:09 +0000185 __u32 domain;
Per Lidenb97bf3f2006-01-02 19:04:38 +0100186 } name;
187 } addr;
188};
189
190/*
191 * Ancillary data objects supported by recvmsg()
192 */
193
194#define TIPC_ERRINFO 1 /* error info */
195#define TIPC_RETDATA 2 /* returned data */
196#define TIPC_DESTNAME 3 /* destination name */
197
198/*
199 * TIPC-specific socket option values
200 */
201
202#define TIPC_IMPORTANCE 127 /* Default: TIPC_LOW_IMPORTANCE */
Allan Stephens8e1c2982010-05-11 14:30:09 +0000203#define TIPC_SRC_DROPPABLE 128 /* Default: based on socket type */
Per Lidenb97bf3f2006-01-02 19:04:38 +0100204#define TIPC_DEST_DROPPABLE 129 /* Default: based on socket type */
Per Lidenea714cc2006-01-11 12:28:47 +0100205#define TIPC_CONN_TIMEOUT 130 /* Default: 8000 (ms) */
oscar.medina@motorola.com66506132009-06-30 03:25:39 +0000206#define TIPC_NODE_RECVQ_DEPTH 131 /* Default: none (read only) */
207#define TIPC_SOCK_RECVQ_DEPTH 132 /* Default: none (read only) */
Per Lidenb97bf3f2006-01-02 19:04:38 +0100208
209#endif