mbed TLS v2.16.1
ssl.h
Go to the documentation of this file.
1 
6 /*
7  * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
8  * SPDX-License-Identifier: GPL-2.0
9  *
10  * This program is free software; you can redistribute it and/or modify
11  * it under the terms of the GNU General Public License as published by
12  * the Free Software Foundation; either version 2 of the License, or
13  * (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18  * GNU General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public License along
21  * with this program; if not, write to the Free Software Foundation, Inc.,
22  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
23  *
24  * This file is part of mbed TLS (https://tls.mbed.org)
25  */
26 #ifndef MBEDTLS_SSL_H
27 #define MBEDTLS_SSL_H
28 
29 #if !defined(MBEDTLS_CONFIG_FILE)
30 #include "config.h"
31 #else
32 #include MBEDTLS_CONFIG_FILE
33 #endif
34 
35 #include "bignum.h"
36 #include "ecp.h"
37 
38 #include "ssl_ciphersuites.h"
39 
40 #if defined(MBEDTLS_X509_CRT_PARSE_C)
41 #include "x509_crt.h"
42 #include "x509_crl.h"
43 #endif
44 
45 #if defined(MBEDTLS_DHM_C)
46 #include "dhm.h"
47 #endif
48 
49 #if defined(MBEDTLS_ECDH_C)
50 #include "ecdh.h"
51 #endif
52 
53 #if defined(MBEDTLS_ZLIB_SUPPORT)
54 
55 #if defined(MBEDTLS_DEPRECATED_WARNING)
56 #warning "Record compression support via MBEDTLS_ZLIB_SUPPORT is deprecated and will be removed in the next major revision of the library"
57 #endif
58 
59 #if defined(MBEDTLS_DEPRECATED_REMOVED)
60 #error "Record compression support via MBEDTLS_ZLIB_SUPPORT is deprecated and cannot be used if MBEDTLS_DEPRECATED_REMOVED is set"
61 #endif
62 
63 #include "zlib.h"
64 #endif
65 
66 #if defined(MBEDTLS_HAVE_TIME)
67 #include "platform_time.h"
68 #endif
69 
70 /*
71  * SSL Error codes
72  */
73 #define MBEDTLS_ERR_SSL_FEATURE_UNAVAILABLE -0x7080
74 #define MBEDTLS_ERR_SSL_BAD_INPUT_DATA -0x7100
75 #define MBEDTLS_ERR_SSL_INVALID_MAC -0x7180
76 #define MBEDTLS_ERR_SSL_INVALID_RECORD -0x7200
77 #define MBEDTLS_ERR_SSL_CONN_EOF -0x7280
78 #define MBEDTLS_ERR_SSL_UNKNOWN_CIPHER -0x7300
79 #define MBEDTLS_ERR_SSL_NO_CIPHER_CHOSEN -0x7380
80 #define MBEDTLS_ERR_SSL_NO_RNG -0x7400
81 #define MBEDTLS_ERR_SSL_NO_CLIENT_CERTIFICATE -0x7480
82 #define MBEDTLS_ERR_SSL_CERTIFICATE_TOO_LARGE -0x7500
83 #define MBEDTLS_ERR_SSL_CERTIFICATE_REQUIRED -0x7580
84 #define MBEDTLS_ERR_SSL_PRIVATE_KEY_REQUIRED -0x7600
85 #define MBEDTLS_ERR_SSL_CA_CHAIN_REQUIRED -0x7680
86 #define MBEDTLS_ERR_SSL_UNEXPECTED_MESSAGE -0x7700
87 #define MBEDTLS_ERR_SSL_FATAL_ALERT_MESSAGE -0x7780
88 #define MBEDTLS_ERR_SSL_PEER_VERIFY_FAILED -0x7800
89 #define MBEDTLS_ERR_SSL_PEER_CLOSE_NOTIFY -0x7880
90 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_HELLO -0x7900
91 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO -0x7980
92 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE -0x7A00
93 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_REQUEST -0x7A80
94 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_KEY_EXCHANGE -0x7B00
95 #define MBEDTLS_ERR_SSL_BAD_HS_SERVER_HELLO_DONE -0x7B80
96 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE -0x7C00
97 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_RP -0x7C80
98 #define MBEDTLS_ERR_SSL_BAD_HS_CLIENT_KEY_EXCHANGE_CS -0x7D00
99 #define MBEDTLS_ERR_SSL_BAD_HS_CERTIFICATE_VERIFY -0x7D80
100 #define MBEDTLS_ERR_SSL_BAD_HS_CHANGE_CIPHER_SPEC -0x7E00
101 #define MBEDTLS_ERR_SSL_BAD_HS_FINISHED -0x7E80
102 #define MBEDTLS_ERR_SSL_ALLOC_FAILED -0x7F00
103 #define MBEDTLS_ERR_SSL_HW_ACCEL_FAILED -0x7F80
104 #define MBEDTLS_ERR_SSL_HW_ACCEL_FALLTHROUGH -0x6F80
105 #define MBEDTLS_ERR_SSL_COMPRESSION_FAILED -0x6F00
106 #define MBEDTLS_ERR_SSL_BAD_HS_PROTOCOL_VERSION -0x6E80
107 #define MBEDTLS_ERR_SSL_BAD_HS_NEW_SESSION_TICKET -0x6E00
108 #define MBEDTLS_ERR_SSL_SESSION_TICKET_EXPIRED -0x6D80
109 #define MBEDTLS_ERR_SSL_PK_TYPE_MISMATCH -0x6D00
110 #define MBEDTLS_ERR_SSL_UNKNOWN_IDENTITY -0x6C80
111 #define MBEDTLS_ERR_SSL_INTERNAL_ERROR -0x6C00
112 #define MBEDTLS_ERR_SSL_COUNTER_WRAPPING -0x6B80
113 #define MBEDTLS_ERR_SSL_WAITING_SERVER_HELLO_RENEGO -0x6B00
114 #define MBEDTLS_ERR_SSL_HELLO_VERIFY_REQUIRED -0x6A80
115 #define MBEDTLS_ERR_SSL_BUFFER_TOO_SMALL -0x6A00
116 #define MBEDTLS_ERR_SSL_NO_USABLE_CIPHERSUITE -0x6980
117 #define MBEDTLS_ERR_SSL_WANT_READ -0x6900
118 #define MBEDTLS_ERR_SSL_WANT_WRITE -0x6880
119 #define MBEDTLS_ERR_SSL_TIMEOUT -0x6800
120 #define MBEDTLS_ERR_SSL_CLIENT_RECONNECT -0x6780
121 #define MBEDTLS_ERR_SSL_UNEXPECTED_RECORD -0x6700
122 #define MBEDTLS_ERR_SSL_NON_FATAL -0x6680
123 #define MBEDTLS_ERR_SSL_INVALID_VERIFY_HASH -0x6600
124 #define MBEDTLS_ERR_SSL_CONTINUE_PROCESSING -0x6580
125 #define MBEDTLS_ERR_SSL_ASYNC_IN_PROGRESS -0x6500
126 #define MBEDTLS_ERR_SSL_EARLY_MESSAGE -0x6480
127 #define MBEDTLS_ERR_SSL_CRYPTO_IN_PROGRESS -0x7000
129 /*
130  * Various constants
131  */
132 #define MBEDTLS_SSL_MAJOR_VERSION_3 3
133 #define MBEDTLS_SSL_MINOR_VERSION_0 0
134 #define MBEDTLS_SSL_MINOR_VERSION_1 1
135 #define MBEDTLS_SSL_MINOR_VERSION_2 2
136 #define MBEDTLS_SSL_MINOR_VERSION_3 3
138 #define MBEDTLS_SSL_TRANSPORT_STREAM 0
139 #define MBEDTLS_SSL_TRANSPORT_DATAGRAM 1
141 #define MBEDTLS_SSL_MAX_HOST_NAME_LEN 255
143 /* RFC 6066 section 4, see also mfl_code_to_length in ssl_tls.c
144  * NONE must be zero so that memset()ing structure to zero works */
145 #define MBEDTLS_SSL_MAX_FRAG_LEN_NONE 0
146 #define MBEDTLS_SSL_MAX_FRAG_LEN_512 1
147 #define MBEDTLS_SSL_MAX_FRAG_LEN_1024 2
148 #define MBEDTLS_SSL_MAX_FRAG_LEN_2048 3
149 #define MBEDTLS_SSL_MAX_FRAG_LEN_4096 4
150 #define MBEDTLS_SSL_MAX_FRAG_LEN_INVALID 5
152 #define MBEDTLS_SSL_IS_CLIENT 0
153 #define MBEDTLS_SSL_IS_SERVER 1
154 
155 #define MBEDTLS_SSL_IS_NOT_FALLBACK 0
156 #define MBEDTLS_SSL_IS_FALLBACK 1
157 
158 #define MBEDTLS_SSL_EXTENDED_MS_DISABLED 0
159 #define MBEDTLS_SSL_EXTENDED_MS_ENABLED 1
160 
161 #define MBEDTLS_SSL_ETM_DISABLED 0
162 #define MBEDTLS_SSL_ETM_ENABLED 1
163 
164 #define MBEDTLS_SSL_COMPRESS_NULL 0
165 #define MBEDTLS_SSL_COMPRESS_DEFLATE 1
166 
167 #define MBEDTLS_SSL_VERIFY_NONE 0
168 #define MBEDTLS_SSL_VERIFY_OPTIONAL 1
169 #define MBEDTLS_SSL_VERIFY_REQUIRED 2
170 #define MBEDTLS_SSL_VERIFY_UNSET 3 /* Used only for sni_authmode */
171 
172 #define MBEDTLS_SSL_LEGACY_RENEGOTIATION 0
173 #define MBEDTLS_SSL_SECURE_RENEGOTIATION 1
174 
175 #define MBEDTLS_SSL_RENEGOTIATION_DISABLED 0
176 #define MBEDTLS_SSL_RENEGOTIATION_ENABLED 1
177 
178 #define MBEDTLS_SSL_ANTI_REPLAY_DISABLED 0
179 #define MBEDTLS_SSL_ANTI_REPLAY_ENABLED 1
180 
181 #define MBEDTLS_SSL_RENEGOTIATION_NOT_ENFORCED -1
182 #define MBEDTLS_SSL_RENEGO_MAX_RECORDS_DEFAULT 16
183 
184 #define MBEDTLS_SSL_LEGACY_NO_RENEGOTIATION 0
185 #define MBEDTLS_SSL_LEGACY_ALLOW_RENEGOTIATION 1
186 #define MBEDTLS_SSL_LEGACY_BREAK_HANDSHAKE 2
187 
188 #define MBEDTLS_SSL_TRUNC_HMAC_DISABLED 0
189 #define MBEDTLS_SSL_TRUNC_HMAC_ENABLED 1
190 #define MBEDTLS_SSL_TRUNCATED_HMAC_LEN 10 /* 80 bits, rfc 6066 section 7 */
191 
192 #define MBEDTLS_SSL_SESSION_TICKETS_DISABLED 0
193 #define MBEDTLS_SSL_SESSION_TICKETS_ENABLED 1
194 
195 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_DISABLED 0
196 #define MBEDTLS_SSL_CBC_RECORD_SPLITTING_ENABLED 1
197 
198 #define MBEDTLS_SSL_ARC4_ENABLED 0
199 #define MBEDTLS_SSL_ARC4_DISABLED 1
200 
201 #define MBEDTLS_SSL_PRESET_DEFAULT 0
202 #define MBEDTLS_SSL_PRESET_SUITEB 2
203 
204 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_ENABLED 1
205 #define MBEDTLS_SSL_CERT_REQ_CA_LIST_DISABLED 0
206 
207 /*
208  * Default range for DTLS retransmission timer value, in milliseconds.
209  * RFC 6347 4.2.4.1 says from 1 second to 60 seconds.
210  */
211 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MIN 1000
212 #define MBEDTLS_SSL_DTLS_TIMEOUT_DFL_MAX 60000
213 
222 #if !defined(MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME)
223 #define MBEDTLS_SSL_DEFAULT_TICKET_LIFETIME 86400
224 #endif
225 
226 /*
227  * Maximum fragment length in bytes,
228  * determines the size of each of the two internal I/O buffers.
229  *
230  * Note: the RFC defines the default size of SSL / TLS messages. If you
231  * change the value here, other clients / servers may not be able to
232  * communicate with you anymore. Only change this value if you control
233  * both sides of the connection and have it reduced at both sides, or
234  * if you're using the Max Fragment Length extension and you know all your
235  * peers are using it too!
236  */
237 #if !defined(MBEDTLS_SSL_MAX_CONTENT_LEN)
238 #define MBEDTLS_SSL_MAX_CONTENT_LEN 16384
239 #endif
240 
241 #if !defined(MBEDTLS_SSL_IN_CONTENT_LEN)
242 #define MBEDTLS_SSL_IN_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
243 #endif
244 
245 #if !defined(MBEDTLS_SSL_OUT_CONTENT_LEN)
246 #define MBEDTLS_SSL_OUT_CONTENT_LEN MBEDTLS_SSL_MAX_CONTENT_LEN
247 #endif
248 
249 /*
250  * Maximum number of heap-allocated bytes for the purpose of
251  * DTLS handshake message reassembly and future message buffering.
252  */
253 #if !defined(MBEDTLS_SSL_DTLS_MAX_BUFFERING)
254 #define MBEDTLS_SSL_DTLS_MAX_BUFFERING 32768
255 #endif
256 
257 /* \} name SECTION: Module settings */
258 
259 /*
260  * Length of the verify data for secure renegotiation
261  */
262 #if defined(MBEDTLS_SSL_PROTO_SSL3)
263 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 36
264 #else
265 #define MBEDTLS_SSL_VERIFY_DATA_MAX_LEN 12
266 #endif
267 
268 /*
269  * Signaling ciphersuite values (SCSV)
270  */
271 #define MBEDTLS_SSL_EMPTY_RENEGOTIATION_INFO 0xFF
272 #define MBEDTLS_SSL_FALLBACK_SCSV_VALUE 0x5600
274 /*
275  * Supported Signature and Hash algorithms (For TLS 1.2)
276  * RFC 5246 section 7.4.1.4.1
277  */
278 #define MBEDTLS_SSL_HASH_NONE 0
279 #define MBEDTLS_SSL_HASH_MD5 1
280 #define MBEDTLS_SSL_HASH_SHA1 2
281 #define MBEDTLS_SSL_HASH_SHA224 3
282 #define MBEDTLS_SSL_HASH_SHA256 4
283 #define MBEDTLS_SSL_HASH_SHA384 5
284 #define MBEDTLS_SSL_HASH_SHA512 6
285 
286 #define MBEDTLS_SSL_SIG_ANON 0
287 #define MBEDTLS_SSL_SIG_RSA 1
288 #define MBEDTLS_SSL_SIG_ECDSA 3
289 
290 /*
291  * Client Certificate Types
292  * RFC 5246 section 7.4.4 plus RFC 4492 section 5.5
293  */
294 #define MBEDTLS_SSL_CERT_TYPE_RSA_SIGN 1
295 #define MBEDTLS_SSL_CERT_TYPE_ECDSA_SIGN 64
296 
297 /*
298  * Message, alert and handshake types
299  */
300 #define MBEDTLS_SSL_MSG_CHANGE_CIPHER_SPEC 20
301 #define MBEDTLS_SSL_MSG_ALERT 21
302 #define MBEDTLS_SSL_MSG_HANDSHAKE 22
303 #define MBEDTLS_SSL_MSG_APPLICATION_DATA 23
304 
305 #define MBEDTLS_SSL_ALERT_LEVEL_WARNING 1
306 #define MBEDTLS_SSL_ALERT_LEVEL_FATAL 2
307 
308 #define MBEDTLS_SSL_ALERT_MSG_CLOSE_NOTIFY 0 /* 0x00 */
309 #define MBEDTLS_SSL_ALERT_MSG_UNEXPECTED_MESSAGE 10 /* 0x0A */
310 #define MBEDTLS_SSL_ALERT_MSG_BAD_RECORD_MAC 20 /* 0x14 */
311 #define MBEDTLS_SSL_ALERT_MSG_DECRYPTION_FAILED 21 /* 0x15 */
312 #define MBEDTLS_SSL_ALERT_MSG_RECORD_OVERFLOW 22 /* 0x16 */
313 #define MBEDTLS_SSL_ALERT_MSG_DECOMPRESSION_FAILURE 30 /* 0x1E */
314 #define MBEDTLS_SSL_ALERT_MSG_HANDSHAKE_FAILURE 40 /* 0x28 */
315 #define MBEDTLS_SSL_ALERT_MSG_NO_CERT 41 /* 0x29 */
316 #define MBEDTLS_SSL_ALERT_MSG_BAD_CERT 42 /* 0x2A */
317 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_CERT 43 /* 0x2B */
318 #define MBEDTLS_SSL_ALERT_MSG_CERT_REVOKED 44 /* 0x2C */
319 #define MBEDTLS_SSL_ALERT_MSG_CERT_EXPIRED 45 /* 0x2D */
320 #define MBEDTLS_SSL_ALERT_MSG_CERT_UNKNOWN 46 /* 0x2E */
321 #define MBEDTLS_SSL_ALERT_MSG_ILLEGAL_PARAMETER 47 /* 0x2F */
322 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_CA 48 /* 0x30 */
323 #define MBEDTLS_SSL_ALERT_MSG_ACCESS_DENIED 49 /* 0x31 */
324 #define MBEDTLS_SSL_ALERT_MSG_DECODE_ERROR 50 /* 0x32 */
325 #define MBEDTLS_SSL_ALERT_MSG_DECRYPT_ERROR 51 /* 0x33 */
326 #define MBEDTLS_SSL_ALERT_MSG_EXPORT_RESTRICTION 60 /* 0x3C */
327 #define MBEDTLS_SSL_ALERT_MSG_PROTOCOL_VERSION 70 /* 0x46 */
328 #define MBEDTLS_SSL_ALERT_MSG_INSUFFICIENT_SECURITY 71 /* 0x47 */
329 #define MBEDTLS_SSL_ALERT_MSG_INTERNAL_ERROR 80 /* 0x50 */
330 #define MBEDTLS_SSL_ALERT_MSG_INAPROPRIATE_FALLBACK 86 /* 0x56 */
331 #define MBEDTLS_SSL_ALERT_MSG_USER_CANCELED 90 /* 0x5A */
332 #define MBEDTLS_SSL_ALERT_MSG_NO_RENEGOTIATION 100 /* 0x64 */
333 #define MBEDTLS_SSL_ALERT_MSG_UNSUPPORTED_EXT 110 /* 0x6E */
334 #define MBEDTLS_SSL_ALERT_MSG_UNRECOGNIZED_NAME 112 /* 0x70 */
335 #define MBEDTLS_SSL_ALERT_MSG_UNKNOWN_PSK_IDENTITY 115 /* 0x73 */
336 #define MBEDTLS_SSL_ALERT_MSG_NO_APPLICATION_PROTOCOL 120 /* 0x78 */
337 
338 #define MBEDTLS_SSL_HS_HELLO_REQUEST 0
339 #define MBEDTLS_SSL_HS_CLIENT_HELLO 1
340 #define MBEDTLS_SSL_HS_SERVER_HELLO 2
341 #define MBEDTLS_SSL_HS_HELLO_VERIFY_REQUEST 3
342 #define MBEDTLS_SSL_HS_NEW_SESSION_TICKET 4
343 #define MBEDTLS_SSL_HS_CERTIFICATE 11
344 #define MBEDTLS_SSL_HS_SERVER_KEY_EXCHANGE 12
345 #define MBEDTLS_SSL_HS_CERTIFICATE_REQUEST 13
346 #define MBEDTLS_SSL_HS_SERVER_HELLO_DONE 14
347 #define MBEDTLS_SSL_HS_CERTIFICATE_VERIFY 15
348 #define MBEDTLS_SSL_HS_CLIENT_KEY_EXCHANGE 16
349 #define MBEDTLS_SSL_HS_FINISHED 20
350 
351 /*
352  * TLS extensions
353  */
354 #define MBEDTLS_TLS_EXT_SERVERNAME 0
355 #define MBEDTLS_TLS_EXT_SERVERNAME_HOSTNAME 0
356 
357 #define MBEDTLS_TLS_EXT_MAX_FRAGMENT_LENGTH 1
358 
359 #define MBEDTLS_TLS_EXT_TRUNCATED_HMAC 4
360 
361 #define MBEDTLS_TLS_EXT_SUPPORTED_ELLIPTIC_CURVES 10
362 #define MBEDTLS_TLS_EXT_SUPPORTED_POINT_FORMATS 11
363 
364 #define MBEDTLS_TLS_EXT_SIG_ALG 13
365 
366 #define MBEDTLS_TLS_EXT_ALPN 16
367 
368 #define MBEDTLS_TLS_EXT_ENCRYPT_THEN_MAC 22 /* 0x16 */
369 #define MBEDTLS_TLS_EXT_EXTENDED_MASTER_SECRET 0x0017 /* 23 */
370 
371 #define MBEDTLS_TLS_EXT_SESSION_TICKET 35
372 
373 #define MBEDTLS_TLS_EXT_ECJPAKE_KKPP 256 /* experimental */
374 
375 #define MBEDTLS_TLS_EXT_RENEGOTIATION_INFO 0xFF01
376 
377 /*
378  * Size defines
379  */
380 #if !defined(MBEDTLS_PSK_MAX_LEN)
381 #define MBEDTLS_PSK_MAX_LEN 32 /* 256 bits */
382 #endif
383 
384 /* Dummy type used only for its size */
386 {
387 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_ENABLED)
388  unsigned char _pms_rsa[48]; /* RFC 5246 8.1.1 */
389 #endif
390 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_RSA_ENABLED)
391  unsigned char _pms_dhm[MBEDTLS_MPI_MAX_SIZE]; /* RFC 5246 8.1.2 */
392 #endif
393 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_RSA_ENABLED) || \
394  defined(MBEDTLS_KEY_EXCHANGE_ECDHE_ECDSA_ENABLED) || \
395  defined(MBEDTLS_KEY_EXCHANGE_ECDH_RSA_ENABLED) || \
396  defined(MBEDTLS_KEY_EXCHANGE_ECDH_ECDSA_ENABLED)
397  unsigned char _pms_ecdh[MBEDTLS_ECP_MAX_BYTES]; /* RFC 4492 5.10 */
398 #endif
399 #if defined(MBEDTLS_KEY_EXCHANGE_PSK_ENABLED)
400  unsigned char _pms_psk[4 + 2 * MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 2 */
401 #endif
402 #if defined(MBEDTLS_KEY_EXCHANGE_DHE_PSK_ENABLED)
403  unsigned char _pms_dhe_psk[4 + MBEDTLS_MPI_MAX_SIZE
404  + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 3 */
405 #endif
406 #if defined(MBEDTLS_KEY_EXCHANGE_RSA_PSK_ENABLED)
407  unsigned char _pms_rsa_psk[52 + MBEDTLS_PSK_MAX_LEN]; /* RFC 4279 4 */
408 #endif
409 #if defined(MBEDTLS_KEY_EXCHANGE_ECDHE_PSK_ENABLED)
410  unsigned char _pms_ecdhe_psk[4 + MBEDTLS_ECP_MAX_BYTES
411  + MBEDTLS_PSK_MAX_LEN]; /* RFC 5489 2 */
412 #endif
413 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
414  unsigned char _pms_ecjpake[32]; /* Thread spec: SHA-256 output */
415 #endif
416 };
417 
418 #define MBEDTLS_PREMASTER_SIZE sizeof( union mbedtls_ssl_premaster_secret )
419 
420 #ifdef __cplusplus
421 extern "C" {
422 #endif
423 
424 /*
425  * SSL state machine
426  */
427 typedef enum
428 {
448 }
450 
468 typedef int mbedtls_ssl_send_t( void *ctx,
469  const unsigned char *buf,
470  size_t len );
471 
491 typedef int mbedtls_ssl_recv_t( void *ctx,
492  unsigned char *buf,
493  size_t len );
494 
517 typedef int mbedtls_ssl_recv_timeout_t( void *ctx,
518  unsigned char *buf,
519  size_t len,
520  uint32_t timeout );
543 typedef void mbedtls_ssl_set_timer_t( void * ctx,
544  uint32_t int_ms,
545  uint32_t fin_ms );
546 
558 typedef int mbedtls_ssl_get_timer_t( void * ctx );
559 
560 /* Defined below */
564 
565 /* Defined in ssl_internal.h */
569 #if defined(MBEDTLS_X509_CRT_PARSE_C)
571 #endif
572 #if defined(MBEDTLS_SSL_PROTO_DTLS)
574 #endif
575 
576 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
577 #if defined(MBEDTLS_X509_CRT_PARSE_C)
578 
649 typedef int mbedtls_ssl_async_sign_t( mbedtls_ssl_context *ssl,
650  mbedtls_x509_crt *cert,
651  mbedtls_md_type_t md_alg,
652  const unsigned char *hash,
653  size_t hash_len );
654 
715 typedef int mbedtls_ssl_async_decrypt_t( mbedtls_ssl_context *ssl,
716  mbedtls_x509_crt *cert,
717  const unsigned char *input,
718  size_t input_len );
719 #endif /* MBEDTLS_X509_CRT_PARSE_C */
720 
763 typedef int mbedtls_ssl_async_resume_t( mbedtls_ssl_context *ssl,
764  unsigned char *output,
765  size_t *output_len,
766  size_t output_size );
767 
785 typedef void mbedtls_ssl_async_cancel_t( mbedtls_ssl_context *ssl );
786 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
787 
788 /*
789  * This structure is used for storing current session data.
790  */
792 {
793 #if defined(MBEDTLS_HAVE_TIME)
795 #endif
798  size_t id_len;
799  unsigned char id[32];
800  unsigned char master[48];
802 #if defined(MBEDTLS_X509_CRT_PARSE_C)
804 #endif /* MBEDTLS_X509_CRT_PARSE_C */
805  uint32_t verify_result;
807 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
808  unsigned char *ticket;
809  size_t ticket_len;
810  uint32_t ticket_lifetime;
811 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
812 
813 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
814  unsigned char mfl_code;
815 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
816 
817 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
819 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
820 
821 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
823 #endif
824 };
825 
830 {
831  /* Group items by size (largest first) to minimize padding overhead */
832 
833  /*
834  * Pointers
835  */
836 
837  const int *ciphersuite_list[4];
840  void (*f_dbg)(void *, int, const char *, int, const char *);
841  void *p_dbg;
844  int (*f_rng)(void *, unsigned char *, size_t);
845  void *p_rng;
848  int (*f_get_cache)(void *, mbedtls_ssl_session *);
850  int (*f_set_cache)(void *, const mbedtls_ssl_session *);
851  void *p_cache;
853 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
854 
855  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
856  void *p_sni;
857 #endif
858 
859 #if defined(MBEDTLS_X509_CRT_PARSE_C)
860 
861  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *);
862  void *p_vrfy;
863 #endif
864 
865 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
866 
867  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *, size_t);
868  void *p_psk;
869 #endif
870 
871 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
872 
873  int (*f_cookie_write)( void *, unsigned char **, unsigned char *,
874  const unsigned char *, size_t );
876  int (*f_cookie_check)( void *, const unsigned char *, size_t,
877  const unsigned char *, size_t );
878  void *p_cookie;
879 #endif
880 
881 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
882 
883  int (*f_ticket_write)( void *, const mbedtls_ssl_session *,
884  unsigned char *, const unsigned char *, size_t *, uint32_t * );
886  int (*f_ticket_parse)( void *, mbedtls_ssl_session *, unsigned char *, size_t);
887  void *p_ticket;
888 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
889 
890 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
891 
892  int (*f_export_keys)( void *, const unsigned char *,
893  const unsigned char *, size_t, size_t, size_t );
895 #endif
896 
897 #if defined(MBEDTLS_X509_CRT_PARSE_C)
902 #endif /* MBEDTLS_X509_CRT_PARSE_C */
903 
904 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
905 #if defined(MBEDTLS_X509_CRT_PARSE_C)
906  mbedtls_ssl_async_sign_t *f_async_sign_start;
907  mbedtls_ssl_async_decrypt_t *f_async_decrypt_start;
908 #endif /* MBEDTLS_X509_CRT_PARSE_C */
909  mbedtls_ssl_async_resume_t *f_async_resume;
910  mbedtls_ssl_async_cancel_t *f_async_cancel;
911  void *p_async_config_data;
912 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
913 
914 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
915  const int *sig_hashes;
916 #endif
917 
918 #if defined(MBEDTLS_ECP_C)
920 #endif
921 
922 #if defined(MBEDTLS_DHM_C)
925 #endif
926 
927 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
928  unsigned char *psk;
931  size_t psk_len;
934  unsigned char *psk_identity;
940 #endif
941 
942 #if defined(MBEDTLS_SSL_ALPN)
943  const char **alpn_list;
944 #endif
945 
946  /*
947  * Numerical settings (int then char)
948  */
949 
950  uint32_t read_timeout;
952 #if defined(MBEDTLS_SSL_PROTO_DTLS)
953  uint32_t hs_timeout_min;
955  uint32_t hs_timeout_max;
957 #endif
958 
959 #if defined(MBEDTLS_SSL_RENEGOTIATION)
961  unsigned char renego_period[8];
963 #endif
964 
965 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
966  unsigned int badmac_limit;
967 #endif
968 
969 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
970  unsigned int dhm_min_bitlen;
971 #endif
972 
973  unsigned char max_major_ver;
974  unsigned char max_minor_ver;
975  unsigned char min_major_ver;
976  unsigned char min_minor_ver;
978  /*
979  * Flags (bitfields)
980  */
981 
982  unsigned int endpoint : 1;
983  unsigned int transport : 1;
984  unsigned int authmode : 2;
985  /* needed even with renego disabled for LEGACY_BREAK_HANDSHAKE */
986  unsigned int allow_legacy_renegotiation : 2 ;
987 #if defined(MBEDTLS_ARC4_C)
988  unsigned int arc4_disabled : 1;
989 #endif
990 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
991  unsigned int mfl_code : 3;
992 #endif
993 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
994  unsigned int encrypt_then_mac : 1 ;
995 #endif
996 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
997  unsigned int extended_ms : 1;
998 #endif
999 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1000  unsigned int anti_replay : 1;
1001 #endif
1002 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1003  unsigned int cbc_record_splitting : 1;
1004 #endif
1005 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1006  unsigned int disable_renegotiation : 1;
1007 #endif
1008 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
1009  unsigned int trunc_hmac : 1;
1010 #endif
1011 #if defined(MBEDTLS_SSL_SESSION_TICKETS)
1012  unsigned int session_tickets : 1;
1013 #endif
1014 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
1015  unsigned int fallback : 1;
1016 #endif
1017 #if defined(MBEDTLS_SSL_SRV_C)
1018  unsigned int cert_req_ca_list : 1;
1020 #endif
1021 };
1022 
1023 
1025 {
1028  /*
1029  * Miscellaneous
1030  */
1031  int state;
1032 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1037 #endif /* MBEDTLS_SSL_RENEGOTIATION */
1038 
1042 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1043  unsigned badmac_seen;
1044 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
1045 
1051  void *p_bio;
1053  /*
1054  * Session layer
1055  */
1064  /*
1065  * Record layer transformations
1066  */
1072  /*
1073  * Timers
1074  */
1075  void *p_timer;
1080  /*
1081  * Record layer (incoming data)
1082  */
1083  unsigned char *in_buf;
1084  unsigned char *in_ctr;
1087  unsigned char *in_hdr;
1088  unsigned char *in_len;
1089  unsigned char *in_iv;
1090  unsigned char *in_msg;
1091  unsigned char *in_offt;
1094  size_t in_msglen;
1095  size_t in_left;
1096 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1097  uint16_t in_epoch;
1100 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1101 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1102  uint64_t in_window_top;
1103  uint64_t in_window;
1104 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
1105 
1106  size_t in_hslen;
1108  int nb_zero;
1113 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1116 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1117 
1118  /*
1119  * Record layer (outgoing data)
1120  */
1121  unsigned char *out_buf;
1122  unsigned char *out_ctr;
1123  unsigned char *out_hdr;
1124  unsigned char *out_len;
1125  unsigned char *out_iv;
1126  unsigned char *out_msg;
1129  size_t out_msglen;
1130  size_t out_left;
1132  unsigned char cur_out_ctr[8];
1134 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1135  uint16_t mtu;
1136 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1137 
1138 #if defined(MBEDTLS_ZLIB_SUPPORT)
1139  unsigned char *compress_buf;
1140 #endif /* MBEDTLS_ZLIB_SUPPORT */
1141 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
1142  signed char split_done;
1143 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
1144 
1145  /*
1146  * PKI layer
1147  */
1150  /*
1151  * User settings
1152  */
1153 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1154  char *hostname;
1156 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1157 
1158 #if defined(MBEDTLS_SSL_ALPN)
1159  const char *alpn_chosen;
1160 #endif /* MBEDTLS_SSL_ALPN */
1161 
1162  /*
1163  * Information for DTLS hello verify
1164  */
1165 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1166  unsigned char *cli_id;
1167  size_t cli_id_len;
1168 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
1169 
1170  /*
1171  * Secure renegotiation
1172  */
1173  /* needed to know when to send extension on server */
1176 #if defined(MBEDTLS_SSL_RENEGOTIATION)
1180 #endif /* MBEDTLS_SSL_RENEGOTIATION */
1181 };
1182 
1183 #if defined(MBEDTLS_SSL_HW_RECORD_ACCEL)
1184 
1185 #define MBEDTLS_SSL_CHANNEL_OUTBOUND 0
1186 #define MBEDTLS_SSL_CHANNEL_INBOUND 1
1187 
1188 extern int (*mbedtls_ssl_hw_record_init)(mbedtls_ssl_context *ssl,
1189  const unsigned char *key_enc, const unsigned char *key_dec,
1190  size_t keylen,
1191  const unsigned char *iv_enc, const unsigned char *iv_dec,
1192  size_t ivlen,
1193  const unsigned char *mac_enc, const unsigned char *mac_dec,
1194  size_t maclen);
1195 extern int (*mbedtls_ssl_hw_record_activate)(mbedtls_ssl_context *ssl, int direction);
1196 extern int (*mbedtls_ssl_hw_record_reset)(mbedtls_ssl_context *ssl);
1197 extern int (*mbedtls_ssl_hw_record_write)(mbedtls_ssl_context *ssl);
1198 extern int (*mbedtls_ssl_hw_record_read)(mbedtls_ssl_context *ssl);
1199 extern int (*mbedtls_ssl_hw_record_finish)(mbedtls_ssl_context *ssl);
1200 #endif /* MBEDTLS_SSL_HW_RECORD_ACCEL */
1201 
1210 const char *mbedtls_ssl_get_ciphersuite_name( const int ciphersuite_id );
1211 
1220 int mbedtls_ssl_get_ciphersuite_id( const char *ciphersuite_name );
1221 
1230 
1252  const mbedtls_ssl_config *conf );
1253 
1265 
1272 void mbedtls_ssl_conf_endpoint( mbedtls_ssl_config *conf, int endpoint );
1273 
1288 void mbedtls_ssl_conf_transport( mbedtls_ssl_config *conf, int transport );
1289 
1316 void mbedtls_ssl_conf_authmode( mbedtls_ssl_config *conf, int authmode );
1317 
1318 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1319 
1331  int (*f_vrfy)(void *, mbedtls_x509_crt *, int, uint32_t *),
1332  void *p_vrfy );
1333 #endif /* MBEDTLS_X509_CRT_PARSE_C */
1334 
1343  int (*f_rng)(void *, unsigned char *, size_t),
1344  void *p_rng );
1345 
1361  void (*f_dbg)(void *, int, const char *, int, const char *),
1362  void *p_dbg );
1363 
1395  void *p_bio,
1396  mbedtls_ssl_send_t *f_send,
1397  mbedtls_ssl_recv_t *f_recv,
1398  mbedtls_ssl_recv_timeout_t *f_recv_timeout );
1399 
1400 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1401 
1443 void mbedtls_ssl_set_mtu( mbedtls_ssl_context *ssl, uint16_t mtu );
1444 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1445 
1462 void mbedtls_ssl_conf_read_timeout( mbedtls_ssl_config *conf, uint32_t timeout );
1463 
1485  void *p_timer,
1486  mbedtls_ssl_set_timer_t *f_set_timer,
1487  mbedtls_ssl_get_timer_t *f_get_timer );
1488 
1508 typedef int mbedtls_ssl_ticket_write_t( void *p_ticket,
1509  const mbedtls_ssl_session *session,
1510  unsigned char *start,
1511  const unsigned char *end,
1512  size_t *tlen,
1513  uint32_t *lifetime );
1514 
1515 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1516 
1536 typedef int mbedtls_ssl_export_keys_t( void *p_expkey,
1537  const unsigned char *ms,
1538  const unsigned char *kb,
1539  size_t maclen,
1540  size_t keylen,
1541  size_t ivlen );
1542 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1543 
1567 typedef int mbedtls_ssl_ticket_parse_t( void *p_ticket,
1568  mbedtls_ssl_session *session,
1569  unsigned char *buf,
1570  size_t len );
1571 
1572 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_SRV_C)
1573 
1588  mbedtls_ssl_ticket_write_t *f_ticket_write,
1589  mbedtls_ssl_ticket_parse_t *f_ticket_parse,
1590  void *p_ticket );
1591 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_SRV_C */
1592 
1593 #if defined(MBEDTLS_SSL_EXPORT_KEYS)
1594 
1605  mbedtls_ssl_export_keys_t *f_export_keys,
1606  void *p_export_keys );
1607 #endif /* MBEDTLS_SSL_EXPORT_KEYS */
1608 
1609 #if defined(MBEDTLS_SSL_ASYNC_PRIVATE)
1610 
1640 void mbedtls_ssl_conf_async_private_cb( mbedtls_ssl_config *conf,
1641  mbedtls_ssl_async_sign_t *f_async_sign,
1642  mbedtls_ssl_async_decrypt_t *f_async_decrypt,
1643  mbedtls_ssl_async_resume_t *f_async_resume,
1644  mbedtls_ssl_async_cancel_t *f_async_cancel,
1645  void *config_data );
1646 
1655 void *mbedtls_ssl_conf_get_async_config_data( const mbedtls_ssl_config *conf );
1656 
1671 void *mbedtls_ssl_get_async_operation_data( const mbedtls_ssl_context *ssl );
1672 
1684 void mbedtls_ssl_set_async_operation_data( mbedtls_ssl_context *ssl,
1685  void *ctx );
1686 #endif /* MBEDTLS_SSL_ASYNC_PRIVATE */
1687 
1702 typedef int mbedtls_ssl_cookie_write_t( void *ctx,
1703  unsigned char **p, unsigned char *end,
1704  const unsigned char *info, size_t ilen );
1705 
1719 typedef int mbedtls_ssl_cookie_check_t( void *ctx,
1720  const unsigned char *cookie, size_t clen,
1721  const unsigned char *info, size_t ilen );
1722 
1723 #if defined(MBEDTLS_SSL_DTLS_HELLO_VERIFY) && defined(MBEDTLS_SSL_SRV_C)
1724 
1753  mbedtls_ssl_cookie_write_t *f_cookie_write,
1754  mbedtls_ssl_cookie_check_t *f_cookie_check,
1755  void *p_cookie );
1756 
1777  const unsigned char *info,
1778  size_t ilen );
1779 
1780 #endif /* MBEDTLS_SSL_DTLS_HELLO_VERIFY && MBEDTLS_SSL_SRV_C */
1781 
1782 #if defined(MBEDTLS_SSL_DTLS_ANTI_REPLAY)
1783 
1798 void mbedtls_ssl_conf_dtls_anti_replay( mbedtls_ssl_config *conf, char mode );
1799 #endif /* MBEDTLS_SSL_DTLS_ANTI_REPLAY */
1800 
1801 #if defined(MBEDTLS_SSL_DTLS_BADMAC_LIMIT)
1802 
1825 void mbedtls_ssl_conf_dtls_badmac_limit( mbedtls_ssl_config *conf, unsigned limit );
1826 #endif /* MBEDTLS_SSL_DTLS_BADMAC_LIMIT */
1827 
1828 #if defined(MBEDTLS_SSL_PROTO_DTLS)
1829 
1859  unsigned allow_packing );
1860 
1892 void mbedtls_ssl_conf_handshake_timeout( mbedtls_ssl_config *conf, uint32_t min, uint32_t max );
1893 #endif /* MBEDTLS_SSL_PROTO_DTLS */
1894 
1895 #if defined(MBEDTLS_SSL_SRV_C)
1896 
1934  void *p_cache,
1935  int (*f_get_cache)(void *, mbedtls_ssl_session *),
1936  int (*f_set_cache)(void *, const mbedtls_ssl_session *) );
1937 #endif /* MBEDTLS_SSL_SRV_C */
1938 
1939 #if defined(MBEDTLS_SSL_CLI_C)
1940 
1955 #endif /* MBEDTLS_SSL_CLI_C */
1956 
1973  const int *ciphersuites );
1974 
1995  const int *ciphersuites,
1996  int major, int minor );
1997 
1998 #if defined(MBEDTLS_X509_CRT_PARSE_C)
1999 
2010  const mbedtls_x509_crt_profile *profile );
2011 
2024  mbedtls_x509_crt *ca_chain,
2025  mbedtls_x509_crl *ca_crl );
2026 
2064  mbedtls_x509_crt *own_cert,
2065  mbedtls_pk_context *pk_key );
2066 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2067 
2068 #if defined(MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED)
2069 
2090  const unsigned char *psk, size_t psk_len,
2091  const unsigned char *psk_identity, size_t psk_identity_len );
2092 
2093 
2107  const unsigned char *psk, size_t psk_len );
2108 
2134  int (*f_psk)(void *, mbedtls_ssl_context *, const unsigned char *,
2135  size_t),
2136  void *p_psk );
2137 #endif /* MBEDTLS_KEY_EXCHANGE__SOME__PSK_ENABLED */
2138 
2139 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_SRV_C)
2140 
2141 #if !defined(MBEDTLS_DEPRECATED_REMOVED)
2142 
2143 #if defined(MBEDTLS_DEPRECATED_WARNING)
2144 #define MBEDTLS_DEPRECATED __attribute__((deprecated))
2145 #else
2146 #define MBEDTLS_DEPRECATED
2147 #endif
2148 
2163  const char *dhm_P,
2164  const char *dhm_G );
2165 
2166 #endif /* MBEDTLS_DEPRECATED_REMOVED */
2167 
2182  const unsigned char *dhm_P, size_t P_len,
2183  const unsigned char *dhm_G, size_t G_len );
2184 
2195 #endif /* MBEDTLS_DHM_C && defined(MBEDTLS_SSL_SRV_C) */
2196 
2197 #if defined(MBEDTLS_DHM_C) && defined(MBEDTLS_SSL_CLI_C)
2198 
2207  unsigned int bitlen );
2208 #endif /* MBEDTLS_DHM_C && MBEDTLS_SSL_CLI_C */
2209 
2210 #if defined(MBEDTLS_ECP_C)
2211 
2239  const mbedtls_ecp_group_id *curves );
2240 #endif /* MBEDTLS_ECP_C */
2241 
2242 #if defined(MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED)
2243 
2262  const int *hashes );
2263 #endif /* MBEDTLS_KEY_EXCHANGE__WITH_CERT__ENABLED */
2264 
2265 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2266 
2284 int mbedtls_ssl_set_hostname( mbedtls_ssl_context *ssl, const char *hostname );
2285 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2286 
2287 #if defined(MBEDTLS_SSL_SERVER_NAME_INDICATION)
2288 
2301  mbedtls_x509_crt *own_cert,
2302  mbedtls_pk_context *pk_key );
2303 
2316  mbedtls_x509_crt *ca_chain,
2317  mbedtls_x509_crl *ca_crl );
2318 
2330  int authmode );
2331 
2356  int (*f_sni)(void *, mbedtls_ssl_context *, const unsigned char *,
2357  size_t),
2358  void *p_sni );
2359 #endif /* MBEDTLS_SSL_SERVER_NAME_INDICATION */
2360 
2361 #if defined(MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED)
2362 
2379 int mbedtls_ssl_set_hs_ecjpake_password( mbedtls_ssl_context *ssl,
2380  const unsigned char *pw,
2381  size_t pw_len );
2382 #endif /*MBEDTLS_KEY_EXCHANGE_ECJPAKE_ENABLED */
2383 
2384 #if defined(MBEDTLS_SSL_ALPN)
2385 
2397 int mbedtls_ssl_conf_alpn_protocols( mbedtls_ssl_config *conf, const char **protos );
2398 
2408 const char *mbedtls_ssl_get_alpn_protocol( const mbedtls_ssl_context *ssl );
2409 #endif /* MBEDTLS_SSL_ALPN */
2410 
2427 void mbedtls_ssl_conf_max_version( mbedtls_ssl_config *conf, int major, int minor );
2428 
2447 void mbedtls_ssl_conf_min_version( mbedtls_ssl_config *conf, int major, int minor );
2448 
2449 #if defined(MBEDTLS_SSL_FALLBACK_SCSV) && defined(MBEDTLS_SSL_CLI_C)
2450 
2469 void mbedtls_ssl_conf_fallback( mbedtls_ssl_config *conf, char fallback );
2470 #endif /* MBEDTLS_SSL_FALLBACK_SCSV && MBEDTLS_SSL_CLI_C */
2471 
2472 #if defined(MBEDTLS_SSL_ENCRYPT_THEN_MAC)
2473 
2485 #endif /* MBEDTLS_SSL_ENCRYPT_THEN_MAC */
2486 
2487 #if defined(MBEDTLS_SSL_EXTENDED_MASTER_SECRET)
2488 
2500 #endif /* MBEDTLS_SSL_EXTENDED_MASTER_SECRET */
2501 
2502 #if defined(MBEDTLS_ARC4_C)
2503 
2518 void mbedtls_ssl_conf_arc4_support( mbedtls_ssl_config *conf, char arc4 );
2519 #endif /* MBEDTLS_ARC4_C */
2520 
2521 #if defined(MBEDTLS_SSL_SRV_C)
2522 
2532  char cert_req_ca_list );
2533 #endif /* MBEDTLS_SSL_SRV_C */
2534 
2535 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
2536 
2564 int mbedtls_ssl_conf_max_frag_len( mbedtls_ssl_config *conf, unsigned char mfl_code );
2565 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
2566 
2567 #if defined(MBEDTLS_SSL_TRUNCATED_HMAC)
2568 
2576 void mbedtls_ssl_conf_truncated_hmac( mbedtls_ssl_config *conf, int truncate );
2577 #endif /* MBEDTLS_SSL_TRUNCATED_HMAC */
2578 
2579 #if defined(MBEDTLS_SSL_CBC_RECORD_SPLITTING)
2580 
2592 #endif /* MBEDTLS_SSL_CBC_RECORD_SPLITTING */
2593 
2594 #if defined(MBEDTLS_SSL_SESSION_TICKETS) && defined(MBEDTLS_SSL_CLI_C)
2595 
2605 void mbedtls_ssl_conf_session_tickets( mbedtls_ssl_config *conf, int use_tickets );
2606 #endif /* MBEDTLS_SSL_SESSION_TICKETS && MBEDTLS_SSL_CLI_C */
2607 
2608 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2609 
2626 void mbedtls_ssl_conf_renegotiation( mbedtls_ssl_config *conf, int renegotiation );
2627 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2628 
2656 void mbedtls_ssl_conf_legacy_renegotiation( mbedtls_ssl_config *conf, int allow_legacy );
2657 
2658 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2659 
2696 void mbedtls_ssl_conf_renegotiation_enforced( mbedtls_ssl_config *conf, int max_records );
2697 
2724  const unsigned char period[8] );
2725 #endif /* MBEDTLS_SSL_RENEGOTIATION */
2726 
2766 
2783 
2796 uint32_t mbedtls_ssl_get_verify_result( const mbedtls_ssl_context *ssl );
2797 
2805 const char *mbedtls_ssl_get_ciphersuite( const mbedtls_ssl_context *ssl );
2806 
2814 const char *mbedtls_ssl_get_version( const mbedtls_ssl_context *ssl );
2815 
2830 
2831 #if defined(MBEDTLS_SSL_MAX_FRAGMENT_LENGTH)
2832 
2845 #endif /* MBEDTLS_SSL_MAX_FRAGMENT_LENGTH */
2846 
2874 
2875 #if defined(MBEDTLS_X509_CRT_PARSE_C)
2876 
2891 #endif /* MBEDTLS_X509_CRT_PARSE_C */
2892 
2893 #if defined(MBEDTLS_SSL_CLI_C)
2894 
2921 #endif /* MBEDTLS_SSL_CLI_C */
2922 
2974 
2996 
2997 #if defined(MBEDTLS_SSL_RENEGOTIATION)
2998 
3022 #endif /* MBEDTLS_SSL_RENEGOTIATION */
3023 
3094 int mbedtls_ssl_read( mbedtls_ssl_context *ssl, unsigned char *buf, size_t len );
3095 
3156 int mbedtls_ssl_write( mbedtls_ssl_context *ssl, const unsigned char *buf, size_t len );
3157 
3175  unsigned char level,
3176  unsigned char message );
3191 
3198 
3210 
3227  int endpoint, int transport, int preset );
3228 
3235 
3242 
3253 
3254 #ifdef __cplusplus
3255 }
3256 #endif
3257 
3258 #endif /* ssl.h */