]> git.proxmox.com Git - mirror_ubuntu-bionic-kernel.git/blame - include/uapi/linux/sctp.h
sctp: fix a type cast warnings that causes a_rwnd gets the wrong value
[mirror_ubuntu-bionic-kernel.git] / include / uapi / linux / sctp.h
CommitLineData
60c778b2 1/* SCTP kernel implementation
1da177e4
LT
2 * (C) Copyright IBM Corp. 2001, 2004
3 * Copyright (c) 1999-2000 Cisco, Inc.
4 * Copyright (c) 1999-2001 Motorola, Inc.
5 * Copyright (c) 2002 Intel Corp.
6 *
60c778b2 7 * This file is part of the SCTP kernel implementation
1da177e4
LT
8 *
9 * This header represents the structures and constants needed to support
10 * the SCTP Extension to the Sockets API.
11 *
60c778b2 12 * This SCTP implementation is free software;
1da177e4
LT
13 * you can redistribute it and/or modify it under the terms of
14 * the GNU General Public License as published by
15 * the Free Software Foundation; either version 2, or (at your option)
16 * any later version.
17 *
60c778b2 18 * This SCTP implementation is distributed in the hope that it
1da177e4
LT
19 * will be useful, but WITHOUT ANY WARRANTY; without even the implied
20 * ************************
21 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
22 * See the GNU General Public License for more details.
23 *
24 * You should have received a copy of the GNU General Public License
4b2f13a2
JK
25 * along with GNU CC; see the file COPYING. If not, see
26 * <http://www.gnu.org/licenses/>.
1da177e4
LT
27 *
28 * Please send any bug reports or fixes you make to the
29 * email address(es):
91705c61 30 * lksctp developers <linux-sctp@vger.kernel.org>
1da177e4
LT
31 *
32 * Or submit a bug report through the following website:
33 * http://www.sf.net/projects/lksctp
34 *
35 * Written or modified by:
36 * La Monte H.P. Yarroll <piggy@acm.org>
37 * R. Stewart <randall@sctp.chicago.il.us>
38 * K. Morneau <kmorneau@cisco.com>
39 * Q. Xie <qxie1@email.mot.com>
40 * Karl Knutson <karl@athena.chicago.il.us>
41 * Jon Grimm <jgrimm@us.ibm.com>
42 * Daisy Chang <daisyc@us.ibm.com>
43 * Ryan Layer <rmlayer@us.ibm.com>
1b866434 44 * Ardelle Fan <ardelle.fan@intel.com>
1da177e4 45 * Sridhar Samudrala <sri@us.ibm.com>
1b866434
DB
46 * Inaky Perez-Gonzalez <inaky.gonzalez@intel.com>
47 * Vlad Yasevich <vladislav.yasevich@hp.com>
1da177e4
LT
48 *
49 * Any bugs reported given to us we will try to fix... any fixes shared will
50 * be incorporated into the next SCTP release.
51 */
52
1b866434
DB
53#ifndef _UAPI_SCTP_H
54#define _UAPI_SCTP_H
1da177e4
LT
55
56#include <linux/types.h>
57#include <linux/socket.h>
58
59typedef __s32 sctp_assoc_t;
60
61/* The following symbols come from the Sockets API Extensions for
62 * SCTP <draft-ietf-tsvwg-sctpsocket-07.txt>.
63 */
a5b03ad2
VY
64#define SCTP_RTOINFO 0
65#define SCTP_ASSOCINFO 1
66#define SCTP_INITMSG 2
67#define SCTP_NODELAY 3 /* Get/set nodelay option. */
68#define SCTP_AUTOCLOSE 4
69#define SCTP_SET_PEER_PRIMARY_ADDR 5
70#define SCTP_PRIMARY_ADDR 6
71#define SCTP_ADAPTATION_LAYER 7
72#define SCTP_DISABLE_FRAGMENTS 8
73#define SCTP_PEER_ADDR_PARAMS 9
74#define SCTP_DEFAULT_SEND_PARAM 10
75#define SCTP_EVENTS 11
76#define SCTP_I_WANT_MAPPED_V4_ADDR 12 /* Turn on/off mapped v4 addresses */
77#define SCTP_MAXSEG 13 /* Get/set maximum fragment. */
78#define SCTP_STATUS 14
79#define SCTP_GET_PEER_ADDR_INFO 15
80#define SCTP_DELAYED_ACK_TIME 16
81#define SCTP_DELAYED_ACK SCTP_DELAYED_ACK_TIME
4580ccc0 82#define SCTP_DELAYED_SACK SCTP_DELAYED_ACK_TIME
a5b03ad2
VY
83#define SCTP_CONTEXT 17
84#define SCTP_FRAGMENT_INTERLEAVE 18
85#define SCTP_PARTIAL_DELIVERY_POINT 19 /* Set/Get partial delivery point */
86#define SCTP_MAX_BURST 20 /* Set/Get max burst */
87#define SCTP_AUTH_CHUNK 21 /* Set only: add a chunk type to authenticate */
88#define SCTP_HMAC_IDENT 22
89#define SCTP_AUTH_KEY 23
90#define SCTP_AUTH_ACTIVE_KEY 24
91#define SCTP_AUTH_DELETE_KEY 25
92#define SCTP_PEER_AUTH_CHUNKS 26 /* Read only */
93#define SCTP_LOCAL_AUTH_CHUNKS 27 /* Read only */
94#define SCTP_GET_ASSOC_NUMBER 28 /* Read only */
209ba424 95#define SCTP_GET_ASSOC_ID_LIST 29 /* Read only */
7dc04d71 96#define SCTP_AUTO_ASCONF 30
5aa93bcf 97#define SCTP_PEER_ADDR_THLDS 31
0d3a421d 98#define SCTP_RECVRCVINFO 32
2347c80f 99#define SCTP_RECVNXTINFO 33
6b3fd5f3 100#define SCTP_DEFAULT_SNDINFO 34
65b07e5d 101
a5b03ad2
VY
102/* Internal Socket Options. Some of the sctp library functions are
103 * implemented using these socket options.
104 */
105#define SCTP_SOCKOPT_BINDX_ADD 100 /* BINDX requests for adding addrs */
106#define SCTP_SOCKOPT_BINDX_REM 101 /* BINDX requests for removing addrs. */
107#define SCTP_SOCKOPT_PEELOFF 102 /* peel off association. */
108/* Options 104-106 are deprecated and removed. Do not use this space */
109#define SCTP_SOCKOPT_CONNECTX_OLD 107 /* CONNECTX old requests. */
b595076a
UKK
110#define SCTP_GET_PEER_ADDRS 108 /* Get all peer address. */
111#define SCTP_GET_LOCAL_ADDRS 109 /* Get all local address. */
a5b03ad2
VY
112#define SCTP_SOCKOPT_CONNECTX 110 /* CONNECTX requests. */
113#define SCTP_SOCKOPT_CONNECTX3 111 /* CONNECTX requests (updated) */
196d6759 114#define SCTP_GET_ASSOC_STATS 112 /* Read only */
28aa4c26 115#define SCTP_PR_SUPPORTED 113
f959fb44 116#define SCTP_DEFAULT_PRINFO 114
826d253d 117#define SCTP_PR_ASSOC_STATUS 115
d229d48d 118#define SCTP_PR_STREAM_STATUS 116
c0d8bab6 119#define SCTP_RECONFIG_SUPPORTED 117
9fb657ae 120#define SCTP_ENABLE_STREAM_RESET 118
7f9d68ac 121#define SCTP_RESET_STREAMS 119
a92ce1a4 122#define SCTP_RESET_ASSOC 120
242bd2d5 123#define SCTP_ADD_STREAMS 121
2cb5c8e3 124#define SCTP_SOCKOPT_PEELOFF_FLAGS 122
f959fb44
XL
125
126/* PR-SCTP policies */
127#define SCTP_PR_SCTP_NONE 0x0000
128#define SCTP_PR_SCTP_TTL 0x0010
129#define SCTP_PR_SCTP_RTX 0x0020
130#define SCTP_PR_SCTP_PRIO 0x0030
131#define SCTP_PR_SCTP_MAX SCTP_PR_SCTP_PRIO
132#define SCTP_PR_SCTP_MASK 0x0030
133
134#define __SCTP_PR_INDEX(x) ((x >> 4) - 1)
135#define SCTP_PR_INDEX(x) __SCTP_PR_INDEX(SCTP_PR_SCTP_ ## x)
136
137#define SCTP_PR_POLICY(x) ((x) & SCTP_PR_SCTP_MASK)
138#define SCTP_PR_SET_POLICY(flags, x) \
139 do { \
140 flags &= ~SCTP_PR_SCTP_MASK; \
141 flags |= x; \
142 } while (0)
143
144#define SCTP_PR_TTL_ENABLED(x) (SCTP_PR_POLICY(x) == SCTP_PR_SCTP_TTL)
145#define SCTP_PR_RTX_ENABLED(x) (SCTP_PR_POLICY(x) == SCTP_PR_SCTP_RTX)
146#define SCTP_PR_PRIO_ENABLED(x) (SCTP_PR_POLICY(x) == SCTP_PR_SCTP_PRIO)
1da177e4 147
9fb657ae
XL
148/* For enable stream reset */
149#define SCTP_ENABLE_RESET_STREAM_REQ 0x01
150#define SCTP_ENABLE_RESET_ASSOC_REQ 0x02
151#define SCTP_ENABLE_CHANGE_ASSOC_REQ 0x04
152#define SCTP_ENABLE_STRRESET_MASK 0x07
153
7f9d68ac
XL
154#define SCTP_STREAM_RESET_INCOMING 0x01
155#define SCTP_STREAM_RESET_OUTGOING 0x02
156
2347c80f
GOV
157/* These are bit fields for msghdr->msg_flags. See section 5.1. */
158/* On user space Linux, these live in <bits/socket.h> as an enum. */
159enum sctp_msg_flags {
160 MSG_NOTIFICATION = 0x8000,
161#define MSG_NOTIFICATION MSG_NOTIFICATION
162};
163
0d3a421d 164/* 5.3.1 SCTP Initiation Structure (SCTP_INIT)
1da177e4
LT
165 *
166 * This cmsghdr structure provides information for initializing new
167 * SCTP associations with sendmsg(). The SCTP_INITMSG socket option
168 * uses this same data structure. This structure is not used for
169 * recvmsg().
170 *
171 * cmsg_level cmsg_type cmsg_data[]
172 * ------------ ------------ ----------------------
173 * IPPROTO_SCTP SCTP_INIT struct sctp_initmsg
1da177e4
LT
174 */
175struct sctp_initmsg {
176 __u16 sinit_num_ostreams;
177 __u16 sinit_max_instreams;
178 __u16 sinit_max_attempts;
179 __u16 sinit_max_init_timeo;
180};
181
0d3a421d 182/* 5.3.2 SCTP Header Information Structure (SCTP_SNDRCV)
1da177e4
LT
183 *
184 * This cmsghdr structure specifies SCTP options for sendmsg() and
185 * describes SCTP header information about a received message through
186 * recvmsg().
187 *
188 * cmsg_level cmsg_type cmsg_data[]
189 * ------------ ------------ ----------------------
190 * IPPROTO_SCTP SCTP_SNDRCV struct sctp_sndrcvinfo
1da177e4
LT
191 */
192struct sctp_sndrcvinfo {
193 __u16 sinfo_stream;
194 __u16 sinfo_ssn;
195 __u16 sinfo_flags;
196 __u32 sinfo_ppid;
197 __u32 sinfo_context;
198 __u32 sinfo_timetolive;
199 __u32 sinfo_tsn;
200 __u32 sinfo_cumtsn;
201 sctp_assoc_t sinfo_assoc_id;
202};
203
63b94938
GOV
204/* 5.3.4 SCTP Send Information Structure (SCTP_SNDINFO)
205 *
206 * This cmsghdr structure specifies SCTP options for sendmsg().
207 *
208 * cmsg_level cmsg_type cmsg_data[]
209 * ------------ ------------ -------------------
210 * IPPROTO_SCTP SCTP_SNDINFO struct sctp_sndinfo
211 */
212struct sctp_sndinfo {
213 __u16 snd_sid;
214 __u16 snd_flags;
215 __u32 snd_ppid;
216 __u32 snd_context;
217 sctp_assoc_t snd_assoc_id;
218};
219
0d3a421d
GOV
220/* 5.3.5 SCTP Receive Information Structure (SCTP_RCVINFO)
221 *
222 * This cmsghdr structure describes SCTP receive information
223 * about a received message through recvmsg().
224 *
225 * cmsg_level cmsg_type cmsg_data[]
226 * ------------ ------------ -------------------
227 * IPPROTO_SCTP SCTP_RCVINFO struct sctp_rcvinfo
228 */
229struct sctp_rcvinfo {
230 __u16 rcv_sid;
231 __u16 rcv_ssn;
232 __u16 rcv_flags;
233 __u32 rcv_ppid;
234 __u32 rcv_tsn;
235 __u32 rcv_cumtsn;
236 __u32 rcv_context;
237 sctp_assoc_t rcv_assoc_id;
238};
239
2347c80f
GOV
240/* 5.3.6 SCTP Next Receive Information Structure (SCTP_NXTINFO)
241 *
242 * This cmsghdr structure describes SCTP receive information
243 * of the next message that will be delivered through recvmsg()
244 * if this information is already available when delivering
245 * the current message.
246 *
247 * cmsg_level cmsg_type cmsg_data[]
248 * ------------ ------------ -------------------
249 * IPPROTO_SCTP SCTP_NXTINFO struct sctp_nxtinfo
250 */
251struct sctp_nxtinfo {
252 __u16 nxt_sid;
253 __u16 nxt_flags;
254 __u32 nxt_ppid;
255 __u32 nxt_length;
256 sctp_assoc_t nxt_assoc_id;
257};
258
1da177e4
LT
259/*
260 * sinfo_flags: 16 bits (unsigned integer)
261 *
262 * This field may contain any of the following flags and is composed of
263 * a bitwise OR of these values.
264 */
1da177e4 265enum sctp_sinfo_flags {
2347c80f
GOV
266 SCTP_UNORDERED = (1 << 0), /* Send/receive message unordered. */
267 SCTP_ADDR_OVER = (1 << 1), /* Override the primary destination. */
268 SCTP_ABORT = (1 << 2), /* Send an ABORT message to the peer. */
269 SCTP_SACK_IMMEDIATELY = (1 << 3), /* SACK should be sent without delay. */
270 SCTP_NOTIFICATION = MSG_NOTIFICATION, /* Next message is not user msg but notification. */
271 SCTP_EOF = MSG_FIN, /* Initiate graceful shutdown process. */
1da177e4
LT
272};
273
1b866434
DB
274typedef union {
275 __u8 raw;
276 struct sctp_initmsg init;
277 struct sctp_sndrcvinfo sndrcv;
278} sctp_cmsg_data_t;
1da177e4 279
1da177e4
LT
280/* These are cmsg_types. */
281typedef enum sctp_cmsg_type {
63b94938 282 SCTP_INIT, /* 5.2.1 SCTP Initiation Structure */
1b866434 283#define SCTP_INIT SCTP_INIT
63b94938 284 SCTP_SNDRCV, /* 5.2.2 SCTP Header Information Structure */
1b866434 285#define SCTP_SNDRCV SCTP_SNDRCV
63b94938
GOV
286 SCTP_SNDINFO, /* 5.3.4 SCTP Send Information Structure */
287#define SCTP_SNDINFO SCTP_SNDINFO
0d3a421d
GOV
288 SCTP_RCVINFO, /* 5.3.5 SCTP Receive Information Structure */
289#define SCTP_RCVINFO SCTP_RCVINFO
2347c80f
GOV
290 SCTP_NXTINFO, /* 5.3.6 SCTP Next Receive Information Structure */
291#define SCTP_NXTINFO SCTP_NXTINFO
1da177e4
LT
292} sctp_cmsg_t;
293
1da177e4
LT
294/*
295 * 5.3.1.1 SCTP_ASSOC_CHANGE
296 *
297 * Communication notifications inform the ULP that an SCTP association
298 * has either begun or ended. The identifier for a new association is
299 * provided by this notificaion. The notification information has the
300 * following format:
301 *
302 */
303struct sctp_assoc_change {
304 __u16 sac_type;
305 __u16 sac_flags;
306 __u32 sac_length;
307 __u16 sac_state;
308 __u16 sac_error;
309 __u16 sac_outbound_streams;
310 __u16 sac_inbound_streams;
311 sctp_assoc_t sac_assoc_id;
a5a35e76 312 __u8 sac_info[0];
1da177e4
LT
313};
314
315/*
316 * sac_state: 32 bits (signed integer)
317 *
318 * This field holds one of a number of values that communicate the
319 * event that happened to the association. They include:
320 *
321 * Note: The following state names deviate from the API draft as
322 * the names clash too easily with other kernel symbols.
323 */
324enum sctp_sac_state {
325 SCTP_COMM_UP,
326 SCTP_COMM_LOST,
327 SCTP_RESTART,
328 SCTP_SHUTDOWN_COMP,
329 SCTP_CANT_STR_ASSOC,
330};
331
332/*
333 * 5.3.1.2 SCTP_PEER_ADDR_CHANGE
334 *
335 * When a destination address on a multi-homed peer encounters a change
336 * an interface details event is sent. The information has the
337 * following structure:
338 */
339struct sctp_paddr_change {
340 __u16 spc_type;
341 __u16 spc_flags;
342 __u32 spc_length;
343 struct sockaddr_storage spc_aaddr;
344 int spc_state;
345 int spc_error;
346 sctp_assoc_t spc_assoc_id;
20c9c825 347} __attribute__((packed, aligned(4)));
1da177e4
LT
348
349/*
350 * spc_state: 32 bits (signed integer)
351 *
352 * This field holds one of a number of values that communicate the
353 * event that happened to the address. They include:
354 */
355enum sctp_spc_state {
356 SCTP_ADDR_AVAILABLE,
357 SCTP_ADDR_UNREACHABLE,
358 SCTP_ADDR_REMOVED,
359 SCTP_ADDR_ADDED,
360 SCTP_ADDR_MADE_PRIM,
1ae4114d 361 SCTP_ADDR_CONFIRMED,
1da177e4
LT
362};
363
364
365/*
366 * 5.3.1.3 SCTP_REMOTE_ERROR
367 *
368 * A remote peer may send an Operational Error message to its peer.
369 * This message indicates a variety of error conditions on an
370 * association. The entire error TLV as it appears on the wire is
371 * included in a SCTP_REMOTE_ERROR event. Please refer to the SCTP
372 * specification [SCTP] and any extensions for a list of possible
373 * error formats. SCTP error TLVs have the format:
374 */
375struct sctp_remote_error {
376 __u16 sre_type;
377 __u16 sre_flags;
378 __u32 sre_length;
379 __u16 sre_error;
380 sctp_assoc_t sre_assoc_id;
381 __u8 sre_data[0];
382};
383
384
385/*
386 * 5.3.1.4 SCTP_SEND_FAILED
387 *
388 * If SCTP cannot deliver a message it may return the message as a
389 * notification.
390 */
391struct sctp_send_failed {
392 __u16 ssf_type;
393 __u16 ssf_flags;
394 __u32 ssf_length;
395 __u32 ssf_error;
396 struct sctp_sndrcvinfo ssf_info;
397 sctp_assoc_t ssf_assoc_id;
398 __u8 ssf_data[0];
399};
400
401/*
402 * ssf_flags: 16 bits (unsigned integer)
403 *
404 * The flag value will take one of the following values
405 *
406 * SCTP_DATA_UNSENT - Indicates that the data was never put on
407 * the wire.
408 *
409 * SCTP_DATA_SENT - Indicates that the data was put on the wire.
410 * Note that this does not necessarily mean that the
411 * data was (or was not) successfully delivered.
412 */
413enum sctp_ssf_flags {
414 SCTP_DATA_UNSENT,
415 SCTP_DATA_SENT,
416};
417
418/*
419 * 5.3.1.5 SCTP_SHUTDOWN_EVENT
420 *
421 * When a peer sends a SHUTDOWN, SCTP delivers this notification to
422 * inform the application that it should cease sending data.
423 */
424struct sctp_shutdown_event {
425 __u16 sse_type;
426 __u16 sse_flags;
427 __u32 sse_length;
428 sctp_assoc_t sse_assoc_id;
429};
430
431/*
0f3fffd8 432 * 5.3.1.6 SCTP_ADAPTATION_INDICATION
1da177e4 433 *
0f3fffd8 434 * When a peer sends a Adaptation Layer Indication parameter , SCTP
1da177e4 435 * delivers this notification to inform the application
0f3fffd8 436 * that of the peers requested adaptation layer.
1da177e4 437 */
0f3fffd8 438struct sctp_adaptation_event {
1da177e4
LT
439 __u16 sai_type;
440 __u16 sai_flags;
441 __u32 sai_length;
0f3fffd8 442 __u32 sai_adaptation_ind;
1da177e4
LT
443 sctp_assoc_t sai_assoc_id;
444};
445
446/*
447 * 5.3.1.7 SCTP_PARTIAL_DELIVERY_EVENT
448 *
449 * When a receiver is engaged in a partial delivery of a
450 * message this notification will be used to indicate
451 * various events.
452 */
453struct sctp_pdapi_event {
454 __u16 pdapi_type;
455 __u16 pdapi_flags;
456 __u32 pdapi_length;
457 __u32 pdapi_indication;
458 sctp_assoc_t pdapi_assoc_id;
459};
460
461enum { SCTP_PARTIAL_DELIVERY_ABORTED=0, };
462
1b866434
DB
463/*
464 * 5.3.1.8. SCTP_AUTHENTICATION_EVENT
465 *
466 * When a receiver is using authentication this message will provide
467 * notifications regarding new keys being made active as well as errors.
468 */
65b07e5d
VY
469struct sctp_authkey_event {
470 __u16 auth_type;
471 __u16 auth_flags;
472 __u32 auth_length;
473 __u16 auth_keynumber;
474 __u16 auth_altkeynumber;
475 __u32 auth_indication;
476 sctp_assoc_t auth_assoc_id;
477};
478
479enum { SCTP_AUTH_NEWKEY = 0, };
480
e1cdd553
WY
481/*
482 * 6.1.9. SCTP_SENDER_DRY_EVENT
483 *
484 * When the SCTP stack has no more user data to send or retransmit, this
485 * notification is given to the user. Also, at the time when a user app
486 * subscribes to this event, if there is no data to be sent or
487 * retransmit, the stack will immediately send up this notification.
488 */
489struct sctp_sender_dry_event {
490 __u16 sender_dry_type;
491 __u16 sender_dry_flags;
492 __u32 sender_dry_length;
493 sctp_assoc_t sender_dry_assoc_id;
494};
65b07e5d 495
35ea82d6
XL
496#define SCTP_STREAM_RESET_INCOMING_SSN 0x0001
497#define SCTP_STREAM_RESET_OUTGOING_SSN 0x0002
498#define SCTP_STREAM_RESET_DENIED 0x0004
499#define SCTP_STREAM_RESET_FAILED 0x0008
500struct sctp_stream_reset_event {
501 __u16 strreset_type;
502 __u16 strreset_flags;
503 __u32 strreset_length;
504 sctp_assoc_t strreset_assoc_id;
505 __u16 strreset_stream_list[];
506};
507
c95129d1
XL
508#define SCTP_ASSOC_RESET_DENIED 0x0004
509#define SCTP_ASSOC_RESET_FAILED 0x0008
510struct sctp_assoc_reset_event {
511 __u16 assocreset_type;
512 __u16 assocreset_flags;
513 __u32 assocreset_length;
514 sctp_assoc_t assocreset_assoc_id;
515 __u32 assocreset_local_tsn;
516 __u32 assocreset_remote_tsn;
517};
518
b444153f
XL
519#define SCTP_ASSOC_CHANGE_DENIED 0x0004
520#define SCTP_ASSOC_CHANGE_FAILED 0x0008
521struct sctp_stream_change_event {
522 __u16 strchange_type;
523 __u16 strchange_flags;
524 __u32 strchange_length;
525 sctp_assoc_t strchange_assoc_id;
526 __u16 strchange_instrms;
527 __u16 strchange_outstrms;
528};
529
1da177e4
LT
530/*
531 * Described in Section 7.3
532 * Ancillary Data and Notification Interest Options
533 */
534struct sctp_event_subscribe {
535 __u8 sctp_data_io_event;
536 __u8 sctp_association_event;
537 __u8 sctp_address_event;
538 __u8 sctp_send_failure_event;
539 __u8 sctp_peer_error_event;
540 __u8 sctp_shutdown_event;
541 __u8 sctp_partial_delivery_event;
0f3fffd8 542 __u8 sctp_adaptation_layer_event;
7e8616d8 543 __u8 sctp_authentication_event;
e1cdd553 544 __u8 sctp_sender_dry_event;
35ea82d6 545 __u8 sctp_stream_reset_event;
c95129d1 546 __u8 sctp_assoc_reset_event;
b444153f 547 __u8 sctp_stream_change_event;
1da177e4
LT
548};
549
550/*
551 * 5.3.1 SCTP Notification Structure
552 *
553 * The notification structure is defined as the union of all
554 * notification types.
555 *
556 */
557union sctp_notification {
558 struct {
559 __u16 sn_type; /* Notification type. */
560 __u16 sn_flags;
561 __u32 sn_length;
562 } sn_header;
563 struct sctp_assoc_change sn_assoc_change;
564 struct sctp_paddr_change sn_paddr_change;
565 struct sctp_remote_error sn_remote_error;
566 struct sctp_send_failed sn_send_failed;
567 struct sctp_shutdown_event sn_shutdown_event;
0f3fffd8 568 struct sctp_adaptation_event sn_adaptation_event;
1da177e4 569 struct sctp_pdapi_event sn_pdapi_event;
65b07e5d 570 struct sctp_authkey_event sn_authkey_event;
e1cdd553 571 struct sctp_sender_dry_event sn_sender_dry_event;
35ea82d6 572 struct sctp_stream_reset_event sn_strreset_event;
c95129d1 573 struct sctp_assoc_reset_event sn_assocreset_event;
b444153f 574 struct sctp_stream_change_event sn_strchange_event;
1da177e4
LT
575};
576
577/* Section 5.3.1
578 * All standard values for sn_type flags are greater than 2^15.
579 * Values from 2^15 and down are reserved.
580 */
581
582enum sctp_sn_type {
583 SCTP_SN_TYPE_BASE = (1<<15),
584 SCTP_ASSOC_CHANGE,
1b866434 585#define SCTP_ASSOC_CHANGE SCTP_ASSOC_CHANGE
1da177e4 586 SCTP_PEER_ADDR_CHANGE,
1b866434 587#define SCTP_PEER_ADDR_CHANGE SCTP_PEER_ADDR_CHANGE
1da177e4 588 SCTP_SEND_FAILED,
1b866434 589#define SCTP_SEND_FAILED SCTP_SEND_FAILED
1da177e4 590 SCTP_REMOTE_ERROR,
1b866434 591#define SCTP_REMOTE_ERROR SCTP_REMOTE_ERROR
1da177e4 592 SCTP_SHUTDOWN_EVENT,
1b866434 593#define SCTP_SHUTDOWN_EVENT SCTP_SHUTDOWN_EVENT
1da177e4 594 SCTP_PARTIAL_DELIVERY_EVENT,
1b866434 595#define SCTP_PARTIAL_DELIVERY_EVENT SCTP_PARTIAL_DELIVERY_EVENT
0f3fffd8 596 SCTP_ADAPTATION_INDICATION,
1b866434 597#define SCTP_ADAPTATION_INDICATION SCTP_ADAPTATION_INDICATION
ee916fd0
WY
598 SCTP_AUTHENTICATION_EVENT,
599#define SCTP_AUTHENTICATION_INDICATION SCTP_AUTHENTICATION_EVENT
e1cdd553 600 SCTP_SENDER_DRY_EVENT,
1b866434 601#define SCTP_SENDER_DRY_EVENT SCTP_SENDER_DRY_EVENT
35ea82d6
XL
602 SCTP_STREAM_RESET_EVENT,
603#define SCTP_STREAM_RESET_EVENT SCTP_STREAM_RESET_EVENT
c95129d1
XL
604 SCTP_ASSOC_RESET_EVENT,
605#define SCTP_ASSOC_RESET_EVENT SCTP_ASSOC_RESET_EVENT
b444153f
XL
606 SCTP_STREAM_CHANGE_EVENT,
607#define SCTP_STREAM_CHANGE_EVENT SCTP_STREAM_CHANGE_EVENT
1da177e4
LT
608};
609
610/* Notification error codes used to fill up the error fields in some
611 * notifications.
612 * SCTP_PEER_ADDRESS_CHAGE : spc_error
613 * SCTP_ASSOC_CHANGE : sac_error
614 * These names should be potentially included in the draft 04 of the SCTP
615 * sockets API specification.
616 */
617typedef enum sctp_sn_error {
618 SCTP_FAILED_THRESHOLD,
619 SCTP_RECEIVED_SACK,
620 SCTP_HEARTBEAT_SUCCESS,
621 SCTP_RESPONSE_TO_USER_REQ,
622 SCTP_INTERNAL_ERROR,
623 SCTP_SHUTDOWN_GUARD_EXPIRES,
624 SCTP_PEER_FAULTY,
625} sctp_sn_error_t;
626
627/*
628 * 7.1.1 Retransmission Timeout Parameters (SCTP_RTOINFO)
629 *
630 * The protocol parameters used to initialize and bound retransmission
631 * timeout (RTO) are tunable. See [SCTP] for more information on how
1b866434 632 * these parameters are used in RTO calculation.
1da177e4
LT
633 */
634struct sctp_rtoinfo {
635 sctp_assoc_t srto_assoc_id;
636 __u32 srto_initial;
637 __u32 srto_max;
638 __u32 srto_min;
639};
640
641/*
642 * 7.1.2 Association Parameters (SCTP_ASSOCINFO)
643 *
644 * This option is used to both examine and set various association and
645 * endpoint parameters.
646 */
647struct sctp_assocparams {
648 sctp_assoc_t sasoc_assoc_id;
649 __u16 sasoc_asocmaxrxt;
650 __u16 sasoc_number_peer_destinations;
651 __u32 sasoc_peer_rwnd;
652 __u32 sasoc_local_rwnd;
653 __u32 sasoc_cookie_life;
654};
655
656/*
657 * 7.1.9 Set Peer Primary Address (SCTP_SET_PEER_PRIMARY_ADDR)
658 *
659 * Requests that the peer mark the enclosed address as the association
660 * primary. The enclosed address must be one of the association's
661 * locally bound addresses. The following structure is used to make a
662 * set primary request:
663 */
664struct sctp_setpeerprim {
665 sctp_assoc_t sspp_assoc_id;
666 struct sockaddr_storage sspp_addr;
20c9c825 667} __attribute__((packed, aligned(4)));
1da177e4
LT
668
669/*
670 * 7.1.10 Set Primary Address (SCTP_PRIMARY_ADDR)
671 *
672 * Requests that the local SCTP stack use the enclosed peer address as
673 * the association primary. The enclosed address must be one of the
674 * association peer's addresses. The following structure is used to
675 * make a set peer primary request:
676 */
677struct sctp_prim {
678 sctp_assoc_t ssp_assoc_id;
679 struct sockaddr_storage ssp_addr;
20c9c825 680} __attribute__((packed, aligned(4)));
1da177e4 681
1b866434
DB
682/* For backward compatibility use, define the old name too */
683#define sctp_setprim sctp_prim
684
1da177e4 685/*
0f3fffd8 686 * 7.1.11 Set Adaptation Layer Indicator (SCTP_ADAPTATION_LAYER)
1da177e4 687 *
0f3fffd8 688 * Requests that the local endpoint set the specified Adaptation Layer
1da177e4
LT
689 * Indication parameter for all future INIT and INIT-ACK exchanges.
690 */
0f3fffd8
ISJ
691struct sctp_setadaptation {
692 __u32 ssb_adaptation_ind;
1da177e4
LT
693};
694
695/*
696 * 7.1.13 Peer Address Parameters (SCTP_PEER_ADDR_PARAMS)
697 *
698 * Applications can enable or disable heartbeats for any peer address
699 * of an association, modify an address's heartbeat interval, force a
700 * heartbeat to be sent immediately, and adjust the address's maximum
701 * number of retransmissions sent before an address is considered
702 * unreachable. The following structure is used to access and modify an
703 * address's parameters:
704 */
52ccb8e9 705enum sctp_spp_flags {
bdf3092a
VY
706 SPP_HB_ENABLE = 1<<0, /*Enable heartbeats*/
707 SPP_HB_DISABLE = 1<<1, /*Disable heartbeats*/
52ccb8e9 708 SPP_HB = SPP_HB_ENABLE | SPP_HB_DISABLE,
bdf3092a
VY
709 SPP_HB_DEMAND = 1<<2, /*Send heartbeat immediately*/
710 SPP_PMTUD_ENABLE = 1<<3, /*Enable PMTU discovery*/
711 SPP_PMTUD_DISABLE = 1<<4, /*Disable PMTU discovery*/
52ccb8e9 712 SPP_PMTUD = SPP_PMTUD_ENABLE | SPP_PMTUD_DISABLE,
bdf3092a
VY
713 SPP_SACKDELAY_ENABLE = 1<<5, /*Enable SACK*/
714 SPP_SACKDELAY_DISABLE = 1<<6, /*Disable SACK*/
52ccb8e9 715 SPP_SACKDELAY = SPP_SACKDELAY_ENABLE | SPP_SACKDELAY_DISABLE,
bdf3092a 716 SPP_HB_TIME_IS_ZERO = 1<<7, /* Set HB delay to 0 */
52ccb8e9
FF
717};
718
1da177e4
LT
719struct sctp_paddrparams {
720 sctp_assoc_t spp_assoc_id;
721 struct sockaddr_storage spp_address;
722 __u32 spp_hbinterval;
723 __u16 spp_pathmaxrxt;
52ccb8e9
FF
724 __u32 spp_pathmtu;
725 __u32 spp_sackdelay;
726 __u32 spp_flags;
20c9c825 727} __attribute__((packed, aligned(4)));
1da177e4 728
65b07e5d
VY
729/*
730 * 7.1.18. Add a chunk that must be authenticated (SCTP_AUTH_CHUNK)
731 *
732 * This set option adds a chunk type that the user is requesting to be
733 * received only in an authenticated way. Changes to the list of chunks
734 * will only effect future associations on the socket.
735 */
736struct sctp_authchunk {
737 __u8 sauth_chunk;
738};
739
740/*
741 * 7.1.19. Get or set the list of supported HMAC Identifiers (SCTP_HMAC_IDENT)
742 *
743 * This option gets or sets the list of HMAC algorithms that the local
744 * endpoint requires the peer to use.
1b866434
DB
745 */
746#ifndef __KERNEL__
747/* This here is only used by user space as is. It might not be a good idea
748 * to export/reveal the whole structure with reserved fields etc.
749 */
750enum {
751 SCTP_AUTH_HMAC_ID_SHA1 = 1,
752 SCTP_AUTH_HMAC_ID_SHA256 = 3,
753};
754#endif
755
65b07e5d 756struct sctp_hmacalgo {
7e8616d8 757 __u32 shmac_num_idents;
65b07e5d
VY
758 __u16 shmac_idents[];
759};
760
1b866434
DB
761/* Sadly, user and kernel space have different names for
762 * this structure member, so this is to not break anything.
763 */
764#define shmac_number_of_idents shmac_num_idents
765
65b07e5d
VY
766/*
767 * 7.1.20. Set a shared key (SCTP_AUTH_KEY)
768 *
769 * This option will set a shared secret key which is used to build an
770 * association shared key.
771 */
772struct sctp_authkey {
773 sctp_assoc_t sca_assoc_id;
774 __u16 sca_keynumber;
7e8616d8 775 __u16 sca_keylength;
65b07e5d
VY
776 __u8 sca_key[];
777};
778
779/*
780 * 7.1.21. Get or set the active shared key (SCTP_AUTH_ACTIVE_KEY)
781 *
782 * This option will get or set the active shared key to be used to build
783 * the association shared key.
784 */
785
786struct sctp_authkeyid {
787 sctp_assoc_t scact_assoc_id;
788 __u16 scact_keynumber;
789};
790
791
d364d927
WY
792/*
793 * 7.1.23. Get or set delayed ack timer (SCTP_DELAYED_SACK)
794 *
795 * This option will effect the way delayed acks are performed. This
796 * option allows you to get or set the delayed ack time, in
797 * milliseconds. It also allows changing the delayed ack frequency.
798 * Changing the frequency to 1 disables the delayed sack algorithm. If
799 * the assoc_id is 0, then this sets or gets the endpoints default
800 * values. If the assoc_id field is non-zero, then the set or get
801 * effects the specified association for the one to many model (the
802 * assoc_id field is ignored by the one to one model). Note that if
803 * sack_delay or sack_freq are 0 when setting this option, then the
804 * current values will remain unchanged.
7708610b 805 */
d364d927
WY
806struct sctp_sack_info {
807 sctp_assoc_t sack_assoc_id;
808 uint32_t sack_delay;
809 uint32_t sack_freq;
810};
811
7708610b
FF
812struct sctp_assoc_value {
813 sctp_assoc_t assoc_id;
814 uint32_t assoc_value;
815};
816
1da177e4
LT
817/*
818 * 7.2.2 Peer Address Information
819 *
820 * Applications can retrieve information about a specific peer address
821 * of an association, including its reachability state, congestion
822 * window, and retransmission timer values. This information is
823 * read-only. The following structure is used to access this
824 * information:
825 */
826struct sctp_paddrinfo {
827 sctp_assoc_t spinfo_assoc_id;
828 struct sockaddr_storage spinfo_address;
829 __s32 spinfo_state;
830 __u32 spinfo_cwnd;
831 __u32 spinfo_srtt;
832 __u32 spinfo_rto;
833 __u32 spinfo_mtu;
20c9c825 834} __attribute__((packed, aligned(4)));
1da177e4
LT
835
836/* Peer addresses's state. */
ad8fec17
SS
837/* UNKNOWN: Peer address passed by the upper layer in sendmsg or connect[x]
838 * calls.
839 * UNCONFIRMED: Peer address received in INIT/INIT-ACK address parameters.
840 * Not yet confirmed by a heartbeat and not available for data
841 * transfers.
842 * ACTIVE : Peer address confirmed, active and available for data transfers.
843 * INACTIVE: Peer address inactive and not available for data transfers.
844 */
1da177e4
LT
845enum sctp_spinfo_state {
846 SCTP_INACTIVE,
5aa93bcf 847 SCTP_PF,
1da177e4 848 SCTP_ACTIVE,
ad8fec17 849 SCTP_UNCONFIRMED,
3f7a87d2 850 SCTP_UNKNOWN = 0xffff /* Value used for transport state unknown */
1da177e4
LT
851};
852
853/*
854 * 7.2.1 Association Status (SCTP_STATUS)
855 *
856 * Applications can retrieve current status information about an
857 * association, including association state, peer receiver window size,
858 * number of unacked data chunks, and number of data chunks pending
859 * receipt. This information is read-only. The following structure is
860 * used to access this information:
861 */
862struct sctp_status {
863 sctp_assoc_t sstat_assoc_id;
864 __s32 sstat_state;
865 __u32 sstat_rwnd;
866 __u16 sstat_unackdata;
867 __u16 sstat_penddata;
868 __u16 sstat_instrms;
869 __u16 sstat_outstrms;
870 __u32 sstat_fragmentation_point;
871 struct sctp_paddrinfo sstat_primary;
872};
873
65b07e5d
VY
874/*
875 * 7.2.3. Get the list of chunks the peer requires to be authenticated
876 * (SCTP_PEER_AUTH_CHUNKS)
877 *
878 * This option gets a list of chunks for a specified association that
879 * the peer requires to be received authenticated only.
880 */
881struct sctp_authchunks {
7e8616d8
VY
882 sctp_assoc_t gauth_assoc_id;
883 __u32 gauth_number_of_chunks;
884 uint8_t gauth_chunks[];
65b07e5d
VY
885};
886
1b866434
DB
887/* The broken spelling has been released already in lksctp-tools header,
888 * so don't break anyone, now that it's fixed.
889 */
890#define guth_number_of_chunks gauth_number_of_chunks
891
892/* Association states. */
893enum sctp_sstat_state {
894 SCTP_EMPTY = 0,
895 SCTP_CLOSED = 1,
896 SCTP_COOKIE_WAIT = 2,
897 SCTP_COOKIE_ECHOED = 3,
898 SCTP_ESTABLISHED = 4,
899 SCTP_SHUTDOWN_PENDING = 5,
900 SCTP_SHUTDOWN_SENT = 6,
901 SCTP_SHUTDOWN_RECEIVED = 7,
902 SCTP_SHUTDOWN_ACK_SENT = 8,
903};
904
209ba424
WY
905/*
906 * 8.2.6. Get the Current Identifiers of Associations
907 * (SCTP_GET_ASSOC_ID_LIST)
908 *
909 * This option gets the current list of SCTP association identifiers of
910 * the SCTP associations handled by a one-to-many style socket.
911 */
912struct sctp_assoc_ids {
913 __u32 gaids_number_of_ids;
914 sctp_assoc_t gaids_assoc_id[];
915};
916
1da177e4
LT
917/*
918 * 8.3, 8.5 get all peer/local addresses in an association.
1b866434 919 * This parameter struct is used by SCTP_GET_PEER_ADDRS and
1da177e4 920 * SCTP_GET_LOCAL_ADDRS socket options used internally to implement
1b866434 921 * sctp_getpaddrs() and sctp_getladdrs() API.
1da177e4 922 */