Don't use "sizeof" to compute the sizes of various headers - the

[tcpdump] / sctpConstants.h

/* SCTP reference Implementation Copyright (C) 1999 Cisco And Motorola
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * 3. Neither the name of Cisco nor of Motorola may be used
 *    to endorse or promote products derived from this software without
 *    specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 * SUCH DAMAGE.
 *
 * This file is part of the SCTP reference Implementation
 *
 * 
 * Please send any bug reports or fixes you make to one of the following email
 * addresses:
 * 
 * rstewar1@email.mot.com
 * kmorneau@cisco.com
 * qxie1@email.mot.com
 * 
 * Any bugs reported given to us we will try to fix... any fixes shared will
 * be incorperated into the next SCTP release.
 */


#ifndef __sctpConstants_h__
#define __sctpConstants_h__


  /* If you wish to use MD5 instead of SLA uncomment the line
   * below. Why you would like to do this:
   * a) There may be IPR on SHA-1, or so the FIP-180-1 page says,
   * b) MD5 is 3 times faster (has coded here).
   *
   * The disadvantage is, it is thought that MD5 has been
   * cracked... see RFC2104.
   */
/*#define USE_MD5 1*/

/* the SCTP protocol signature 
 * this includes the version number
 * encoded in the last 4 bits of the
 * signature.
 */
#define PROTO_SIGNATURE_A 0x30000000

#define SCTP_VERSION_NUMBER 0x3

#define MAX_TSN 0xffffffff
#define MAX_SEQ 0xffff

/* option:
 * If you comment out the following you will
 * receive the old behavior of obeying cwnd for
 * the fast retransmit algorithm. With this defined
 * a FR happens right away with-out waiting for the
 * flightsize to drop below the cwnd value (which
 * is reduced by the FR to 1/2 the inflight packets).
 */
#define SCTP_IGNORE_CWND_ON_FR 1
/* default max I can burst out after a fast retransmit */
#define SCTP_DEF_MAX_BURST 4

/* Packet transmit states in the sent 
 * field in the SCTP_transmitOnQueue struct
 */
#define SCTP_DATAGRAM_UNSENT            0
#define SCTP_DATAGRAM_SENT              1
#define SCTP_DATAGRAM_RESEND1           2 /* not used */
#define SCTP_DATAGRAM_RESEND2           3 /* not used */
#define SCTP_DATAGRAM_RESEND3           4 /* not used */
#define SCTP_DATAGRAM_RESEND            5
#define SCTP_DATAGRAM_ACKED             10010
#define SCTP_DATAGRAM_INBOUND           10011
#define SCTP_READY_TO_TRANSMIT          10012
#define SCTP_DATAGRAM_MARKED            20010

#define MAX_FSID 64     /* debug 5 ints used for cc dynamic tracking */

/* The valid defines for all message
 * types know to SCTP. 0 is reserved
 */
#define SCTP_MSGTYPE_MASK       0xff

#define SCTP_DATA               0x00
#define SCTP_INITIATION         0x01
#define SCTP_INITIATION_ACK     0x02
#define SCTP_SELECTIVE_ACK      0x03 
#define SCTP_HEARTBEAT_REQUEST  0x04    
#define SCTP_HEARTBEAT_ACK      0x05
#define SCTP_ABORT_ASSOCIATION  0x06
#define SCTP_SHUTDOWN           0x07
#define SCTP_SHUTDOWN_ACK       0x08
#define SCTP_OPERATION_ERR      0x09
#define SCTP_COOKIE_ECHO        0x0a
#define SCTP_COOKIE_ACK         0x0b
#define SCTP_ECN_ECHO           0x0c
#define SCTP_ECN_CWR            0x0d
#define SCTP_SHUTDOWN_COMPLETE  0x0e
#define SCTP_FORWARD_CUM_TSN    0xc0
#define SCTP_RELIABLE_CNTL      0xc1
#define SCTP_RELIABLE_CNTL_ACK  0xc2

/* ABORT and SHUTDOWN COMPLETE FLAG */
#define SCTP_HAD_NO_TCB         0x01

/* Data Chuck Specific Flags */
#define SCTP_DATA_FRAG_MASK     0x03
#define SCTP_DATA_MIDDLE_FRAG   0x00
#define SCTP_DATA_LAST_FRAG     0x01
#define SCTP_DATA_FIRST_FRAG    0x02
#define SCTP_DATA_NOT_FRAG      0x03
#define SCTP_DATA_UNORDERED     0x04

