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
44struct 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 */
55struct 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 */
65struct 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 */
198struct sctp_error_cause {
199    u_int16_t code;
200    u_int16_t length;
201    /* optional cause-specific info may follow */
202} __packed;
203
204struct 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
210struct 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
216struct 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
221struct sctp_error_out_of_resource {
222    struct sctp_error_cause cause;  /* code=SCTP_ERROR_OUT_OF_RESOURCES */
223} __packed;
224
225struct sctp_error_unresolv_addr {
226    struct sctp_error_cause cause;  /* code=SCTP_ERROR_UNRESOLVABLE_ADDR */
227
228} __packed;
229
230struct 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