dtls1.h 8.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272
  1. /* ssl/dtls1.h */
  2. /*
  3. * DTLS implementation written by Nagendra Modadugu
  4. * ([email protected]) for the OpenSSL project 2005.
  5. */
  6. /* ====================================================================
  7. * Copyright (c) 1999-2005 The OpenSSL Project. All rights reserved.
  8. *
  9. * Redistribution and use in source and binary forms, with or without
  10. * modification, are permitted provided that the following conditions
  11. * are met:
  12. *
  13. * 1. Redistributions of source code must retain the above copyright
  14. * notice, this list of conditions and the following disclaimer.
  15. *
  16. * 2. Redistributions in binary form must reproduce the above copyright
  17. * notice, this list of conditions and the following disclaimer in
  18. * the documentation and/or other materials provided with the
  19. * distribution.
  20. *
  21. * 3. All advertising materials mentioning features or use of this
  22. * software must display the following acknowledgment:
  23. * "This product includes software developed by the OpenSSL Project
  24. * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
  25. *
  26. * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  27. * endorse or promote products derived from this software without
  28. * prior written permission. For written permission, please contact
  29. * [email protected].
  30. *
  31. * 5. Products derived from this software may not be called "OpenSSL"
  32. * nor may "OpenSSL" appear in their names without prior written
  33. * permission of the OpenSSL Project.
  34. *
  35. * 6. Redistributions of any form whatsoever must retain the following
  36. * acknowledgment:
  37. * "This product includes software developed by the OpenSSL Project
  38. * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
  39. *
  40. * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  41. * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  42. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  43. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
  44. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  45. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  46. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  47. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  48. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  49. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  50. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  51. * OF THE POSSIBILITY OF SUCH DAMAGE.
  52. * ====================================================================
  53. *
  54. * This product includes cryptographic software written by Eric Young
  55. * ([email protected]). This product includes software written by Tim
  56. * Hudson ([email protected]).
  57. *
  58. */
  59. #ifndef HEADER_DTLS1_H
  60. # define HEADER_DTLS1_H
  61. # include <openssl/buffer.h>
  62. # include <openssl/pqueue.h>
  63. # ifdef OPENSSL_SYS_VMS
  64. # include <resource.h>
  65. # include <sys/timeb.h>
  66. # endif
  67. # ifdef OPENSSL_SYS_WIN32
  68. /* Needed for struct timeval */
  69. # include <winsock.h>
  70. # elif defined(OPENSSL_SYS_NETWARE) && !defined(_WINSOCK2API_)
  71. # include <sys/timeval.h>
  72. # else
  73. # if defined(OPENSSL_SYS_VXWORKS)
  74. # include <sys/times.h>
  75. # else
  76. # include <sys/time.h>
  77. # endif
  78. # endif
  79. #ifdef __cplusplus
  80. extern "C" {
  81. #endif
  82. # define DTLS1_VERSION 0xFEFF
  83. # define DTLS1_2_VERSION 0xFEFD
  84. # define DTLS_MAX_VERSION DTLS1_2_VERSION
  85. # define DTLS1_VERSION_MAJOR 0xFE
  86. # define DTLS1_BAD_VER 0x0100
  87. /* Special value for method supporting multiple versions */
  88. # define DTLS_ANY_VERSION 0x1FFFF
  89. # if 0
  90. /* this alert description is not specified anywhere... */
  91. # define DTLS1_AD_MISSING_HANDSHAKE_MESSAGE 110
  92. # endif
  93. /* lengths of messages */
  94. # define DTLS1_COOKIE_LENGTH 256
  95. # define DTLS1_RT_HEADER_LENGTH 13
  96. # define DTLS1_HM_HEADER_LENGTH 12
  97. # define DTLS1_HM_BAD_FRAGMENT -2
  98. # define DTLS1_HM_FRAGMENT_RETRY -3
  99. # define DTLS1_CCS_HEADER_LENGTH 1
  100. # ifdef DTLS1_AD_MISSING_HANDSHAKE_MESSAGE
  101. # define DTLS1_AL_HEADER_LENGTH 7
  102. # else
  103. # define DTLS1_AL_HEADER_LENGTH 2
  104. # endif
  105. # ifndef OPENSSL_NO_SSL_INTERN
  106. # ifndef OPENSSL_NO_SCTP
  107. # define DTLS1_SCTP_AUTH_LABEL "EXPORTER_DTLS_OVER_SCTP"
  108. # endif
  109. /* Max MTU overhead we know about so far is 40 for IPv6 + 8 for UDP */
  110. # define DTLS1_MAX_MTU_OVERHEAD 48
  111. typedef struct dtls1_bitmap_st {
  112. unsigned long map; /* track 32 packets on 32-bit systems and 64
  113. * - on 64-bit systems */
  114. unsigned char max_seq_num[8]; /* max record number seen so far, 64-bit
  115. * value in big-endian encoding */
  116. } DTLS1_BITMAP;
  117. struct dtls1_retransmit_state {
  118. EVP_CIPHER_CTX *enc_write_ctx; /* cryptographic state */
  119. EVP_MD_CTX *write_hash; /* used for mac generation */
  120. # ifndef OPENSSL_NO_COMP
  121. COMP_CTX *compress; /* compression */
  122. # else
  123. char *compress;
  124. # endif
  125. SSL_SESSION *session;
  126. unsigned short epoch;
  127. };
  128. struct hm_header_st {
  129. unsigned char type;
  130. unsigned long msg_len;
  131. unsigned short seq;
  132. unsigned long frag_off;
  133. unsigned long frag_len;
  134. unsigned int is_ccs;
  135. struct dtls1_retransmit_state saved_retransmit_state;
  136. };
  137. struct ccs_header_st {
  138. unsigned char type;
  139. unsigned short seq;
  140. };
  141. struct dtls1_timeout_st {
  142. /* Number of read timeouts so far */
  143. unsigned int read_timeouts;
  144. /* Number of write timeouts so far */
  145. unsigned int write_timeouts;
  146. /* Number of alerts received so far */
  147. unsigned int num_alerts;
  148. };
  149. typedef struct record_pqueue_st {
  150. unsigned short epoch;
  151. pqueue q;
  152. } record_pqueue;
  153. typedef struct hm_fragment_st {
  154. struct hm_header_st msg_header;
  155. unsigned char *fragment;
  156. unsigned char *reassembly;
  157. } hm_fragment;
  158. typedef struct dtls1_state_st {
  159. unsigned int send_cookie;
  160. unsigned char cookie[DTLS1_COOKIE_LENGTH];
  161. unsigned char rcvd_cookie[DTLS1_COOKIE_LENGTH];
  162. unsigned int cookie_len;
  163. /*
  164. * The current data and handshake epoch. This is initially
  165. * undefined, and starts at zero once the initial handshake is
  166. * completed
  167. */
  168. unsigned short r_epoch;
  169. unsigned short w_epoch;
  170. /* records being received in the current epoch */
  171. DTLS1_BITMAP bitmap;
  172. /* renegotiation starts a new set of sequence numbers */
  173. DTLS1_BITMAP next_bitmap;
  174. /* handshake message numbers */
  175. unsigned short handshake_write_seq;
  176. unsigned short next_handshake_write_seq;
  177. unsigned short handshake_read_seq;
  178. /* save last sequence number for retransmissions */
  179. unsigned char last_write_sequence[8];
  180. /* Received handshake records (processed and unprocessed) */
  181. record_pqueue unprocessed_rcds;
  182. record_pqueue processed_rcds;
  183. /* Buffered handshake messages */
  184. pqueue buffered_messages;
  185. /* Buffered (sent) handshake records */
  186. pqueue sent_messages;
  187. /*
  188. * Buffered application records. Only for records between CCS and
  189. * Finished to prevent either protocol violation or unnecessary message
  190. * loss.
  191. */
  192. record_pqueue buffered_app_data;
  193. /* Is set when listening for new connections with dtls1_listen() */
  194. unsigned int listen;
  195. unsigned int link_mtu; /* max on-the-wire DTLS packet size */
  196. unsigned int mtu; /* max DTLS packet size */
  197. struct hm_header_st w_msg_hdr;
  198. struct hm_header_st r_msg_hdr;
  199. struct dtls1_timeout_st timeout;
  200. /*
  201. * Indicates when the last handshake msg or heartbeat sent will timeout
  202. */
  203. struct timeval next_timeout;
  204. /* Timeout duration */
  205. unsigned short timeout_duration;
  206. /*
  207. * storage for Alert/Handshake protocol data received but not yet
  208. * processed by ssl3_read_bytes:
  209. */
  210. unsigned char alert_fragment[DTLS1_AL_HEADER_LENGTH];
  211. unsigned int alert_fragment_len;
  212. unsigned char handshake_fragment[DTLS1_HM_HEADER_LENGTH];
  213. unsigned int handshake_fragment_len;
  214. unsigned int retransmitting;
  215. /*
  216. * Set when the handshake is ready to process peer's ChangeCipherSpec message.
  217. * Cleared after the message has been processed.
  218. */
  219. unsigned int change_cipher_spec_ok;
  220. # ifndef OPENSSL_NO_SCTP
  221. /* used when SSL_ST_XX_FLUSH is entered */
  222. int next_state;
  223. int shutdown_received;
  224. # endif
  225. } DTLS1_STATE;
  226. typedef struct dtls1_record_data_st {
  227. unsigned char *packet;
  228. unsigned int packet_length;
  229. SSL3_BUFFER rbuf;
  230. SSL3_RECORD rrec;
  231. # ifndef OPENSSL_NO_SCTP
  232. struct bio_dgram_sctp_rcvinfo recordinfo;
  233. # endif
  234. } DTLS1_RECORD_DATA;
  235. # endif
  236. /* Timeout multipliers (timeout slice is defined in apps/timeouts.h */
  237. # define DTLS1_TMO_READ_COUNT 2
  238. # define DTLS1_TMO_WRITE_COUNT 2
  239. # define DTLS1_TMO_ALERT_COUNT 12
  240. #ifdef __cplusplus
  241. }
  242. #endif
  243. #endif