#define SCTP_CRC_ENABLE_BIT     0x01    /* lower bit of reserved */

#define isSCTPControl(a) (a->chunkID != SCTP_DATA)
#define isSCTPData(a) (a->chunkID == SCTP_DATA)

/* sctp parameter types for init/init-ack */

#define SCTP_IPV4_PARAM_TYPE    0x0005
#define SCTP_IPV6_PARAM_TYPE    0x0006
#define SCTP_RESPONDER_COOKIE   0x0007
#define SCTP_UNRECOG_PARAM      0x0008
#define SCTP_COOKIE_PRESERVE    0x0009
#define SCTP_HOSTNAME_VIA_DNS   0x000b
#define SCTP_RESTRICT_ADDR_TO   0x000c

#define SCTP_ECN_I_CAN_DO_ECN   0x8000
#define SCTP_OPERATION_SUCCEED  0x4001
#define SCTP_ERROR_NOT_EXECUTED 0x4002

#define SCTP_UNRELIABLE_STRM    0xc000
#define SCTP_ADD_IP_ADDRESS     0xc001
#define SCTP_DEL_IP_ADDRESS     0xc002
#define SCTP_STRM_FLOW_LIMIT    0xc003
#define SCTP_PARTIAL_CSUM       0xc004
#define SCTP_ERROR_CAUSE_TLV    0xc005
#define SCTP_MIT_STACK_NAME     0xc006
#define SCTP_SETADDRESS_PRIMARY 0xc007

/* bits for TOS field */
#define SCTP_ECT_BIT            0x02
#define SCTP_CE_BIT             0x01

/* error codes */
#define SCTP_OP_ERROR_NO_ERROR          0x0000
#define SCTP_OP_ERROR_INV_STRM          0x0001
#define SCTP_OP_ERROR_MISS_PARAM        0x0002
#define SCTP_OP_ERROR_STALE_COOKIE      0x0003
#define SCTP_OP_ERROR_NO_RESOURCE       0x0004
#define SCTP_OP_ERROR_DNS_FAILED        0x0005
#define SCTP_OP_ERROR_UNK_CHUNK         0x0006
#define SCTP_OP_ERROR_INV_PARAM         0x0007
#define SCTP_OP_ERROR_UNK_PARAM         0x0008
#define SCTP_OP_ERROR_NO_USERD          0x0009
#define SCTP_OP_ERROR_COOKIE_SHUT       0x000a
#define SCTP_OP_ERROR_DELETE_LAST       0x000b
#define SCTP_OP_ERROR_RESOURCE_SHORT    0x000c

#define SCTP_MAX_ERROR_CAUSE  12

/* empty error causes i.e. nothing but the cause
 * are SCTP_OP_ERROR_NO_RESOURCE, SCTP_OP_ERROR_INV_PARAM,
 * SCTP_OP_ERROR_COOKIE_SHUT.
 */

/* parameter for Heart Beat */
#define HEART_BEAT_PARAM 0x0001



/* send options for SCTP
 */
#define SCTP_ORDERED_DELIVERY           0x01
#define SCTP_NON_ORDERED_DELIVERY       0x02
#define SCTP_DO_CRC16                   0x08
#define SCTP_MY_ADDRESS_ONLY            0x10

/* below turns off above */
#define SCTP_FLEXIBLE_ADDRESS           0x20
#define SCTP_NO_HEARTBEAT               0x40

/* mask to get sticky */
#define SCTP_STICKY_OPTIONS_MASK        0x0c

/* MTU discovery flags */
#define SCTP_DONT_FRAGMENT              0x0100
#define SCTP_FRAGMENT_OK                0x0200


/* SCTP state defines for internal state machine */
#define SCTP_STATE_EMPTY                0x0000
#define SCTP_STATE_INUSE                0x0001
#define SCTP_STATE_COOKIE_WAIT          0x0002
#define SCTP_STATE_COOKIE_SENT          0x0004
#define SCTP_STATE_OPEN                 0x0008
#define SCTP_STATE_SHUTDOWN             0x0010
#define SCTP_STATE_SHUTDOWN_RECV        0x0020
#define SCTP_STATE_SHUTDOWN_ACK_SENT    0x0040
#define SCTP_STATE_SHUTDOWN_PEND        0x0080
#define SCTP_STATE_MASK                 0x007f
/* SCTP reachability state for each address */
#define SCTP_ADDR_NOT_REACHABLE         1
#define SCTP_ADDR_REACHABLE             2
#define SCTP_ADDR_NOHB                  4
#define SCTP_ADDR_BEING_DELETED         8

