1 /*        $KAME: sctp.h,v 1.18 2005/03/06 16:04:16 itojun Exp $       */
2 /*        $NetBSD: sctp.h,v 1.7 2025/02/28 09:07:12 andvar Exp $ */
3 
4 #ifndef _NETINET_SCTP_H_
5 #define _NETINET_SCTP_H_
6 
7 /*
8  * Copyright (c) 2001, 2002, 2003, 2004 Cisco Systems, Inc.
9  * All rights reserved.
10  *
11  * Redistribution and use in source and binary forms, with or without
12  * modification, are permitted provided that the following conditions
13  * are met:
14  * 1. Redistributions of source code must retain the above copyright
15  *    notice, this list of conditions and the following disclaimer.
16  * 2. Redistributions in binary form must reproduce the above copyright
17  *    notice, this list of conditions and the following disclaimer in the
18  *    documentation and/or other materials provided with the distribution.
19  * 3. All advertising materials mentioning features or use of this software
20  *    must display the following acknowledgement:
21  *      This product includes software developed by Cisco Systems, Inc.
22  * 4. Neither the name of the project nor the names of its contributors
23  *    may be used to endorse or promote products derived from this software
24  *    without specific prior written permission.
25  *
26  * THIS SOFTWARE IS PROVIDED BY CISCO SYSTEMS AND CONTRIBUTORS ``AS IS'' AND
27  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
29  * ARE DISCLAIMED.  IN NO EVENT SHALL CISCO SYSTEMS OR CONTRIBUTORS BE LIABLE
30  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
31  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
32  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
33  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
34  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
35  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
36  * SUCH DAMAGE.
37  */
38 #include <sys/types.h>
39 
40 /*
41  * SCTP protocol - RFC2960.
42  */
43 
44 struct sctphdr {
45           u_int16_t src_port;           /* source port */
46           u_int16_t dest_port;                    /* destination port */
47           u_int32_t v_tag;              /* verification tag of packet */
48           u_int32_t checksum;           /* Adler32 C-Sum */
49           /* chunks follow... */
50 } __packed;
51 
52 /*
53  * SCTP Chunks
54  */
55 struct sctp_chunkhdr {
56           u_int8_t  chunk_type;                   /* chunk type */
57           u_int8_t  chunk_flags;                  /* chunk flags */
58           u_int16_t chunk_length;                 /* chunk length */
59           /* optional params follow */
60 } __packed;
61 
62 /*
63  * SCTP chunk parameters
64  */
65 struct sctp_paramhdr {
66           u_int16_t param_type;                   /* parameter type */
67           u_int16_t param_length;                 /* parameter length */
68 } __packed;
69 
70 /*
71  * user socket options
72  */
73 /* read-write options */
74 #define SCTP_NODELAY                              0x00000001
75 #define SCTP_MAXSEG                     0x00000002
76 #define SCTP_ASSOCINFO                            0x00000003
77 
78 #define SCTP_INITMSG                              0x00000004
79 #define SCTP_AUTOCLOSE                            0x00000005
80 #define SCTP_SET_PEER_PRIMARY_ADDR      0x00000006
81 #define SCTP_PRIMARY_ADDR               0x00000007
82 
83 /* read-only options */
84 #define SCTP_STATUS                     0x00000008
85 #define SCTP_PCB_STATUS                           0x00000009
86 
87 /* ancillary data/notification interest options */
88 #define SCTP_EVENTS                     0x0000000a
89 /* sctp_opt_info params */
90 #define SCTP_PEER_ADDR_PARAMS                     0x0000000b
91 #define SCTP_GET_PEER_ADDR_INFO                   0x0000000c
92 /* Hidden socket option that gets the addresses */
93 #define SCTP_GET_PEER_ADDRESSES                   0x0000000d
94 #define SCTP_GET_LOCAL_ADDRESSES        0x0000000e
95 /*
96  * Blocking I/O is enabled on any TCP type socket by default.
97  * For the UDP model if this is turned on then the socket buffer is
98  * shared for send resources amongst all associations. The default
99  * for the UDP model is that is SS_NBIO is set. Which means all associations
100  * have a separate send limit BUT they will NOT ever BLOCK instead
101  * you will get an error back EAGAIN if you try to send too much. If
102  * you want the blocking symantics you set this option at the cost
103  * of sharing one socket send buffer size amongst all associations.
104  * Peeled off sockets turn this option off and block... but since both TCP and
105  * peeled off sockets have only one assoc per socket this is fine.
106  * It probably does NOT make sense to set this  on SS_NBIO on a TCP model OR
107  * peeled off UDP model, but we do allow you to do so. You just use
108  * the normal syscall to toggle SS_NBIO the way you want.
109  */
110 /* Blocking I/O is controlled by the SS_NBIO flag on the
111  * socket state so_state field.
112  */
113 #define SCTP_GET_SNDBUF_USE             0x0000000f
114 /* latter added read/write */
115 #define SCTP_ADAPTION_LAYER             0x00000010
116 #define SCTP_DISABLE_FRAGMENTS                    0x00000011
117 /* sctp_bindx() flags as socket options */
118 #define SCTP_BINDX_ADD_ADDR             0x00000012
119 #define SCTP_BINDX_REM_ADDR             0x00000013
120 /* return the total count in bytes needed to hold all local addresses bound */
121 #define SCTP_GET_LOCAL_ADDR_SIZE        0x00000014
122 /* Without this applied we will give V4 and V6 addresses on a V6 socket */
123 #define SCTP_I_WANT_MAPPED_V4_ADDR      0x00000015
124 /* Return the total count in bytes needed to hold the remote address */
125 #define SCTP_GET_REMOTE_ADDR_SIZE       0x00000016
126 #define SCTP_GET_PEGS                             0x00000017
127 #define SCTP_DEFAULT_SEND_PARAM                   0x00000018
128 #define SCTP_SET_DEBUG_LEVEL            0x00000019
129 #define SCTP_RTOINFO                              0x0000001a
130 #define SCTP_AUTO_ASCONF                0x0000001b
131 #define SCTP_MAXBURST                             0x0000001c
132 #define SCTP_GET_STAT_LOG               0x0000001d
133 #define SCTP_CONNECT_X                            0x0000001e          /* hidden opt for connectx */
134 #define SCTP_RESET_STREAMS              0x0000001f
135 #define SCTP_CONNECT_X_DELAYED                    0x00000020          /* hidden opt for connectx_delayed
136                                                                        * part of sctp_sendx()
137                                                                        */
138 #define SCTP_CONNECT_X_COMPLETE         0x00000021
139 #define SCTP_GET_ASOC_ID_LIST           0x00000022
140 
141 /* Other BSD items */
142 #define SCTP_GET_NONCE_VALUES           0x00000023
143 #define SCTP_DELAYED_ACK_TIME           0x00000024
144 
145 /* Things for the AUTH draft possibly */
146 #define SCTP_PEER_PUBLIC_KEY            0x00000100 /* get the peers public key */
147 #define SCTP_MY_PUBLIC_KEY              0x00000101 /* get/set my endpoints public key */
148 #define SCTP_SET_AUTH_SECRET            0x00000102 /* get/set my shared secret */
149 #define SCTP_SET_AUTH_CHUNKS            0x00000103 /* specify what chunks you want
150                                                                  * the system may have additional requirements
151                                                                  * as well. I.e. probably ASCONF/ASCONF-ACK no matter
152                                                                  * if you want it or not.
153                                                                  */
154 /* Debug things that need to be purged */
155 #define SCTP_SET_INITIAL_DBG_SEQ        0x00001f00
156 #define SCTP_RESET_PEGS                 0x00002000
157 #define SCTP_CLR_STAT_LOG               0x00002100
158 
159 /*
160  * user state values
161  */
162 #define SCTP_CLOSED                     0x0000
163 #define SCTP_BOUND                      0x1000
164 #define SCTP_LISTEN                     0x2000
165 #define SCTP_COOKIE_WAIT                0x0002
166 #define SCTP_COOKIE_ECHOED              0x0004
167 #define SCTP_ESTABLISHED                0x0008
168 #define SCTP_SHUTDOWN_SENT              0x0010
169 #define SCTP_SHUTDOWN_RECEIVED                    0x0020
170 #define SCTP_SHUTDOWN_ACK_SENT                    0x0040
171 #define SCTP_SHUTDOWN_PENDING           0x0080
172 
173 /*
174  * SCTP operational error codes (user visible)
175  */
176 #define SCTP_ERROR_NO_ERROR             0x0000
177 #define SCTP_ERROR_INVALID_STREAM       0x0001
178 #define SCTP_ERROR_MISSING_PARAM        0x0002
179 #define SCTP_ERROR_STALE_COOKIE                   0x0003
180 #define SCTP_ERROR_OUT_OF_RESOURCES     0x0004
181 #define SCTP_ERROR_UNRESOLVABLE_ADDR    0x0005
182 #define SCTP_ERROR_UNRECOG_CHUNK        0x0006
183 #define SCTP_ERROR_INVALID_PARAM        0x0007
184 #define SCTP_ERROR_UNRECOG_PARAM        0x0008
185 #define SCTP_ERROR_NO_USER_DATA                   0x0009
186 #define SCTP_ERROR_COOKIE_IN_SHUTDOWN   0x000a
187 /* draft-ietf-tsvwg-sctpimpguide */
188 #define SCTP_ERROR_RESTART_NEWADDRS     0x000b
189 /* draft-ietf-tsvwg-addip-sctp */
190 #define SCTP_ERROR_DELETE_LAST_ADDR     0x0100
191 #define SCTP_ERROR_RESOURCE_SHORTAGE    0x0101
192 #define SCTP_ERROR_DELETE_SOURCE_ADDR   0x0102
193 #define SCTP_ERROR_ILLEGAL_ASCONF_ACK   0x0103
194 
195 /*
196  * error cause parameters (user visible)
197  */
198 struct sctp_error_cause {
199           u_int16_t code;
200           u_int16_t length;
201           /* optional cause-specific info may follow */
202 } __packed;
203 
204 struct sctp_error_invalid_stream {
205           struct sctp_error_cause cause;          /* code=SCTP_ERROR_INVALID_STREAM */
206           u_int16_t stream_id;                    /* stream id of the DATA in error */
207           u_int16_t reserved;
208 } __packed;
209 
210 struct sctp_error_missing_param {
211           struct sctp_error_cause cause;          /* code=SCTP_ERROR_MISSING_PARAM */
212           u_int32_t num_missing_params; /* number of missing parameters */
213           /* u_int16_t param_type's follow */
214 } __packed;
215 
216 struct sctp_error_stale_cookie {
217           struct sctp_error_cause cause;          /* code=SCTP_ERROR_STALE_COOKIE */
218           u_int32_t stale_time;                   /* time in usec of staleness */
219 } __packed;
220 
221 struct sctp_error_out_of_resource {
222           struct sctp_error_cause cause;          /* code=SCTP_ERROR_OUT_OF_RESOURCES */
223 } __packed;
224 
225 struct sctp_error_unresolv_addr {
226           struct sctp_error_cause cause;          /* code=SCTP_ERROR_UNRESOLVABLE_ADDR */
227 
228 } __packed;
229 
230 struct sctp_error_unrecognized_chunk {
231           struct sctp_error_cause cause;          /* code=SCTP_ERROR_UNRECOG_CHUNK */
232           struct sctp_chunkhdr ch;      /* header from chunk in error */
233 } __packed;
234 
235 #define HAVE_SCTP                       1
236 #define HAVE_KERNEL_SCTP                1
237 #define HAVE_SCTP_PRSCTP                1
238 #define HAVE_SCTP_ADDIP                           1
239 #define HAVE_SCTP_CANSET_PRIMARY        1
240 #define HAVE_SCTP_SAT_NETWORK_CAPABILITY1
241 #define HAVE_SCTP_MULTIBUF              1
242 #define HAVE_SCTP_NOCONNECT             0
243 #define HAVE_SCTP_ECN_NONCE             1  /* ECN Nonce option */
244 
245 /* Main SCTP chunk types, we place
246  * these here since that way natd and f/w's
247  * in user land can find them.
248  */
249 #define SCTP_DATA             0x00
250 #define SCTP_INITIATION                 0x01
251 #define SCTP_INITIATION_ACK   0x02
252 #define SCTP_SELECTIVE_ACK    0x03
253 #define SCTP_HEARTBEAT_REQUEST          0x04
254 #define SCTP_HEARTBEAT_ACK    0x05
255 #define SCTP_ABORT_ASSOCIATION          0x06
256 #define SCTP_SHUTDOWN                   0x07
257 #define SCTP_SHUTDOWN_ACK     0x08
258 #define SCTP_OPERATION_ERROR  0x09
259 #define SCTP_COOKIE_ECHO      0x0a
260 #define SCTP_COOKIE_ACK                 0x0b
261 #define SCTP_ECN_ECHO                   0x0c
262 #define SCTP_ECN_CWR                    0x0d
263 #define SCTP_SHUTDOWN_COMPLETE          0x0e
264 
265 /* draft-ietf-tsvwg-addip-sctp */
266 #define SCTP_ASCONF           0xc1
267 #define   SCTP_ASCONF_ACK               0x80
268 
269 /* draft-ietf-stewart-prsctp */
270 #define SCTP_FORWARD_CUM_TSN  0xc0
271 
272 /* draft-ietf-stewart-pktdrpsctp */
273 #define SCTP_PACKET_DROPPED   0x81
274 
275 /* draft-ietf-stewart-strreset-xxx */
276 #define SCTP_STREAM_RESET       0x82
277 
278 /* ABORT and SHUTDOWN COMPLETE FLAG */
279 #define SCTP_HAD_NO_TCB                 0x01
280 
281 /* Packet dropped flags */
282 #define SCTP_FROM_MIDDLE_BOX  SCTP_HAD_NO_TCB
283 #define SCTP_BADCRC           0x02
284 #define SCTP_PACKET_TRUNCATED 0x04
285 
286 #define SCTP_SAT_NETWORK_MIN       400  /* min ms for RTT to set satellite time */
287 #define SCTP_SAT_NETWORK_BURST_INCR  2            /* how many times to multiply maxburst in sat */
288 /* Data Chunk Specific Flags */
289 #define SCTP_DATA_FRAG_MASK   0x03
290 #define SCTP_DATA_MIDDLE_FRAG 0x00
291 #define SCTP_DATA_LAST_FRAG   0x01
292 #define SCTP_DATA_FIRST_FRAG  0x02
293 #define SCTP_DATA_NOT_FRAG    0x03
294 #define SCTP_DATA_UNORDERED   0x04
295 
296 /* ECN Nonce: SACK Chunk Specific Flags */
297 #define SCTP_SACK_NONCE_SUM     0x01
298 
299 #include <netinet/sctp_uio.h>
300 
301 #endif /* !_NETINET_SCTP_H_ */
302