1 /*- 2 * Copyright (c) 2001-2006, Cisco Systems, Inc. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions are met: 6 * 7 * a) Redistributions of source code must retain the above copyright notice, 8 * this list of conditions and the following disclaimer. 9 * 10 * b) Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in 12 * the documentation and/or other materials provided with the distribution. 13 * 14 * c) Neither the name of Cisco Systems, Inc. nor the names of its 15 * contributors may be used to endorse or promote products derived 16 * from this software without specific prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 20 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 22 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 28 * THE POSSIBILITY OF SUCH DAMAGE. 29 */ 30 31 /* $KAME: sctp_constants.h,v 1.17 2005/03/06 16:04:17 itojun Exp $ */ 32 33 #include <sys/cdefs.h> 34 __FBSDID("$FreeBSD$"); 35 36 #ifndef __sctp_constants_h__ 37 #define __sctp_constants_h__ 38 39 #if defined(_KERNEL) 40 #include <sys/kernel.h> 41 #endif 42 43 44 #define SCTP_VERSION_STRING "KAME-BSD 1.1" 45 /* #define SCTP_AUDITING_ENABLED 1 used for debug/auditing */ 46 #define SCTP_AUDIT_SIZE 256 47 #define SCTP_STAT_LOG_SIZE 80000 48 49 /* Places that CWND log can happen from */ 50 #define SCTP_CWND_LOG_FROM_FR 1 51 #define SCTP_CWND_LOG_FROM_RTX 2 52 #define SCTP_CWND_LOG_FROM_BRST 3 53 #define SCTP_CWND_LOG_FROM_SS 4 54 #define SCTP_CWND_LOG_FROM_CA 5 55 #define SCTP_CWND_LOG_FROM_SAT 6 56 #define SCTP_BLOCK_LOG_INTO_BLK 7 57 #define SCTP_BLOCK_LOG_OUTOF_BLK 8 58 #define SCTP_BLOCK_LOG_CHECK 9 59 #define SCTP_STR_LOG_FROM_INTO_STRD 10 60 #define SCTP_STR_LOG_FROM_IMMED_DEL 11 61 #define SCTP_STR_LOG_FROM_INSERT_HD 12 62 #define SCTP_STR_LOG_FROM_INSERT_MD 13 63 #define SCTP_STR_LOG_FROM_INSERT_TL 14 64 #define SCTP_STR_LOG_FROM_MARK_TSN 15 65 #define SCTP_STR_LOG_FROM_EXPRS_DEL 16 66 #define SCTP_FR_LOG_BIGGEST_TSNS 17 67 #define SCTP_FR_LOG_STRIKE_TEST 18 68 #define SCTP_FR_LOG_STRIKE_CHUNK 19 69 #define SCTP_FR_T3_TIMEOUT 20 70 #define SCTP_MAP_PREPARE_SLIDE 21 71 #define SCTP_MAP_SLIDE_FROM 22 72 #define SCTP_MAP_SLIDE_RESULT 23 73 #define SCTP_MAP_SLIDE_CLEARED 24 74 #define SCTP_MAP_SLIDE_NONE 25 75 #define SCTP_FR_T3_MARK_TIME 26 76 #define SCTP_FR_T3_MARKED 27 77 #define SCTP_FR_T3_STOPPED 28 78 #define SCTP_FR_MARKED 30 79 #define SCTP_CWND_LOG_NOADV_SS 31 80 #define SCTP_CWND_LOG_NOADV_CA 32 81 #define SCTP_MAX_BURST_APPLIED 33 82 #define SCTP_MAX_IFP_APPLIED 34 83 #define SCTP_MAX_BURST_ERROR_STOP 35 84 #define SCTP_INCREASE_PEER_RWND 36 85 #define SCTP_DECREASE_PEER_RWND 37 86 #define SCTP_SET_PEER_RWND_VIA_SACK 38 87 #define SCTP_LOG_MBCNT_INCREASE 39 88 #define SCTP_LOG_MBCNT_DECREASE 40 89 #define SCTP_LOG_MBCNT_CHKSET 41 90 #define SCTP_LOG_NEW_SACK 42 91 #define SCTP_LOG_TSN_ACKED 43 92 #define SCTP_LOG_TSN_REVOKED 44 93 #define SCTP_LOG_LOCK_TCB 45 94 #define SCTP_LOG_LOCK_INP 46 95 #define SCTP_LOG_LOCK_SOCK 47 96 #define SCTP_LOG_LOCK_SOCKBUF_R 48 97 #define SCTP_LOG_LOCK_SOCKBUF_S 49 98 #define SCTP_LOG_LOCK_CREATE 50 99 #define SCTP_LOG_INITIAL_RTT 51 100 #define SCTP_LOG_RTTVAR 52 101 #define SCTP_LOG_SBALLOC 53 102 #define SCTP_LOG_SBFREE 54 103 #define SCTP_LOG_SBRESULT 55 104 #define SCTP_FR_DUPED 56 105 #define SCTP_FR_MARKED_EARLY 57 106 #define SCTP_FR_CWND_REPORT 58 107 #define SCTP_FR_CWND_REPORT_START 59 108 #define SCTP_FR_CWND_REPORT_STOP 60 109 #define SCTP_CWND_LOG_FROM_SEND 61 110 #define SCTP_CWND_INITIALIZATION 62 111 #define SCTP_CWND_LOG_FROM_T3 63 112 #define SCTP_CWND_LOG_FROM_SACK 64 113 #define SCTP_CWND_LOG_NO_CUMACK 65 114 #define SCTP_CWND_LOG_FROM_RESEND 66 115 #define SCTP_FR_LOG_CHECK_STRIKE 67 116 #define SCTP_SEND_NOW_COMPLETES 68 117 #define SCTP_CWND_LOG_FILL_OUTQ_CALLED 69 118 #define SCTP_CWND_LOG_FILL_OUTQ_FILLS 70 119 #define SCTP_LOG_FREE_SENT 71 120 #define SCTP_NAGLE_APPLIED 72 121 #define SCTP_NAGLE_SKIPPED 73 122 #define SCTP_WAKESND_FROM_SACK 74 123 #define SCTP_WAKESND_FROM_FWDTSN 75 124 #define SCTP_NOWAKE_FROM_SACK 76 125 #define SCTP_CWNDLOG_PRESEND 77 126 #define SCTP_CWNDLOG_ENDSEND 78 127 #define SCTP_AT_END_OF_SACK 79 128 #define SCTP_REASON_FOR_SC 80 129 #define SCTP_BLOCK_LOG_INTO_BLKA 81 130 #define SCTP_ENTER_USER_RECV 82 131 #define SCTP_USER_RECV_SACKS 83 132 #define SCTP_SORECV_BLOCKSA 84 133 #define SCTP_SORECV_BLOCKSB 85 134 #define SCTP_SORECV_DONE 86 135 #define SCTP_SACK_RWND_UPDATE 87 136 #define SCTP_SORECV_ENTER 88 137 #define SCTP_SORECV_ENTERPL 89 138 #define SCTP_MBUF_INPUT 90 139 #define SCTP_MBUF_IALLOC 91 140 #define SCTP_MBUF_IFREE 92 141 #define SCTP_MBUF_ICOPY 93 142 #define SCTP_SORCV_FREECTL 94 143 #define SCTP_SORCV_DOESCPY 95 144 #define SCTP_SORCV_DOESLCK 96 145 #define SCTP_SORCV_DOESADJ 97 146 #define SCTP_SORCV_BOTWHILE 98 147 #define SCTP_SORCV_PASSBF 99 148 #define SCTP_SORCV_ADJD 100 149 #define SCTP_UNKNOWN_MAX 101 150 #define SCTP_RANDY_STUFF 102 151 #define SCTP_RANDY_STUFF1 103 152 #define SCTP_STRMOUT_LOG_ASSIGN 104 153 #define SCTP_STRMOUT_LOG_SEND 105 154 #define SCTP_FLIGHT_LOG_DOWN 106 155 #define SCTP_FLIGHT_LOG_UP 107 156 #define SCTP_LOG_MAX_TYPES 108 157 /* 158 * To turn on various logging, you must first define SCTP_STAT_LOGGING. Then 159 * to get something to log you define one of the logging defines i.e. 160 * 161 * SCTP_CWND_LOGGING SCTP_BLK_LOGGING SCTP_STR_LOGGING SCTP_FR_LOGGING 162 * 163 * Any one or a combination of the logging can be turned on. 164 */ 165 #define SCTP_LOG_EVENT_UNKNOWN 0 166 #define SCTP_LOG_EVENT_CWND 1 167 #define SCTP_LOG_EVENT_BLOCK 2 168 #define SCTP_LOG_EVENT_STRM 3 169 #define SCTP_LOG_EVENT_FR 4 170 #define SCTP_LOG_EVENT_MAP 5 171 #define SCTP_LOG_EVENT_MAXBURST 6 172 #define SCTP_LOG_EVENT_RWND 7 173 #define SCTP_LOG_EVENT_MBCNT 8 174 #define SCTP_LOG_EVENT_SACK 9 175 #define SCTP_LOG_LOCK_EVENT 10 176 #define SCTP_LOG_EVENT_RTT 11 177 #define SCTP_LOG_EVENT_SB 12 178 #define SCTP_LOG_EVENT_NAGLE 13 179 #define SCTP_LOG_EVENT_WAKE 14 180 #define SCTP_LOG_MISC_EVENT 15 181 #define SCTP_LOG_EVENT_CLOSE 16 182 #define SCTP_LOG_EVENT_MBUF 17 183 184 #define SCTP_LOG_MAX_EVENT 18 185 186 #define SCTP_LOCK_UNKNOWN 2 187 188 189 /* number of associations by default for zone allocation */ 190 #define SCTP_MAX_NUM_OF_ASOC 40000 191 /* how many addresses per assoc remote and local */ 192 #define SCTP_SCALE_FOR_ADDR 2 193 194 /* default AUTO_ASCONF mode enable(1)/disable(0) value (sysctl) */ 195 #define SCTP_DEFAULT_AUTO_ASCONF 0 196 197 /* 198 * Theshold for rwnd updates, we have to read (sb_hiwat >> 199 * SCTP_RWND_HIWAT_SHIFT) before we will look to see if we need to send a 200 * window update sack. When we look, we compare the last rwnd we sent vs the 201 * current rwnd. It too must be greater than this value. Using 3 divdes the 202 * hiwat by 8, so for 200k rwnd we need to read 24k. For a 64k rwnd we need 203 * to read 8k. This seems about right.. I hope :-D.. we do set a 204 * min of a MTU on it so if the rwnd is real small we will insist 205 * on a full MTU of 1500 bytes. 206 */ 207 #define SCTP_RWND_HIWAT_SHIFT 3 208 209 /* How much of the rwnd must the 210 * message be taking up to start partial delivery. 211 * We calculate this by shifing the hi_water (recv_win) 212 * left the following .. set to 1, when a message holds 213 * 1/2 the rwnd. If we set it to 2 when a message holds 214 * 1/4 the rwnd...etc.. 215 */ 216 217 #define SCTP_PARTIAL_DELIVERY_SHIFT 1 218 219 /* Minimum number of bytes read by user before we 220 * condsider doing a rwnd update 221 */ 222 #define SCTP_MIN_READ_BEFORE_CONSIDERING 3000 223 224 /* 225 * default HMAC for cookies, etc... use one of the AUTH HMAC id's 226 * SCTP_HMAC is the HMAC_ID to use 227 * SCTP_SIGNATURE_SIZE is the digest length 228 */ 229 #define SCTP_HMAC SCTP_AUTH_HMAC_ID_SHA1 230 #define SCTP_SIGNATURE_SIZE SCTP_AUTH_DIGEST_LEN_SHA1 231 #define SCTP_SIGNATURE_ALOC_SIZE SCTP_SIGNATURE_SIZE 232 233 /* DEFINE HERE WHAT CRC YOU WANT TO USE */ 234 #define SCTP_USECRC_RFC2960 1 235 /* #define SCTP_USECRC_FLETCHER 1 */ 236 /* #define SCTP_USECRC_SSHCRC32 1 */ 237 /* #define SCTP_USECRC_FASTCRC32 1 */ 238 /* #define SCTP_USECRC_CRC32 1 */ 239 /* #define SCTP_USECRC_TCP32 1 */ 240 /* #define SCTP_USECRC_CRC16SMAL 1 */ 241 /* #define SCTP_USECRC_CRC16 1 */ 242 /* #define SCTP_USECRC_MODADLER 1 */ 243 244 #ifndef SCTP_ADLER32_BASE 245 #define SCTP_ADLER32_BASE 65521 246 #endif 247 248 /* 249 * the SCTP protocol signature this includes the version number encoded in 250 * the last 4 bits of the signature. 251 */ 252 #define PROTO_SIGNATURE_A 0x30000000 253 #define SCTP_VERSION_NUMBER 0x3 254 255 #define MAX_TSN 0xffffffff 256 #define MAX_SEQ 0xffff 257 258 /* how many executions every N tick's */ 259 #define SCTP_ITERATOR_MAX_AT_ONCE 20 260 261 /* number of clock ticks between iterator executions */ 262 #define SCTP_ITERATOR_TICKS 1 263 264 /* 265 * option: If you comment out the following you will receive the old behavior 266 * of obeying cwnd for the fast retransmit algorithm. With this defined a FR 267 * happens right away with-out waiting for the flightsize to drop below the 268 * cwnd value (which is reduced by the FR to 1/2 the inflight packets). 269 */ 270 #define SCTP_IGNORE_CWND_ON_FR 1 271 272 /* 273 * Adds implementors guide behavior to only use newest highest update in SACK 274 * gap ack's to figure out if you need to stroke a chunk for FR. 275 */ 276 #define SCTP_NO_FR_UNLESS_SEGMENT_SMALLER 1 277 278 /* default max I can burst out after a fast retransmit */ 279 #define SCTP_DEF_MAX_BURST 4 280 /* IP hdr (20/40) + 12+2+2 (enet) + sctp common 12 */ 281 #define SCTP_FIRST_MBUF_RESV 68 282 /* Packet transmit states in the sent field */ 283 #define SCTP_DATAGRAM_UNSENT 0 284 #define SCTP_DATAGRAM_SENT 1 285 #define SCTP_DATAGRAM_RESEND1 2 /* not used (in code, but may 286 * hit this value) */ 287 #define SCTP_DATAGRAM_RESEND2 3 /* not used (in code, but may 288 * hit this value) */ 289 #define SCTP_DATAGRAM_RESEND 4 290 #define SCTP_DATAGRAM_ACKED 10010 291 #define SCTP_DATAGRAM_INBOUND 10011 292 #define SCTP_READY_TO_TRANSMIT 10012 293 #define SCTP_DATAGRAM_MARKED 20010 294 #define SCTP_FORWARD_TSN_SKIP 30010 295 296 /* chunk output send from locations */ 297 #define SCTP_OUTPUT_FROM_USR_SEND 0 298 #define SCTP_OUTPUT_FROM_T3 1 299 #define SCTP_OUTPUT_FROM_INPUT_ERROR 2 300 #define SCTP_OUTPUT_FROM_CONTROL_PROC 3 301 #define SCTP_OUTPUT_FROM_SACK_TMR 4 302 #define SCTP_OUTPUT_FROM_SHUT_TMR 5 303 #define SCTP_OUTPUT_FROM_HB_TMR 6 304 #define SCTP_OUTPUT_FROM_SHUT_ACK_TMR 7 305 #define SCTP_OUTPUT_FROM_ASCONF_TMR 8 306 #define SCTP_OUTPUT_FROM_STRRST_TMR 9 307 #define SCTP_OUTPUT_FROM_AUTOCLOSE_TMR 10 308 #define SCTP_OUTPUT_FROM_EARLY_FR_TMR 11 309 #define SCTP_OUTPUT_FROM_STRRST_REQ 12 310 #define SCTP_OUTPUT_FROM_USR_RCVD 13 311 #define SCTP_OUTPUT_FROM_COOKIE_ACK 14 312 /* SCTP chunk types are moved sctp.h for application (NAT, FW) use */ 313 314 /* align to 32-bit sizes */ 315 #define SCTP_SIZE32(x) ((((x)+3) >> 2) << 2) 316 317 #define IS_SCTP_CONTROL(a) ((a)->chunk_type != SCTP_DATA) 318 #define IS_SCTP_DATA(a) ((a)->chunk_type == SCTP_DATA) 319 320 321 /* SCTP parameter types */ 322 /*************0x0000 series*************/ 323 #define SCTP_HEARTBEAT_INFO 0x0001 324 #define SCTP_IPV4_ADDRESS 0x0005 325 #define SCTP_IPV6_ADDRESS 0x0006 326 #define SCTP_STATE_COOKIE 0x0007 327 #define SCTP_UNRECOG_PARAM 0x0008 328 #define SCTP_COOKIE_PRESERVE 0x0009 329 #define SCTP_HOSTNAME_ADDRESS 0x000b 330 #define SCTP_SUPPORTED_ADDRTYPE 0x000c 331 332 /* draft-ietf-stewart-strreset-xxx */ 333 #define SCTP_STR_RESET_OUT_REQUEST 0x000d 334 #define SCTP_STR_RESET_IN_REQUEST 0x000e 335 #define SCTP_STR_RESET_TSN_REQUEST 0x000f 336 #define SCTP_STR_RESET_RESPONSE 0x0010 337 338 #define SCTP_MAX_RESET_PARAMS 2 339 #define SCTP_STREAM_RESET_TSN_DELTA 0x1000 340 341 /*************0x4000 series*************/ 342 343 /*************0x8000 series*************/ 344 #define SCTP_ECN_CAPABLE 0x8000 345 /* ECN Nonce: draft-ladha-sctp-ecn-nonce */ 346 #define SCTP_ECN_NONCE_SUPPORTED 0x8001 347 /* draft-ietf-tsvwg-auth-xxx */ 348 #define SCTP_RANDOM 0x8002 349 #define SCTP_CHUNK_LIST 0x8003 350 #define SCTP_HMAC_LIST 0x8004 351 /* 352 * draft-ietf-tsvwg-addip-sctp-xx param=0x8008 len=0xNNNN Byte | Byte | Byte 353 * | Byte Byte | Byte ... 354 * 355 * Where each byte is a chunk type extension supported. For example, to support 356 * all chunks one would have (in hex): 357 * 358 * 80 01 00 09 C0 C1 80 81 82 00 00 00 359 * 360 * Has the parameter. C0 = PR-SCTP (RFC3758) C1, 80 = ASCONF (addip draft) 81 361 * = Packet Drop 82 = Stream Reset 83 = Authentication 362 */ 363 #define SCTP_SUPPORTED_CHUNK_EXT 0x8008 364 365 /*************0xC000 series*************/ 366 #define SCTP_PRSCTP_SUPPORTED 0xc000 367 /* draft-ietf-tsvwg-addip-sctp */ 368 #define SCTP_ADD_IP_ADDRESS 0xc001 369 #define SCTP_DEL_IP_ADDRESS 0xc002 370 #define SCTP_ERROR_CAUSE_IND 0xc003 371 #define SCTP_SET_PRIM_ADDR 0xc004 372 #define SCTP_SUCCESS_REPORT 0xc005 373 #define SCTP_ULP_ADAPTATION 0xc006 374 375 /* Notification error codes */ 376 #define SCTP_NOTIFY_DATAGRAM_UNSENT 0x0001 377 #define SCTP_NOTIFY_DATAGRAM_SENT 0x0002 378 #define SCTP_FAILED_THRESHOLD 0x0004 379 #define SCTP_HEARTBEAT_SUCCESS 0x0008 380 #define SCTP_RESPONSE_TO_USER_REQ 0x000f 381 #define SCTP_INTERNAL_ERROR 0x0010 382 #define SCTP_SHUTDOWN_GUARD_EXPIRES 0x0020 383 #define SCTP_RECEIVED_SACK 0x0040 384 #define SCTP_PEER_FAULTY 0x0080 385 386 /* bits for TOS field */ 387 #define SCTP_ECT0_BIT 0x02 388 #define SCTP_ECT1_BIT 0x01 389 #define SCTP_CE_BITS 0x03 390 391 /* below turns off above */ 392 #define SCTP_FLEXIBLE_ADDRESS 0x20 393 #define SCTP_NO_HEARTBEAT 0x40 394 395 /* mask to get sticky */ 396 #define SCTP_STICKY_OPTIONS_MASK 0x0c 397 398 399 /* Chunk flags */ 400 #define SCTP_WINDOW_PROBE 0x01 401 402 /* 403 * SCTP states for internal state machine XXX (should match "user" values) 404 */ 405 #define SCTP_STATE_EMPTY 0x0000 406 #define SCTP_STATE_INUSE 0x0001 407 #define SCTP_STATE_COOKIE_WAIT 0x0002 408 #define SCTP_STATE_COOKIE_ECHOED 0x0004 409 #define SCTP_STATE_OPEN 0x0008 410 #define SCTP_STATE_SHUTDOWN_SENT 0x0010 411 #define SCTP_STATE_SHUTDOWN_RECEIVED 0x0020 412 #define SCTP_STATE_SHUTDOWN_ACK_SENT 0x0040 413 #define SCTP_STATE_SHUTDOWN_PENDING 0x0080 414 #define SCTP_STATE_CLOSED_SOCKET 0x0100 415 #define SCTP_STATE_ABOUT_TO_BE_FREED 0x0200 416 #define SCTP_STATE_PARTIAL_MSG_LEFT 0x0400 417 #define SCTP_STATE_MASK 0x007f 418 419 #define SCTP_GET_STATE(asoc) ((asoc)->state & SCTP_STATE_MASK) 420 421 /* SCTP reachability state for each address */ 422 #define SCTP_ADDR_REACHABLE 0x001 423 #define SCTP_ADDR_NOT_REACHABLE 0x002 424 #define SCTP_ADDR_NOHB 0x004 425 #define SCTP_ADDR_BEING_DELETED 0x008 426 #define SCTP_ADDR_NOT_IN_ASSOC 0x010 427 #define SCTP_ADDR_WAS_PRIMARY 0x020 428 #define SCTP_ADDR_SWITCH_PRIMARY 0x040 429 #define SCTP_ADDR_OUT_OF_SCOPE 0x080 430 #define SCTP_ADDR_DOUBLE_SWITCH 0x100 431 #define SCTP_ADDR_UNCONFIRMED 0x200 432 433 #define SCTP_REACHABLE_MASK 0x203 434 435 /* bound address types (e.g. valid address types to allow) */ 436 #define SCTP_BOUND_V6 0x01 437 #define SCTP_BOUND_V4 0x02 438 439 /* 440 * what is the default number of mbufs in a chain I allow before switching to 441 * a cluster 442 */ 443 #define SCTP_DEFAULT_MBUFS_IN_CHAIN 5 444 445 /* How long a cookie lives in seconds */ 446 #define SCTP_DEFAULT_COOKIE_LIFE 60 447 448 /* resource limit of streams */ 449 #define MAX_SCTP_STREAMS 2048 450 451 /* Maximum the mapping array will grow to (TSN mapping array) */ 452 #define SCTP_MAPPING_ARRAY 512 453 454 /* size of the inital malloc on the mapping array */ 455 #define SCTP_INITIAL_MAPPING_ARRAY 16 456 /* how much we grow the mapping array each call */ 457 #define SCTP_MAPPING_ARRAY_INCR 32 458 459 /* 460 * Here we define the timer types used by the implementation as arguments in 461 * the set/get timer type calls. 462 */ 463 #define SCTP_TIMER_INIT 0 464 #define SCTP_TIMER_RECV 1 465 #define SCTP_TIMER_SEND 2 466 #define SCTP_TIMER_HEARTBEAT 3 467 #define SCTP_TIMER_PMTU 4 468 #define SCTP_TIMER_MAXSHUTDOWN 5 469 #define SCTP_TIMER_SIGNATURE 6 470 /* 471 * number of timer types in the base SCTP structure used in the set/get and 472 * has the base default. 473 */ 474 #define SCTP_NUM_TMRS 7 475 476 /* timer types */ 477 #define SCTP_TIMER_TYPE_NONE 0 478 #define SCTP_TIMER_TYPE_SEND 1 479 #define SCTP_TIMER_TYPE_INIT 2 480 #define SCTP_TIMER_TYPE_RECV 3 481 #define SCTP_TIMER_TYPE_SHUTDOWN 4 482 #define SCTP_TIMER_TYPE_HEARTBEAT 5 483 #define SCTP_TIMER_TYPE_COOKIE 6 484 #define SCTP_TIMER_TYPE_NEWCOOKIE 7 485 #define SCTP_TIMER_TYPE_PATHMTURAISE 8 486 #define SCTP_TIMER_TYPE_SHUTDOWNACK 9 487 #define SCTP_TIMER_TYPE_ASCONF 10 488 #define SCTP_TIMER_TYPE_SHUTDOWNGUARD 11 489 #define SCTP_TIMER_TYPE_AUTOCLOSE 12 490 #define SCTP_TIMER_TYPE_EVENTWAKE 13 491 #define SCTP_TIMER_TYPE_STRRESET 14 492 #define SCTP_TIMER_TYPE_INPKILL 15 493 #define SCTP_TIMER_TYPE_ITERATOR 16 494 #define SCTP_TIMER_TYPE_EARLYFR 17 495 #define SCTP_TIMER_TYPE_ASOCKILL 18 496 #define SCTP_TIMER_TYPE_ADDR_WQ 19 497 /* add new timers here - and increment LAST */ 498 #define SCTP_TIMER_TYPE_LAST 20 499 500 #define SCTP_IS_TIMER_TYPE_VALID(t) (((t) > SCTP_TIMER_TYPE_NONE) && \ 501 ((t) < SCTP_TIMER_TYPE_LAST)) 502 503 504 505 /* 506 * Number of ticks before the soxwakeup() event that is delayed is sent AFTER 507 * the accept() call 508 */ 509 #define SCTP_EVENTWAKEUP_WAIT_TICKS 3000 510 511 /* 512 * Of course we really don't collect stale cookies, being folks of decerning 513 * taste. However we do count them, if we get too many before the association 514 * comes up.. we give up. Below is the constant that dictates when we give it 515 * up...this is a implemenation dependent treatment. In ours we do not ask 516 * for a extension of time, but just retry this many times... 517 */ 518 #define SCTP_MAX_STALE_COOKIES_I_COLLECT 10 519 520 /* max number of TSN's dup'd that I will hold */ 521 #define SCTP_MAX_DUP_TSNS 20 522 523 /* 524 * Here we define the types used when setting the retry amounts. 525 */ 526 /* constants for type of set */ 527 #define SCTP_MAXATTEMPT_INIT 2 528 #define SCTP_MAXATTEMPT_SEND 3 529 530 /* Maximum TSN's we will summarize in a drop report */ 531 #define SCTP_MAX_DROP_REPORT 16 532 533 /* How many drop re-attempts we make on INIT/COOKIE-ECHO */ 534 #define SCTP_RETRY_DROPPED_THRESH 4 535 536 /* 537 * And the max we will keep a history of in the tcb which MUST be lower than 538 * 256. 539 */ 540 #define SCTP_MAX_DROP_SAVE_REPORT 16 541 542 /* 543 * Here we define the default timers and the default number of attemts we 544 * make for each respective side (send/init). 545 */ 546 547 /* 548 * Maxmium number of chunks a single association can have on it. Note that 549 * this is a squishy number since the count can run over this if the user 550 * sends a large message down .. the fragmented chunks don't count until 551 * AFTER the message is on queue.. it would be the next send that blocks 552 * things. This number will get tuned up at boot in the sctp_init and use the 553 * number of clusters as a base. This way high bandwidth environments will 554 * not get impacted by the lower bandwidth sending a bunch of 1 byte chunks 555 */ 556 #define SCTP_ASOC_MAX_CHUNKS_ON_QUEUE 512 557 558 #define MSEC_TO_TICKS(x) ((hz == 1000) ? x : (((x) * hz) / 1000)) 559 #define TICKS_TO_MSEC(x) ((hz == 1000) ? x : (((x) * 1000) / hz)); 560 561 #define SEC_TO_TICKS(x) ((x) * hz) 562 #define TICKS_TO_SEC(x) ((x) / hz) 563 564 /* 565 * Basically the minimum amount of time before I do a early FR. Making this 566 * value to low will cause duplicate retransmissions. 567 */ 568 #define SCTP_MINFR_MSEC_TIMER 250 569 /* The floor this value is allowed to fall to when starting a timer. */ 570 #define SCTP_MINFR_MSEC_FLOOR 20 571 572 /* init timer def = 1 sec */ 573 #define SCTP_INIT_SEC 1 574 575 /* send timer def = 1 seconds */ 576 #define SCTP_SEND_SEC 1 577 578 /* recv timer def = 200ms */ 579 #define SCTP_RECV_MSEC 200 580 581 /* 30 seconds + RTO (in ms) */ 582 #define SCTP_HB_DEFAULT_MSEC 30000 583 584 /* Max time I will wait for Shutdown to complete */ 585 #define SCTP_DEF_MAX_SHUTDOWN_SEC 180 586 587 588 /* 589 * This is how long a secret lives, NOT how long a cookie lives how many 590 * ticks the current secret will live. 591 */ 592 #define SCTP_DEFAULT_SECRET_LIFE_SEC 3600 593 594 #define SCTP_RTO_UPPER_BOUND (60000) /* 60 sec in ms */ 595 #define SCTP_RTO_UPPER_BOUND_SEC 60 /* for the init timer */ 596 #define SCTP_RTO_LOWER_BOUND (1000) /* 1 sec in ms */ 597 #define SCTP_RTO_INITIAL (3000) /* 3 sec in ms */ 598 599 600 #define SCTP_INP_KILL_TIMEOUT 20/* number of ms to retry kill of inpcb */ 601 #define SCTP_ASOC_KILL_TIMEOUT 10 /* number of ms to retry kill of inpcb */ 602 603 #define SCTP_DEF_MAX_INIT 8 604 #define SCTP_DEF_MAX_SEND 10 605 #define SCTP_DEF_MAX_PATH_RTX 4 606 607 #define SCTP_DEF_PMTU_RAISE_SEC 600 /* 10 min between raise attempts */ 608 #define SCTP_DEF_PMTU_MIN 600 609 610 #define SCTP_MSEC_IN_A_SEC 1000 611 #define SCTP_USEC_IN_A_SEC 1000000 612 #define SCTP_NSEC_IN_A_SEC 1000000000 613 614 #define SCTP_MAX_OUTSTANDING_DG 10000 615 616 /* How many streams I request initally by default */ 617 #define SCTP_OSTREAM_INITIAL 10 618 619 /* 620 * How many smallest_mtu's need to increase before a window update sack is 621 * sent (should be a power of 2). 622 */ 623 #define SCTP_SEG_TO_RWND_UPD 32 624 /* Send window update (incr * this > hiwat). Should be a power of 2 */ 625 #define SCTP_SCALE_OF_RWND_TO_UPD 4 626 #define SCTP_MINIMAL_RWND (4096) /* minimal rwnd */ 627 628 #define SCTP_ADDRMAX 20 629 630 /* SCTP DEBUG Switch parameters */ 631 #define SCTP_DEBUG_TIMER1 0x00000001 632 #define SCTP_DEBUG_TIMER2 0x00000002 633 #define SCTP_DEBUG_TIMER3 0x00000004 634 #define SCTP_DEBUG_TIMER4 0x00000008 635 #define SCTP_DEBUG_OUTPUT1 0x00000010 636 #define SCTP_DEBUG_OUTPUT2 0x00000020 637 #define SCTP_DEBUG_OUTPUT3 0x00000040 638 #define SCTP_DEBUG_OUTPUT4 0x00000080 639 #define SCTP_DEBUG_UTIL1 0x00000100 640 #define SCTP_DEBUG_UTIL2 0x00000200 641 #define SCTP_DEBUG_AUTH1 0x00000400 642 #define SCTP_DEBUG_AUTH2 0x00000800 643 #define SCTP_DEBUG_INPUT1 0x00001000 644 #define SCTP_DEBUG_INPUT2 0x00002000 645 #define SCTP_DEBUG_INPUT3 0x00004000 646 #define SCTP_DEBUG_INPUT4 0x00008000 647 #define SCTP_DEBUG_ASCONF1 0x00010000 648 #define SCTP_DEBUG_ASCONF2 0x00020000 649 #define SCTP_DEBUG_OUTPUT5 0x00040000 650 #define SCTP_DEBUG_XXX 0x00080000 651 #define SCTP_DEBUG_PCB1 0x00100000 652 #define SCTP_DEBUG_PCB2 0x00200000 653 #define SCTP_DEBUG_PCB3 0x00400000 654 #define SCTP_DEBUG_PCB4 0x00800000 655 #define SCTP_DEBUG_INDATA1 0x01000000 656 #define SCTP_DEBUG_INDATA2 0x02000000 657 #define SCTP_DEBUG_INDATA3 0x04000000 658 #define SCTP_DEBUG_INDATA4 0x08000000 659 #define SCTP_DEBUG_USRREQ1 0x10000000 660 #define SCTP_DEBUG_USRREQ2 0x20000000 661 #define SCTP_DEBUG_PEEL1 0x40000000 662 #define SCTP_DEBUG_XXXXX 0x80000000 663 #define SCTP_DEBUG_ALL 0x7ff3ffff 664 #define SCTP_DEBUG_NOISY 0x00040000 665 666 /* What sender needs to see to avoid SWS or we consider peers rwnd 0 */ 667 #define SCTP_SWS_SENDER_DEF 1420 668 669 /* 670 * SWS is scaled to the sb_hiwat of the socket. A value of 2 is hiwat/4, 1 671 * would be hiwat/2 etc. 672 */ 673 /* What receiver needs to see in sockbuf or we tell peer its 1 */ 674 #define SCTP_SWS_RECEIVER_DEF 3000 675 676 #define SCTP_INITIAL_CWND 4380 677 678 /* amount peer is obligated to have in rwnd or I will abort */ 679 #define SCTP_MIN_RWND 1500 680 681 #define SCTP_WINDOW_MIN 1500 /* smallest rwnd can be */ 682 #define SCTP_WINDOW_MAX 1048576 /* biggest I can grow rwnd to My playing 683 * around suggests a value greater than 64k 684 * does not do much, I guess via the kernel 685 * limitations on the stream/socket. */ 686 687 /* I can handle a 1meg re-assembly */ 688 #define SCTP_DEFAULT_MAXMSGREASM 1048576 689 690 #define SCTP_DEFAULT_MAXSEGMENT 65535 691 692 #define DEFAULT_CHUNK_BUFFER 2048 693 #define DEFAULT_PARAM_BUFFER 512 694 695 #define SCTP_DEFAULT_MINSEGMENT 512 /* MTU size ... if no mtu disc */ 696 #define SCTP_HOW_MANY_SECRETS 2 /* how many secrets I keep */ 697 698 #define SCTP_NUMBER_OF_SECRETS 8 /* or 8 * 4 = 32 octets */ 699 #define SCTP_SECRET_SIZE 32 /* number of octets in a 256 bits */ 700 701 702 /* 703 * SCTP upper layer notifications 704 */ 705 #define SCTP_NOTIFY_ASSOC_UP 1 706 #define SCTP_NOTIFY_ASSOC_DOWN 2 707 #define SCTP_NOTIFY_INTERFACE_DOWN 3 708 #define SCTP_NOTIFY_INTERFACE_UP 4 709 #define SCTP_NOTIFY_DG_FAIL 5 710 #define SCTP_NOTIFY_STRDATA_ERR 6 711 #define SCTP_NOTIFY_ASSOC_ABORTED 7 712 #define SCTP_NOTIFY_PEER_OPENED_STREAM 8 713 #define SCTP_NOTIFY_STREAM_OPENED_OK 9 714 #define SCTP_NOTIFY_ASSOC_RESTART 10 715 #define SCTP_NOTIFY_HB_RESP 11 716 #define SCTP_NOTIFY_ASCONF_SUCCESS 12 717 #define SCTP_NOTIFY_ASCONF_FAILED 13 718 #define SCTP_NOTIFY_PEER_SHUTDOWN 14 719 #define SCTP_NOTIFY_ASCONF_ADD_IP 15 720 #define SCTP_NOTIFY_ASCONF_DELETE_IP 16 721 #define SCTP_NOTIFY_ASCONF_SET_PRIMARY 17 722 #define SCTP_NOTIFY_PARTIAL_DELVIERY_INDICATION 18 723 #define SCTP_NOTIFY_ADAPTATION_INDICATION 19 724 /* same as above */ 725 #define SCTP_NOTIFY_ADAPTION_INDICATION 19 726 #define SCTP_NOTIFY_INTERFACE_CONFIRMED 20 727 #define SCTP_NOTIFY_STR_RESET_RECV 21 728 #define SCTP_NOTIFY_STR_RESET_SEND 22 729 #define SCTP_NOTIFY_STR_RESET_FAILED_OUT 23 730 #define SCTP_NOTIFY_STR_RESET_FAILED_IN 24 731 #define SCTP_NOTIFY_AUTH_NEW_KEY 25 732 #define SCTP_NOTIFY_AUTH_KEY_CONFLICT 26 733 #define SCTP_NOTIFY_SPECIAL_SP_FAIL 27 734 #define SCTP_NOTIFY_MAX 27 735 736 /* This is the value for messages that are NOT completely 737 * copied down where we will start to split the message. 738 * So, with our default, we split only if the piece we 739 * want to take will fill up a full MTU (assuming 740 * a 1500 byte MTU). 741 */ 742 #define SCTP_DEFAULT_SPLIT_POINT_MIN 1452 743 744 /* ABORT CODES and other tell-tale location 745 * codes are generated by adding the below 746 * to the instance id. 747 */ 748 749 /* File defines */ 750 #define SCTP_FROM_SCTP_INPUT 0x10000000 751 #define SCTP_FROM_SCTP_PCB 0x20000000 752 #define SCTP_FROM_SCTP_INDATA 0x30000000 753 #define SCTP_FROM_SCTP_TIMER 0x40000000 754 #define SCTP_FROM_SCTP_USRREQ 0x50000000 755 #define SCTP_FROM_SCTPUTIL 0x60000000 756 #define SCTP_FROM_SCTP6_USRREQ 0x70000000 757 #define SCTP_FROM_SCTP_ASCONF 0x80000000 758 #define SCTP_FROM_SCTP_OUTPUT 0x90000000 759 #define SCTP_FROM_SCTP_PEELOFF 0xa0000000 760 761 /* Location ID's */ 762 #define SCTP_LOC_1 0x00000001 763 #define SCTP_LOC_2 0x00000002 764 #define SCTP_LOC_3 0x00000003 765 #define SCTP_LOC_4 0x00000004 766 #define SCTP_LOC_5 0x00000005 767 #define SCTP_LOC_6 0x00000006 768 #define SCTP_LOC_7 0x00000007 769 #define SCTP_LOC_8 0x00000008 770 #define SCTP_LOC_9 0x00000009 771 #define SCTP_LOC_10 0x0000000a 772 #define SCTP_LOC_11 0x0000000b 773 #define SCTP_LOC_12 0x0000000c 774 #define SCTP_LOC_13 0x0000000d 775 #define SCTP_LOC_14 0x0000000e 776 #define SCTP_LOC_15 0x0000000f 777 #define SCTP_LOC_16 0x00000010 778 #define SCTP_LOC_17 0x00000011 779 #define SCTP_LOC_18 0x00000012 780 #define SCTP_LOC_19 0x00000013 781 #define SCTP_LOC_20 0x00000014 782 #define SCTP_LOC_21 0x00000015 783 #define SCTP_LOC_22 0x00000016 784 #define SCTP_LOC_23 0x00000017 785 #define SCTP_LOC_24 0x00000018 786 #define SCTP_LOC_25 0x00000019 787 #define SCTP_LOC_26 0x0000001a 788 #define SCTP_LOC_27 0x0000001b 789 #define SCTP_LOC_28 0x0000001c 790 #define SCTP_LOC_29 0x0000001d 791 #define SCTP_LOC_30 0x0000001e 792 #define SCTP_LOC_31 0x0000001f 793 #define SCTP_LOC_32 0x00000020 794 795 796 /* Free assoc codes */ 797 #define SCTP_NORMAL_PROC 0 798 #define SCTP_PCBFREE_NOFORCE 1 799 #define SCTP_PCBFREE_FORCE 2 800 801 /* From codes for adding addresses */ 802 #define SCTP_ADDR_IS_CONFIRMED 8 803 #define SCTP_ADDR_DYNAMIC_ADDED 6 804 #define SCTP_IN_COOKIE_PROC 100 805 #define SCTP_ALLOC_ASOC 1 806 #define SCTP_LOAD_ADDR_2 2 807 #define SCTP_LOAD_ADDR_3 3 808 #define SCTP_LOAD_ADDR_4 4 809 #define SCTP_LOAD_ADDR_5 5 810 811 #define SCTP_DONOT_SETSCOPE 0 812 #define SCTP_DO_SETSCOPE 1 813 814 815 /* This value determines the default for when 816 * we try to add more on the send queue., if 817 * there is room. This prevents us from cycling 818 * into the copy_resume routine to often if 819 * we have not got enough space to add a decent 820 * enough size message. Note that if we have enough 821 * space to complete the message copy we will always 822 * add to the message, no matter what the size. Its 823 * only when we reach the point that we have some left 824 * to add, there is only room for part of it that we 825 * will use this threshold. Its also a sysctl. 826 */ 827 #define SCTP_DEFAULT_ADD_MORE 1452 828 829 #ifndef SCTP_PCBHASHSIZE 830 /* default number of association hash buckets in each endpoint */ 831 #define SCTP_PCBHASHSIZE 256 832 #endif 833 #ifndef SCTP_TCBHASHSIZE 834 #define SCTP_TCBHASHSIZE 1024 835 #endif 836 837 #ifndef SCTP_CHUNKQUEUE_SCALE 838 #define SCTP_CHUNKQUEUE_SCALE 10 839 #endif 840 841 /* clock variance is 1 ms */ 842 #define SCTP_CLOCK_GRANULARITY 1 843 #define IP_HDR_SIZE 40 /* we use the size of a IP6 header here this 844 * detracts a small amount for ipv4 but it 845 * simplifies the ipv6 addition */ 846 847 #ifndef IPPROTO_SCTP 848 #define IPPROTO_SCTP 132 /* the Official IANA number :-) */ 849 #endif /* !IPPROTO_SCTP */ 850 851 #define SCTP_MAX_DATA_BUNDLING 256 852 #define SCTP_MAX_CONTROL_BUNDLING 20 853 854 /* modular comparison */ 855 /* True if a > b (mod = M) */ 856 #define compare_with_wrap(a, b, M) (((a > b) && ((a - b) < ((M >> 1) + 1))) || \ 857 ((b > a) && ((b - a) > ((M >> 1) + 1)))) 858 859 860 /* Mapping array manipulation routines */ 861 #define SCTP_IS_TSN_PRESENT(arry, gap) ((arry[(gap >> 3)] >> (gap & 0x07)) & 0x01) 862 #define SCTP_SET_TSN_PRESENT(arry, gap) (arry[(gap >> 3)] |= (0x01 << ((gap & 0x07)))) 863 #define SCTP_UNSET_TSN_PRESENT(arry, gap) (arry[(gap >> 3)] &= ((~(0x01 << ((gap & 0x07)))) & 0xff)) 864 865 866 /* 867 * This value defines the number of vtag block time wait entry's per list 868 * element. Each entry will take 2 4 byte ints (and of course the overhead 869 * of the next pointer as well). Using 15 as an example will yield * ((8 * 870 * 15) + 8) or 128 bytes of overhead for each timewait block that gets 871 * initialized. Increasing it to 31 would yeild 256 bytes per block. 872 */ 873 #define SCTP_NUMBER_IN_VTAG_BLOCK 15 874 /* 875 * If we use the STACK option, we have an array of this size head pointers. 876 * This array is mod'd the with the size to find which bucket and then all 877 * entries must be searched to see if the tag is in timed wait. If so we 878 * reject it. 879 */ 880 #define SCTP_STACK_VTAG_HASH_SIZE 31 881 882 /* 883 * If we use the per-endpoint model than we do not have a hash table of 884 * entries but instead have a single head pointer and we must crawl through 885 * the entire list. 886 */ 887 888 /* 889 * Number of seconds of time wait, tied to MSL value (2 minutes), so 2 * MSL 890 * = 4 minutes or 480 seconds. 891 */ 892 #define SCTP_TIME_WAIT 480 893 894 /* The system retains a cache of free chunks such to 895 * cut down on calls the memory allocation system. There 896 * is a per association limit of free items and a overall 897 * system limit. If either one gets hit then the resource 898 * stops being cached. 899 */ 900 901 #define SCTP_DEF_ASOC_RESC_LIMIT 10 902 #define SCTP_DEF_SYSTEM_RESC_LIMIT 1000 903 904 905 906 #define IN4_ISPRIVATE_ADDRESS(a) \ 907 ((((u_char *)&(a)->s_addr)[0] == 10) || \ 908 ((((u_char *)&(a)->s_addr)[0] == 172) && \ 909 (((u_char *)&(a)->s_addr)[1] >= 16) && \ 910 (((u_char *)&(a)->s_addr)[1] <= 32)) || \ 911 ((((u_char *)&(a)->s_addr)[0] == 192) && \ 912 (((u_char *)&(a)->s_addr)[1] == 168))) 913 914 #define IN4_ISLOOPBACK_ADDRESS(a) \ 915 ((((u_char *)&(a)->s_addr)[0] == 127) && \ 916 (((u_char *)&(a)->s_addr)[1] == 0) && \ 917 (((u_char *)&(a)->s_addr)[2] == 0) && \ 918 (((u_char *)&(a)->s_addr)[3] == 1)) 919 920 921 922 923 #if defined(_KERNEL) 924 925 926 #define SCTP_GETTIME_TIMEVAL(x) (getmicrouptime(x)) 927 #define SCTP_GETPTIME_TIMEVAL(x) (microuptime(x)) 928 /*#if defined(__FreeBSD__) || defined(__APPLE__)*/ 929 /*#define SCTP_GETTIME_TIMEVAL(x) { \*/ 930 /* (x)->tv_sec = ticks / 1000; \*/ 931 /* (x)->tv_usec = (ticks % 1000) * 1000; \*/ 932 /*}*/ 933 934 /*#else*/ 935 /*#define SCTP_GETTIME_TIMEVAL(x) (microtime(x))*/ 936 /*#endif __FreeBSD__ */ 937 938 #define sctp_sowwakeup(inp, so) \ 939 do { \ 940 if (inp->sctp_flags & SCTP_PCB_FLAGS_DONT_WAKE) { \ 941 inp->sctp_flags |= SCTP_PCB_FLAGS_WAKEOUTPUT; \ 942 } else { \ 943 sowwakeup(so); \ 944 } \ 945 } while (0) 946 947 #define sctp_sowwakeup_locked(inp, so) \ 948 do { \ 949 if (inp->sctp_flags & SCTP_PCB_FLAGS_DONT_WAKE) { \ 950 SOCKBUF_UNLOCK(&((so)->so_snd)); \ 951 inp->sctp_flags |= SCTP_PCB_FLAGS_WAKEOUTPUT; \ 952 } else { \ 953 sowwakeup_locked(so); \ 954 } \ 955 } while (0) 956 957 #define sctp_sorwakeup(inp, so) \ 958 do { \ 959 if (inp->sctp_flags & SCTP_PCB_FLAGS_DONT_WAKE) { \ 960 inp->sctp_flags |= SCTP_PCB_FLAGS_WAKEINPUT; \ 961 } else { \ 962 sorwakeup(so); \ 963 } \ 964 } while (0) 965 966 /* FIXME */ 967 #define sctp_sorwakeup_locked(inp, so) \ 968 do { \ 969 if (inp->sctp_flags & SCTP_PCB_FLAGS_DONT_WAKE) { \ 970 inp->sctp_flags |= SCTP_PCB_FLAGS_WAKEINPUT; \ 971 SOCKBUF_UNLOCK(&((so)->so_rcv)); \ 972 } else { \ 973 sorwakeup_locked(so); \ 974 } \ 975 } while (0) 976 977 #endif /* _KERNEL */ 978 #endif 979