1/* @(#) Header: /tcpdump/master/tcpdump/sctpConstants.h,v 1.4 2003-06-03 23:49:23 guy Exp (LBL) */ 2 3/* SCTP reference Implementation Copyright (C) 1999 Cisco And Motorola 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 9 * 1. Redistributions of source code must retain the above copyright 10 * notice, this list of conditions and the following disclaimer. 11 * 12 * 2. Redistributions in binary form must reproduce the above copyright 13 * notice, this list of conditions and the following disclaimer in the 14 * documentation and/or other materials provided with the distribution. 15 * 16 * 3. Neither the name of Cisco nor of Motorola may be used 17 * to endorse or promote products derived from this software without 18 * specific prior written permission. 19 * 20 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 21 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 24 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 25 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 26 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 27 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 28 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 29 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 30 * SUCH DAMAGE. 31 * 32 * This file is part of the SCTP reference Implementation 33 * 34 * 35 * Please send any bug reports or fixes you make to one of the following email 36 * addresses: 37 * 38 * rstewar1@email.mot.com 39 * kmorneau@cisco.com 40 * qxie1@email.mot.com 41 * 42 * Any bugs reported given to us we will try to fix... any fixes shared will 43 * be incorperated into the next SCTP release. 44 */ 45 46 47#ifndef __sctpConstants_h__ 48#define __sctpConstants_h__ 49 50 51 /* If you wish to use MD5 instead of SLA uncomment the line 52 * below. Why you would like to do this: 53 * a) There may be IPR on SHA-1, or so the FIP-180-1 page says, 54 * b) MD5 is 3 times faster (has coded here). 55 * 56 * The disadvantage is, it is thought that MD5 has been 57 * cracked... see RFC2104. 58 */ 59/*#define USE_MD5 1*/ 60 61/* the SCTP protocol signature 62 * this includes the version number 63 * encoded in the last 4 bits of the 64 * signature. 65 */ 66#define PROTO_SIGNATURE_A 0x30000000 67 68#define SCTP_VERSION_NUMBER 0x3 69 70#define MAX_TSN 0xffffffff 71#define MAX_SEQ 0xffff 72 73/* option: 74 * If you comment out the following you will 75 * receive the old behavior of obeying cwnd for 76 * the fast retransmit algorithm. With this defined 77 * a FR happens right away with-out waiting for the 78 * flightsize to drop below the cwnd value (which 79 * is reduced by the FR to 1/2 the inflight packets). 80 */ 81#define SCTP_IGNORE_CWND_ON_FR 1 82/* default max I can burst out after a fast retransmit */ 83#define SCTP_DEF_MAX_BURST 4 84 85/* Packet transmit states in the sent 86 * field in the SCTP_transmitOnQueue struct 87 */ 88#define SCTP_DATAGRAM_UNSENT 0 89#define SCTP_DATAGRAM_SENT 1 90#define SCTP_DATAGRAM_RESEND1 2 /* not used */ 91#define SCTP_DATAGRAM_RESEND2 3 /* not used */ 92#define SCTP_DATAGRAM_RESEND3 4 /* not used */ 93#define SCTP_DATAGRAM_RESEND 5 94#define SCTP_DATAGRAM_ACKED 10010 95#define SCTP_DATAGRAM_INBOUND 10011 96#define SCTP_READY_TO_TRANSMIT 10012 97#define SCTP_DATAGRAM_MARKED 20010 98 99#define MAX_FSID 64 /* debug 5 ints used for cc dynamic tracking */ 100 101/* The valid defines for all message 102 * types know to SCTP. 0 is reserved 103 */ 104#define SCTP_MSGTYPE_MASK 0xff 105 106#define SCTP_DATA 0x00 107#define SCTP_INITIATION 0x01 108#define SCTP_INITIATION_ACK 0x02 109#define SCTP_SELECTIVE_ACK 0x03 110#define SCTP_HEARTBEAT_REQUEST 0x04 111#define SCTP_HEARTBEAT_ACK 0x05 112#define SCTP_ABORT_ASSOCIATION 0x06 113#define SCTP_SHUTDOWN 0x07 114#define SCTP_SHUTDOWN_ACK 0x08 115#define SCTP_OPERATION_ERR 0x09 116#define SCTP_COOKIE_ECHO 0x0a 117#define SCTP_COOKIE_ACK 0x0b 118#define SCTP_ECN_ECHO 0x0c 119#define SCTP_ECN_CWR 0x0d 120#define SCTP_SHUTDOWN_COMPLETE 0x0e 121#define SCTP_FORWARD_CUM_TSN 0xc0 122#define SCTP_RELIABLE_CNTL 0xc1 123#define SCTP_RELIABLE_CNTL_ACK 0xc2 124 125/* ABORT and SHUTDOWN COMPLETE FLAG */ 126#define SCTP_HAD_NO_TCB 0x01 127 128/* Data Chuck Specific Flags */ 129#define SCTP_DATA_FRAG_MASK 0x03 130#define SCTP_DATA_MIDDLE_FRAG 0x00 131#define SCTP_DATA_LAST_FRAG 0x01 132#define SCTP_DATA_FIRST_FRAG 0x02 133#define SCTP_DATA_NOT_FRAG 0x03 134#define SCTP_DATA_UNORDERED 0x04 135 136#define SCTP_CRC_ENABLE_BIT 0x01 /* lower bit of reserved */ 137 138#define isSCTPControl(a) (a->chunkID != SCTP_DATA) 139#define isSCTPData(a) (a->chunkID == SCTP_DATA) 140 141/* sctp parameter types for init/init-ack */ 142 143#define SCTP_IPV4_PARAM_TYPE 0x0005 144#define SCTP_IPV6_PARAM_TYPE 0x0006 145#define SCTP_RESPONDER_COOKIE 0x0007 146#define SCTP_UNRECOG_PARAM 0x0008 147#define SCTP_COOKIE_PRESERVE 0x0009 148#define SCTP_HOSTNAME_VIA_DNS 0x000b 149#define SCTP_RESTRICT_ADDR_TO 0x000c 150 151#define SCTP_ECN_I_CAN_DO_ECN 0x8000 152#define SCTP_OPERATION_SUCCEED 0x4001 153#define SCTP_ERROR_NOT_EXECUTED 0x4002 154 155#define SCTP_UNRELIABLE_STRM 0xc000 156#define SCTP_ADD_IP_ADDRESS 0xc001 157#define SCTP_DEL_IP_ADDRESS 0xc002 158#define SCTP_STRM_FLOW_LIMIT 0xc003 159#define SCTP_PARTIAL_CSUM 0xc004 160#define SCTP_ERROR_CAUSE_TLV 0xc005 161#define SCTP_MIT_STACK_NAME 0xc006 162#define SCTP_SETADDRESS_PRIMARY 0xc007 163 164/* bits for TOS field */ 165#define SCTP_ECT_BIT 0x02 166#define SCTP_CE_BIT 0x01 167 168/* error codes */ 169#define SCTP_OP_ERROR_NO_ERROR 0x0000 170#define SCTP_OP_ERROR_INV_STRM 0x0001 171#define SCTP_OP_ERROR_MISS_PARAM 0x0002 172#define SCTP_OP_ERROR_STALE_COOKIE 0x0003 173#define SCTP_OP_ERROR_NO_RESOURCE 0x0004 174#define SCTP_OP_ERROR_DNS_FAILED 0x0005 175#define SCTP_OP_ERROR_UNK_CHUNK 0x0006 176#define SCTP_OP_ERROR_INV_PARAM 0x0007 177#define SCTP_OP_ERROR_UNK_PARAM 0x0008 178#define SCTP_OP_ERROR_NO_USERD 0x0009 179#define SCTP_OP_ERROR_COOKIE_SHUT 0x000a 180#define SCTP_OP_ERROR_DELETE_LAST 0x000b 181#define SCTP_OP_ERROR_RESOURCE_SHORT 0x000c 182 183#define SCTP_MAX_ERROR_CAUSE 12 184 185/* empty error causes i.e. nothing but the cause 186 * are SCTP_OP_ERROR_NO_RESOURCE, SCTP_OP_ERROR_INV_PARAM, 187 * SCTP_OP_ERROR_COOKIE_SHUT. 188 */ 189 190/* parameter for Heart Beat */ 191#define HEART_BEAT_PARAM 0x0001 192 193 194 195/* send options for SCTP 196 */ 197#define SCTP_ORDERED_DELIVERY 0x01 198#define SCTP_NON_ORDERED_DELIVERY 0x02 199#define SCTP_DO_CRC16 0x08 200#define SCTP_MY_ADDRESS_ONLY 0x10 201 202/* below turns off above */ 203#define SCTP_FLEXIBLE_ADDRESS 0x20 204#define SCTP_NO_HEARTBEAT 0x40 205 206/* mask to get sticky */ 207#define SCTP_STICKY_OPTIONS_MASK 0x0c 208 209/* MTU discovery flags */ 210#define SCTP_DONT_FRAGMENT 0x0100 211#define SCTP_FRAGMENT_OK 0x0200 212 213 214/* SCTP state defines for internal state machine */ 215#define SCTP_STATE_EMPTY 0x0000 216#define SCTP_STATE_INUSE 0x0001 217#define SCTP_STATE_COOKIE_WAIT 0x0002 218#define SCTP_STATE_COOKIE_SENT 0x0004 219#define SCTP_STATE_OPEN 0x0008 220#define SCTP_STATE_SHUTDOWN 0x0010 221#define SCTP_STATE_SHUTDOWN_RECV 0x0020 222#define SCTP_STATE_SHUTDOWN_ACK_SENT 0x0040 223#define SCTP_STATE_SHUTDOWN_PEND 0x0080 224#define SCTP_STATE_MASK 0x007f 225/* SCTP reachability state for each address */ 226#define SCTP_ADDR_NOT_REACHABLE 1 227#define SCTP_ADDR_REACHABLE 2 228#define SCTP_ADDR_NOHB 4 229#define SCTP_ADDR_BEING_DELETED 8 230 231/* How long a cookie lives */ 232#define SCTP_DEFAULT_COOKIE_LIFE 60 /* seconds */ 233 234/* resource limit of streams */ 235#define MAX_SCTP_STREAMS 2048 236 237 238/* guess at how big to make the TSN mapping array */ 239#define SCTP_STARTING_MAPARRAY 10000 240 241/* Here we define the timer types used 242 * by the implementation has 243 * arguments in the set/get timer type calls. 244 */ 245#define SCTP_TIMER_INIT 0 246#define SCTP_TIMER_RECV 1 247#define SCTP_TIMER_SEND 2 248#define SCTP_TIMER_SHUTDOWN 3 249#define SCTP_TIMER_HEARTBEAT 4 250#define SCTP_TIMER_PMTU 5 251/* number of timer types in the base SCTP 252 * structure used in the set/get and has 253 * the base default. 254 */ 255#define SCTP_NUM_TMRS 6 256 257 258 259#define SCTP_IPV4_ADDRESS 2 260#define SCTP_IPV6_ADDRESS 4 261 262/* timer types */ 263#define SctpTimerTypeNone 0 264#define SctpTimerTypeSend 1 265#define SctpTimerTypeInit 2 266#define SctpTimerTypeRecv 3 267#define SctpTimerTypeShutdown 4 268#define SctpTimerTypeHeartbeat 5 269#define SctpTimerTypeCookie 6 270#define SctpTimerTypeNewCookie 7 271#define SctpTimerTypePathMtuRaise 8 272#define SctpTimerTypeShutdownAck 9 273#define SctpTimerTypeRelReq 10 274 275/* Here are the timer directives given to the 276 * user provided function 277 */ 278#define SCTP_TIMER_START 1 279#define SCTP_TIMER_STOP 2 280 281/* running flag states in timer structure */ 282#define SCTP_TIMER_IDLE 0x0 283#define SCTP_TIMER_EXPIRED 0x1 284#define SCTP_TIMER_RUNNING 0x2 285 286 287/* number of simultaneous timers running */ 288#define SCTP_MAX_NET_TIMERS 6 /* base of where net timers start */ 289#define SCTP_NUMBER_TIMERS 12 /* allows up to 6 destinations */ 290 291 292/* Of course we really don't collect stale cookies, being 293 * folks of decerning taste. However we do count them, if 294 * we get to many before the association comes up.. we 295 * give up. Below is the constant that dictates when 296 * we give it up...this is a implemenation dependant 297 * treatment. In ours we do not ask for a extension of 298 * time, but just retry this many times... 299 */ 300#define SCTP_MAX_STALE_COOKIES_I_COLLECT 10 301 302/* max number of TSN's dup'd that I will hold */ 303#define SCTP_MAX_DUP_TSNS 20 304 305/* Here we define the types used when 306 * setting the retry ammounts. 307 */ 308/* constants for type of set */ 309#define SCTP_MAXATTEMPT_INIT 2 310#define SCTP_MAXATTEMPT_SEND 3 311 312/* Here we define the default timers and the 313 * default number of attemts we make for 314 * each respective side (send/init). 315 */ 316 317/* init timer def = 3sec */ 318#define SCTP_INIT_SEC 3 319#define SCTP_INIT_NSEC 0 320 321/* send timer def = 3 seconds */ 322#define SCTP_SEND_SEC 1 323#define SCTP_SEND_NSEC 0 324 325/* recv timer def = 200ms (in nsec) */ 326#define SCTP_RECV_SEC 0 327#define SCTP_RECV_NSEC 200000000 328 329/* 30 seconds + RTO */ 330#define SCTP_HB_SEC 30 331#define SCTP_HB_NSEC 0 332 333 334/* 300 ms */ 335#define SCTP_SHUTDOWN_SEC 0 336#define SCTP_SHUTDOWN_NSEC 300000000 337 338#define SCTP_RTO_UPPER_BOUND 60000000 /* 60 sec in micro-second's */ 339#define SCTP_RTO_UPPER_BOUND_SEC 60 /* for the init timer */ 340#define SCTP_RTO_LOWER_BOUND 1000000 /* 1 sec in micro-sec's */ 341 342#define SCTP_DEF_MAX_INIT 8 343#define SCTP_DEF_MAX_SEND 10 344 345#define SCTP_DEF_PMTU_RAISE 600 /* 10 Minutes between raise attempts */ 346#define SCTP_DEF_PMTU_MIN 600 347 348#define SCTP_MSEC_IN_A_SEC 1000 349#define SCTP_USEC_IN_A_SEC 1000000 350#define SCTP_NSEC_IN_A_SEC 1000000000 351 352 353/* Events that SCTP will look for, these 354 * are or'd together to declare what SCTP 355 * wants. Each select mask/poll list should be 356 * set for the fd, if the bit is on. 357 */ 358#define SCTP_EVENT_READ 0x000001 359#define SCTP_EVENT_WRITE 0x000002 360#define SCTP_EVENT_EXCEPT 0x000004 361 362/* The following constant is a value for this 363 * particular implemenation. It is quite arbitrary and 364 * is used to limit how much data will be queued up to 365 * a sender, waiting for cwnd to be larger than flightSize. 366 * All implementations will need this protection is some 367 * way due to buffer size constraints. 368 */ 369 370#define SCTP_MAX_OUTSTANDING_DG 10000 371 372 373 374/* This constant (SCTP_MAX_READBUFFER) define 375 * how big the read/write buffer is 376 * when we enter the fd event notification 377 * the buffer is put on the stack, so the bigger 378 * it is the more stack you chew up, however it 379 * has got to be big enough to handle the bigest 380 * message this O/S will send you. In solaris 381 * with sockets (not TLI) we end up at a value 382 * of 64k. In TLI we could do partial reads to 383 * get it all in with less hassel.. but we 384 * write to sockets for generality. 385 */ 386#define SCTP_MAX_READBUFFER 65536 387#define SCTP_ADDRMAX 60 388 389/* amount peer is obligated to have in rwnd or 390 * I will abort 391 */ 392#define SCTP_MIN_RWND 1500 393 394#define SCTP_WINDOW_MIN 1500 /* smallest rwnd can be */ 395#define SCTP_WINDOW_MAX 1048576 /* biggest I can grow rwnd to 396 * My playing around suggests a 397 * value greater than 64k does not 398 * do much, I guess via the kernel 399 * limitations on the stream/socket. 400 */ 401 402#define SCTP_MAX_BUNDLE_UP 256 /* max number of chunks I can bundle */ 403 404/* I can handle a 1meg re-assembly */ 405#define SCTP_DEFAULT_MAXMSGREASM 1048576 406 407 408#define SCTP_DEFAULT_MAXWINDOW 32768 /* default rwnd size */ 409#define SCTP_DEFAULT_MAXSEGMENT 1500 /* MTU size, this is the default 410 * to which we set the smallestMTU 411 * size to. This governs what is the 412 * largest size we will use, of course 413 * PMTU will raise this up to 414 * the largest interface MTU or the 415 * ceiling below if there is no 416 * SIOCGIFMTU. 417 */ 418#ifdef LYNX 419#define DEFAULT_MTU_CEILING 1500 /* Since Lynx O/S is brain dead 420 * in the way it handles the 421 * raw IP socket, insisting 422 * on makeing its own IP 423 * header, we limit the growth 424 * to that of the e-net size 425 */ 426#else 427#define DEFAULT_MTU_CEILING 2048 /* If no SIOCGIFMTU, highest value 428 * to raise the PMTU to, i.e. 429 * don't try to raise above this 430 * value. Tune this per your 431 * largest MTU interface if your 432 * system does not support the 433 * SIOCGIFMTU ioctl. 434 */ 435#endif 436#define SCTP_DEFAULT_MINSEGMENT 512 /* MTU size ... if no mtu disc */ 437#define SCTP_HOW_MANY_SECRETS 2 /* how many secrets I keep */ 438/* This is how long a secret lives, NOT how long a cookie lives */ 439#define SCTP_HOW_LONG_COOKIE_LIVE 3600 /* how many seconds the current secret will live */ 440 441#define SCTP_NUMBER_OF_SECRETS 8 /* or 8 * 4 = 32 octets */ 442#define SCTP_SECRET_SIZE 32 /* number of octets in a 256 bits */ 443 444#ifdef USE_MD5 445#define SCTP_SIGNATURE_SIZE 16 /* size of a MD5 signature */ 446#else 447#define SCTP_SIGNATURE_SIZE 20 /* size of a SLA-1 signature */ 448#endif 449/* Here are the notification constants 450 * that the code and upper layer will get 451 */ 452 453/* association is up */ 454#define SCTP_NOTIFY_ASSOC_UP 1 455 456/* association is down */ 457#define SCTP_NOTIFY_ASSOC_DOWN 2 458 459/* interface on a association is down 460 * and out of consideration for selection. 461 */ 462#define SCTP_NOTIFY_INTF_DOWN 3 463 464/* interface on a association is up 465 * and now back in consideration for selection. 466 */ 467#define SCTP_NOTIFY_INTF_UP 4 468 469/* The given datagram cannot be delivered 470 * to the peer, this will probably be followed 471 * by a SCTP_NOTFIY_ASSOC_DOWN. 472 */ 473#define SCTP_NOTIFY_DG_FAIL 5 474 475/* Sent dg on non-open stream extreme code error! 476 */ 477#define SCTP_NOTIFY_STRDATA_ERR 6 478 479#define SCTP_NOTIFY_ASSOC_ABORTED 7 480 481/* The stream ones are not used yet, but could 482 * be when a association opens. 483 */ 484#define SCTP_NOTIFY_PEER_OPENED_STR 8 485#define SCTP_NOTIFY_STREAM_OPENED_OK 9 486 487/* association sees a restart event */ 488#define SCTP_NOTIFY_ASSOC_RESTART 10 489 490/* a user requested HB returned */ 491#define SCTP_NOTIFY_HB_RESP 11 492 493/* a result from a REL-REQ */ 494#define SCTP_NOTIFY_RELREQ_RESULT_OK 12 495#define SCTP_NOTIFY_RELREQ_RESULT_FAILED 13 496 497/* clock variance is 10ms or 10,000 us's */ 498#define SCTP_CLOCK_GRAINULARITY 10000 499 500#define IP_HDR_SIZE 40 /* we use the size of a IP6 header here 501 * this detracts a small amount for ipv4 502 * but it simplifies the ipv6 addition 503 */ 504 505#define SCTP_NUM_FDS 3 506 507/* raw IP filedescriptor */ 508#define SCTP_FD_IP 0 509/* raw ICMP filedescriptor */ 510#define SCTP_FD_ICMP 1 511/* processes contact me for requests here */ 512#define SCTP_REQUEST 2 513 514 515#define SCTP_DEAMON_PORT 9899 516 517/* Deamon registration message types/responses */ 518#define DEAMON_REGISTER 0x01 519#define DEAMON_REGISTER_ACK 0x02 520#define DEAMON_DEREGISTER 0x03 521#define DEAMON_DEREGISTER_ACK 0x04 522#define DEAMON_CHECKADDR_LIST 0x05 523 524#define DEAMON_MAGIC_VER_LEN 0xff 525 526/* max times I will attempt to send a message to deamon */ 527#define SCTP_MAX_ATTEMPTS_AT_DEAMON 5 528#define SCTP_TIMEOUT_IN_POLL_FOR_DEAMON 1500 /* 1.5 seconds */ 529 530/* modular comparison */ 531/* True if a > b (mod = M) */ 532#define compare_with_wrap(a, b, M) ((a > b) && ((a - b) < (M >> 1))) || \ 533 ((b > a) && ((b - a) > (M >> 1))) 534 535#ifndef TIMEVAL_TO_TIMESPEC 536#define TIMEVAL_TO_TIMESPEC(tv, ts) \ 537{ \ 538 (ts)->tv_sec = (tv)->tv_sec; \ 539 (ts)->tv_nsec = (tv)->tv_usec * 1000; \ 540} 541#endif 542 543/* pegs */ 544#define SCTP_NUMBER_OF_PEGS 21 545/* peg index's */ 546#define SCTP_PEG_SACKS_SEEN 0 547#define SCTP_PEG_SACKS_SENT 1 548#define SCTP_PEG_TSNS_SENT 2 549#define SCTP_PEG_TSNS_RCVD 3 550#define SCTP_DATAGRAMS_SENT 4 551#define SCTP_DATAGRAMS_RCVD 5 552#define SCTP_RETRANTSN_SENT 6 553#define SCTP_DUPTSN_RECVD 7 554#define SCTP_HBR_RECV 8 555#define SCTP_HBA_RECV 9 556#define SCTP_HB_SENT 10 557#define SCTP_DATA_DG_SENT 11 558#define SCTP_DATA_DG_RECV 12 559#define SCTP_TMIT_TIMER 13 560#define SCTP_RECV_TIMER 14 561#define SCTP_HB_TIMER 15 562#define SCTP_FAST_RETRAN 16 563#define SCTP_PEG_TSNS_READ 17 564#define SCTP_NONE_LFT_TO 18 565#define SCTP_NONE_LFT_RWND 19 566#define SCTP_NONE_LFT_CWND 20 567 568 569 570#endif 571 572