/* How long a cookie lives */
#define SCTP_DEFAULT_COOKIE_LIFE 60 /* seconds */

/* resource limit of streams */
#define MAX_SCTP_STREAMS 2048


/* guess at how big to make the TSN mapping array */
#define SCTP_STARTING_MAPARRAY 10000

/* Here we define the timer types used
 * by the implementation has 
 * arguments in the set/get timer type calls.
 */
#define SCTP_TIMER_INIT         0
#define SCTP_TIMER_RECV         1
#define SCTP_TIMER_SEND         2
#define SCTP_TIMER_SHUTDOWN     3
#define SCTP_TIMER_HEARTBEAT    4
#define SCTP_TIMER_PMTU         5
/* number of timer types in the base SCTP 
 * structure used in the set/get and has
 * the base default.
 */
#define SCTP_NUM_TMRS 6



#define SCTP_IPV4_ADDRESS       2
#define SCTP_IPV6_ADDRESS       4

/* timer types */
#define SctpTimerTypeNone               0
#define SctpTimerTypeSend               1
#define SctpTimerTypeInit               2
#define SctpTimerTypeRecv               3
#define SctpTimerTypeShutdown           4
#define SctpTimerTypeHeartbeat          5
#define SctpTimerTypeCookie             6
#define SctpTimerTypeNewCookie          7
#define SctpTimerTypePathMtuRaise       8
#define SctpTimerTypeShutdownAck        9
#define SctpTimerTypeRelReq             10

/* Here are the timer directives given to the
 * user provided function
 */
#define SCTP_TIMER_START        1
#define SCTP_TIMER_STOP         2

/* running flag states in timer structure */
#define SCTP_TIMER_IDLE         0x0
#define SCTP_TIMER_EXPIRED      0x1
#define SCTP_TIMER_RUNNING      0x2


/* number of simultaneous timers running */
#define SCTP_MAX_NET_TIMERS     6       /* base of where net timers start */
#define SCTP_NUMBER_TIMERS      12      /* allows up to 6 destinations */


/* Of course we really don't collect stale cookies, being
 * folks of decerning taste. However we do count them, if
 * we get to many before the association comes up.. we
 * give up. Below is the constant that dictates when
 * we give it up...this is a implemenation dependant
 * treatment. In ours we do not ask for a extension of
 * time, but just retry this many times...
 */
#define SCTP_MAX_STALE_COOKIES_I_COLLECT 10

/* max number of TSN's dup'd that I will hold */
#define SCTP_MAX_DUP_TSNS      20

/* Here we define the types used when
 * setting the retry ammounts.
 */
/* constants for type of set */
#define SCTP_MAXATTEMPT_INIT 2
#define SCTP_MAXATTEMPT_SEND 3

/* Here we define the default timers and the
 * default number of attemts we make for
 * each respective side (send/init).
 */

/* init timer def = 3sec  */
#define SCTP_INIT_SEC   3
#define SCTP_INIT_NSEC  0

/* send timer def = 3 seconds */
#define SCTP_SEND_SEC   1
#define SCTP_SEND_NSEC  0

/* recv timer def = 200ms (in nsec) */
#define SCTP_RECV_SEC   0
#define SCTP_RECV_NSEC  200000000

/* 30 seconds + RTO */
#define SCTP_HB_SEC     30
#define SCTP_HB_NSEC    0


/* 300 ms */
#define SCTP_SHUTDOWN_SEC       0
#define SCTP_SHUTDOWN_NSEC      300000000

#define SCTP_RTO_UPPER_BOUND 60000000 /* 60 sec in micro-second's */
#define SCTP_RTO_UPPER_BOUND_SEC 60  /* for the init timer */
#define SCTP_RTO_LOWER_BOUND  1000000 /* 1 sec in micro-sec's */

#define SCTP_DEF_MAX_INIT 8
#define SCTP_DEF_MAX_SEND 10

