sctpConstants.h   [plain text]


/* @(#) $Header: /tcpdump/master/tcpdump/sctpConstants.h,v 1.4 2003-06-03 23:49:23 guy Exp $ (LBL) */

/* 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

/* 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