#define SCTP_DEF_PMTU_RAISE 600  /* 10 Minutes between raise attempts */
#define SCTP_DEF_PMTU_MIN   600

#define SCTP_MSEC_IN_A_SEC  1000
#define SCTP_USEC_IN_A_SEC  1000000
#define SCTP_NSEC_IN_A_SEC  1000000000


/* Events that SCTP will look for, these
 * are or'd together to declare what SCTP
 * wants. Each select mask/poll list should be 
 * set for the fd, if the bit is on.
 */
#define SCTP_EVENT_READ         0x000001
#define SCTP_EVENT_WRITE        0x000002
#define SCTP_EVENT_EXCEPT       0x000004

/* The following constant is a value for this
 * particular implemenation. It is quite arbitrary and
 * is used to limit how much data will be queued up to 
 * a sender, waiting for cwnd to be larger than flightSize.
 * All implementations will need this protection is some
 * way due to buffer size constraints.
 */

#define SCTP_MAX_OUTSTANDING_DG 10000



/* This constant (SCTP_MAX_READBUFFER) define 
 * how big the read/write buffer is
 * when we enter the fd event notification 
 * the buffer is put on the stack, so the bigger
 * it is the more stack you chew up, however it
 * has got to be big enough to handle the bigest
 * message this O/S will send you. In solaris
 * with sockets (not TLI) we end up at a value
 * of 64k. In TLI we could do partial reads to
 * get it all in with less hassel.. but we
 * write to sockets for generality.
 */
#define SCTP_MAX_READBUFFER 65536
#define SCTP_ADDRMAX 60

/* amount peer is obligated to have in rwnd or
 * I will abort
 */
#define SCTP_MIN_RWND   1500

#define SCTP_WINDOW_MIN 1500    /* smallest rwnd can be */
#define SCTP_WINDOW_MAX 1048576 /* biggest I can grow rwnd to 
                                 * My playing around suggests a
                                 * value greater than 64k does not
                                 * do much, I guess via the kernel
                                 * limitations on the stream/socket.
                                 */

#define SCTP_MAX_BUNDLE_UP 256  /* max number of chunks I can bundle */

/*  I can handle a 1meg re-assembly */
#define SCTP_DEFAULT_MAXMSGREASM 1048576


#define SCTP_DEFAULT_MAXWINDOW  32768   /* default rwnd size */
#define SCTP_DEFAULT_MAXSEGMENT 1500    /* MTU size, this is the default
                                         * to which we set the smallestMTU
                                         * size to. This governs what is the
                                         * largest size we will use, of course
                                         * PMTU will raise this up to
                                         * the largest interface MTU or the 
                                         * ceiling below if there is no
                                         * SIOCGIFMTU.
                                         */
#ifdef LYNX
#define DEFAULT_MTU_CEILING  1500       /* Since Lynx O/S is brain dead
                                         * in the way it handles the
                                         * raw IP socket, insisting
                                         * on makeing its own IP
                                         * header, we limit the growth
                                         * to that of the e-net size
                                         */
#else
#define DEFAULT_MTU_CEILING  2048       /* If no SIOCGIFMTU, highest value
                                         * to raise the PMTU to, i.e.
                                         * don't try to raise above this
                                         * value. Tune this per your
                                         * largest MTU interface if your
                                         * system does not support the
                                         * SIOCGIFMTU ioctl.
                                         */
#endif
#define SCTP_DEFAULT_MINSEGMENT 512     /* MTU size ... if no mtu disc */
#define SCTP_HOW_MANY_SECRETS 2         /* how many secrets I keep */
/* This is how long a secret lives, NOT how long a cookie lives */
#define SCTP_HOW_LONG_COOKIE_LIVE 3600  /* how many seconds the current secret will live */

#define SCTP_NUMBER_OF_SECRETS  8       /* or 8 * 4 = 32 octets */
#define SCTP_SECRET_SIZE 32             /* number of octets in a 256 bits */

#ifdef USE_MD5
#define SCTP_SIGNATURE_SIZE 16  /* size of a MD5 signature */
#else
#define SCTP_SIGNATURE_SIZE 20  /* size of a SLA-1 signature */
#endif
/* Here are the notification constants
 * that the code and upper layer will get
 */

/* association is up */
#define SCTP_NOTIFY_ASSOC_UP            1

/* association is down */
#define SCTP_NOTIFY_ASSOC_DOWN          2

/* interface on a association is down
 * and out of consideration for selection.
 */
#define SCTP_NOTIFY_INTF_DOWN           3

/* interface on a association is up
 * and now back in consideration for selection.
 */
#define SCTP_NOTIFY_INTF_UP             4

/* The given datagram cannot be delivered
 * to the peer, this will probably be followed
 * by a SCTP_NOTFIY_ASSOC_DOWN.
 */
#define SCTP_NOTIFY_DG_FAIL             5

/* Sent dg on non-open stream extreme code error!
 */
#define SCTP_NOTIFY_STRDATA_ERR         6

#define SCTP_NOTIFY_ASSOC_ABORTED       7

/* The stream ones are not used yet, but could
 * be when a association opens.
 */
#define SCTP_NOTIFY_PEER_OPENED_STR     8
#define SCTP_NOTIFY_STREAM_OPENED_OK    9

/* association sees a restart event */
#define SCTP_NOTIFY_ASSOC_RESTART       10

/* a user requested HB returned */
#define SCTP_NOTIFY_HB_RESP             11

/* a result from a REL-REQ */
#define SCTP_NOTIFY_RELREQ_RESULT_OK            12
#define SCTP_NOTIFY_RELREQ_RESULT_FAILED        13

/* clock variance is 10ms or 10,000 us's */
#define SCTP_CLOCK_GRAINULARITY 10000

#define IP_HDR_SIZE 40          /* we use the size of a IP6 header here
                                 * this detracts a small amount for ipv4
                                 * but it simplifies the ipv6 addition
                                 */

#define SCTP_NUM_FDS 3

/* raw IP filedescriptor */
#define SCTP_FD_IP   0
/* raw ICMP filedescriptor */
#define SCTP_FD_ICMP 1
/* processes contact me for requests here */
#define SCTP_REQUEST 2


#define SCTP_DEAMON_PORT 9899


#ifndef IPPROTO_SCTP
#define IPPROTO_SCTP 132        /* the Official IANA number :-) */
#endif

/* Deamon registration message types/responses */
#define DEAMON_REGISTER       0x01
#define DEAMON_REGISTER_ACK   0x02
#define DEAMON_DEREGISTER     0x03
#define DEAMON_DEREGISTER_ACK 0x04
#define DEAMON_CHECKADDR_LIST 0x05

#define DEAMON_MAGIC_VER_LEN 0xff

/* max times I will attempt to send a message to deamon */
#define SCTP_MAX_ATTEMPTS_AT_DEAMON 5
#define SCTP_TIMEOUT_IN_POLL_FOR_DEAMON 1500 /* 1.5 seconds */

/* modular comparison */
/* True if a > b (mod = M) */
#define compare_with_wrap(a, b, M) ((a > b) && ((a - b) < (M >> 1))) || \
              ((b > a) && ((b - a) > (M >> 1)))

#ifndef TIMEVAL_TO_TIMESPEC
#define TIMEVAL_TO_TIMESPEC(tv, ts)                     \
{                                                       \
    (ts)->tv_sec  = (tv)->tv_sec;                       \
    (ts)->tv_nsec = (tv)->tv_usec * 1000;               \
}    
#endif

/* pegs */
#define SCTP_NUMBER_OF_PEGS 21
/* peg index's */
#define SCTP_PEG_SACKS_SEEN 0
#define SCTP_PEG_SACKS_SENT 1
#define SCTP_PEG_TSNS_SENT  2
#define SCTP_PEG_TSNS_RCVD  3
#define SCTP_DATAGRAMS_SENT 4
#define SCTP_DATAGRAMS_RCVD 5
#define SCTP_RETRANTSN_SENT 6
#define SCTP_DUPTSN_RECVD   7
#define SCTP_HBR_RECV       8
#define SCTP_HBA_RECV       9
#define SCTP_HB_SENT       10
#define SCTP_DATA_DG_SENT  11
#define SCTP_DATA_DG_RECV  12
#define SCTP_TMIT_TIMER    13
#define SCTP_RECV_TIMER    14
#define SCTP_HB_TIMER      15
#define SCTP_FAST_RETRAN   16
#define SCTP_PEG_TSNS_READ 17
#define SCTP_NONE_LFT_TO   18
#define SCTP_NONE_LFT_RWND 19
#define SCTP_NONE_LFT_CWND 20



#endif