2 * Copyright 2022 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
11 #include <openssl/configuration.h>
12 #include <openssl/bio.h>
13 #include "quictestlib.h"
14 #include "ssltestlib.h"
15 #include "../testutil.h"
16 #if defined(OPENSSL_THREADS) && !defined(CRYPTO_TDEBUG)
17 # include "../threadstest.h"
19 #include "internal/quic_wire_pkt.h"
20 #include "internal/quic_record_tx.h"
21 #include "internal/quic_error.h"
22 #include "internal/packet.h"
24 #define GROWTH_ALLOWANCE 1024
29 /* Plain packet mutations */
30 /* Header for the plaintext packet */
31 QUIC_PKT_HDR pplainhdr
;
32 /* iovec for the plaintext packet data buffer */
33 OSSL_QTX_IOVEC pplainio
;
34 /* Allocted size of the plaintext packet data buffer */
35 size_t pplainbuf_alloc
;
36 qtest_fault_on_packet_plain_cb pplaincb
;
39 /* Handshake message mutations */
40 /* Handshake message buffer */
41 unsigned char *handbuf
;
42 /* Allocated size of the handshake message buffer */
44 /* Actual length of the handshake message */
46 qtest_fault_on_handshake_cb handshakecb
;
48 qtest_fault_on_enc_ext_cb encextcb
;
51 /* Cipher packet mutations */
52 qtest_fault_on_packet_cipher_cb pciphercb
;
55 /* Datagram mutations */
56 qtest_fault_on_datagram_cb datagramcb
;
58 /* The currently processed message */
60 /* Allocated size of msg data buffer */
64 static void packet_plain_finish(void *arg
);
65 static void handshake_finish(void *arg
);
67 static BIO_METHOD
*get_bio_method(void);
69 int qtest_create_quic_objects(OSSL_LIB_CTX
*libctx
, SSL_CTX
*clientctx
,
70 char *certfile
, char *keyfile
,
71 int block
, QUIC_TSERVER
**qtserv
, SSL
**cssl
,
74 /* ALPN value as recognised by QUIC_TSERVER */
75 unsigned char alpn
[] = { 8, 'o', 's', 's', 'l', 't', 'e', 's', 't' };
76 QUIC_TSERVER_ARGS tserver_args
= {0};
77 BIO
*cbio
= NULL
, *sbio
= NULL
, *fisbio
= NULL
;
78 BIO_ADDR
*peeraddr
= NULL
;
79 struct in_addr ina
= {0};
84 *cssl
= SSL_new(clientctx
);
88 /* SSL_set_alpn_protos returns 0 for success! */
89 if (!TEST_false(SSL_set_alpn_protos(*cssl
, alpn
, sizeof(alpn
))))
92 if (!TEST_ptr(peeraddr
= BIO_ADDR_new()))
96 #if !defined(OPENSSL_NO_POSIX_IO)
100 * For blocking mode we need to create actual sockets rather than doing
101 * everything in memory
103 if (!TEST_true(create_test_sockets(&cfd
, &sfd
, SOCK_DGRAM
, peeraddr
)))
105 cbio
= BIO_new_dgram(cfd
, 1);
106 if (!TEST_ptr(cbio
)) {
111 sbio
= BIO_new_dgram(sfd
, 1);
112 if (!TEST_ptr(sbio
)) {
120 if (!TEST_true(BIO_new_bio_dgram_pair(&cbio
, 0, &sbio
, 0)))
123 if (!TEST_true(BIO_dgram_set_caps(cbio
, BIO_DGRAM_CAP_HANDLES_DST_ADDR
))
124 || !TEST_true(BIO_dgram_set_caps(sbio
, BIO_DGRAM_CAP_HANDLES_DST_ADDR
)))
127 /* Dummy server address */
128 if (!TEST_true(BIO_ADDR_rawmake(peeraddr
, AF_INET
, &ina
, sizeof(ina
),
133 SSL_set_bio(*cssl
, cbio
, cbio
);
135 if (!TEST_true(SSL_set_blocking_mode(*cssl
, block
)))
138 if (!TEST_true(SSL_set_initial_peer_addr(*cssl
, peeraddr
)))
142 *fault
= OPENSSL_zalloc(sizeof(**fault
));
147 fisbio
= BIO_new(get_bio_method());
148 if (!TEST_ptr(fisbio
))
151 BIO_set_data(fisbio
, fault
== NULL
? NULL
: *fault
);
153 if (!TEST_ptr(BIO_push(fisbio
, sbio
)))
156 tserver_args
.libctx
= libctx
;
157 tserver_args
.net_rbio
= sbio
;
158 tserver_args
.net_wbio
= fisbio
;
160 if (!TEST_ptr(*qtserv
= ossl_quic_tserver_new(&tserver_args
, certfile
,
164 /* Ownership of fisbio and sbio is now held by *qtserv */
169 (*fault
)->qtserv
= *qtserv
;
171 BIO_ADDR_free(peeraddr
);
175 BIO_ADDR_free(peeraddr
);
181 ossl_quic_tserver_free(*qtserv
);
183 OPENSSL_free(*fault
);
188 int qtest_supports_blocking(void)
190 #if !defined(OPENSSL_NO_POSIX_IO) && defined(OPENSSL_THREADS) && !defined(CRYPTO_TDEBUG)
197 #define MAXLOOPS 1000
199 #if defined(OPENSSL_THREADS) && !defined(CRYPTO_TDEBUG)
200 static int globserverret
= 0;
201 static QUIC_TSERVER
*globtserv
;
202 static const thread_t thread_zero
;
204 static void run_server_thread(void)
207 * This will operate in a busy loop because the server does not block,
208 * but should be acceptable because it is local and we expect this to be
211 globserverret
= qtest_create_quic_connection(globtserv
, NULL
);
215 int qtest_create_quic_connection(QUIC_TSERVER
*qtserv
, SSL
*clientssl
)
217 int retc
= -1, rets
= 0, err
, abortctr
= 0, ret
= 0;
218 int clienterr
= 0, servererr
= 0;
219 #if defined(OPENSSL_THREADS) && !defined(CRYPTO_TDEBUG)
221 * Pointless initialisation to avoid bogus compiler warnings about using
224 thread_t t
= thread_zero
;
227 if (!TEST_ptr(qtserv
)) {
229 } else if (clientssl
== NULL
) {
231 } else if (SSL_get_blocking_mode(clientssl
) > 0) {
232 #if defined(OPENSSL_THREADS) && !defined(CRYPTO_TDEBUG)
234 * clientssl is blocking. We will need a thread to complete the
238 if (!TEST_true(run_thread(&t
, run_server_thread
)))
244 TEST_error("No thread support in this build");
250 err
= SSL_ERROR_WANT_WRITE
;
251 while (!clienterr
&& retc
<= 0 && err
== SSL_ERROR_WANT_WRITE
) {
252 retc
= SSL_connect(clientssl
);
254 err
= SSL_get_error(clientssl
, retc
);
257 if (!clienterr
&& retc
<= 0 && err
!= SSL_ERROR_WANT_READ
) {
258 TEST_info("SSL_connect() failed %d, %d", retc
, err
);
259 TEST_openssl_errors();
264 * We're cheating. We don't take any notice of SSL_get_tick_timeout()
265 * and tick everytime around the loop anyway. This is inefficient. We
266 * can get away with it in test code because we control both ends of
267 * the communications and don't expect network delays. This shouldn't
268 * be done in a real application.
270 if (!clienterr
&& retc
<= 0)
271 SSL_handle_events(clientssl
);
272 if (!servererr
&& rets
<= 0) {
273 ossl_quic_tserver_tick(qtserv
);
274 servererr
= ossl_quic_tserver_is_term_any(qtserv
);
276 rets
= ossl_quic_tserver_is_handshake_confirmed(qtserv
);
279 if (clienterr
&& servererr
)
282 if (clientssl
!= NULL
&& ++abortctr
== MAXLOOPS
) {
283 TEST_info("No progress made");
286 } while ((retc
<= 0 && !clienterr
) || (rets
<= 0 && !servererr
));
288 if (qtserv
== NULL
&& rets
> 0) {
289 #if defined(OPENSSL_THREADS) && !defined(CRYPTO_TDEBUG)
290 if (!TEST_true(wait_for_thread(t
)) || !TEST_true(globserverret
))
293 TEST_error("Should not happen");
298 if (!clienterr
&& !servererr
)
304 int qtest_shutdown(QUIC_TSERVER
*qtserv
, SSL
*clientssl
)
306 /* Busy loop in non-blocking mode. It should be quick because its local */
307 while (SSL_shutdown(clientssl
) != 1)
308 ossl_quic_tserver_tick(qtserv
);
313 int qtest_check_server_transport_err(QUIC_TSERVER
*qtserv
, uint64_t code
)
315 const QUIC_TERMINATE_CAUSE
*cause
;
317 ossl_quic_tserver_tick(qtserv
);
320 * Check that the server has closed with the specified code from the client
322 if (!TEST_true(ossl_quic_tserver_is_term_any(qtserv
)))
325 cause
= ossl_quic_tserver_get_terminate_cause(qtserv
);
327 || !TEST_true(cause
->remote
)
328 || !TEST_uint64_t_eq(cause
->error_code
, code
))
334 int qtest_check_server_protocol_err(QUIC_TSERVER
*qtserv
)
336 return qtest_check_server_transport_err(qtserv
, QUIC_ERR_PROTOCOL_VIOLATION
);
339 void qtest_fault_free(QTEST_FAULT
*fault
)
344 packet_plain_finish(fault
);
345 handshake_finish(fault
);
350 static int packet_plain_mutate(const QUIC_PKT_HDR
*hdrin
,
351 const OSSL_QTX_IOVEC
*iovecin
, size_t numin
,
352 QUIC_PKT_HDR
**hdrout
,
353 const OSSL_QTX_IOVEC
**iovecout
,
357 QTEST_FAULT
*fault
= arg
;
361 /* Coalesce our data into a single buffer */
363 /* First calculate required buffer size */
364 for (i
= 0; i
< numin
; i
++)
365 bufsz
+= iovecin
[i
].buf_len
;
367 fault
->pplainio
.buf_len
= bufsz
;
369 /* Add an allowance for possible growth */
370 bufsz
+= GROWTH_ALLOWANCE
;
372 fault
->pplainio
.buf
= cur
= OPENSSL_malloc(bufsz
);
374 fault
->pplainio
.buf_len
= 0;
378 fault
->pplainbuf_alloc
= bufsz
;
380 /* Copy in the data from the input buffers */
381 for (i
= 0; i
< numin
; i
++) {
382 memcpy(cur
, iovecin
[i
].buf
, iovecin
[i
].buf_len
);
383 cur
+= iovecin
[i
].buf_len
;
386 fault
->pplainhdr
= *hdrin
;
388 /* Cast below is safe because we allocated the buffer */
389 if (fault
->pplaincb
!= NULL
390 && !fault
->pplaincb(fault
, &fault
->pplainhdr
,
391 (unsigned char *)fault
->pplainio
.buf
,
392 fault
->pplainio
.buf_len
, fault
->pplaincbarg
))
395 *hdrout
= &fault
->pplainhdr
;
396 *iovecout
= &fault
->pplainio
;
402 static void packet_plain_finish(void *arg
)
404 QTEST_FAULT
*fault
= arg
;
406 /* Cast below is safe because we allocated the buffer */
407 OPENSSL_free((unsigned char *)fault
->pplainio
.buf
);
408 fault
->pplainio
.buf_len
= 0;
409 fault
->pplainbuf_alloc
= 0;
410 fault
->pplainio
.buf
= NULL
;
413 int qtest_fault_set_packet_plain_listener(QTEST_FAULT
*fault
,
414 qtest_fault_on_packet_plain_cb pplaincb
,
417 fault
->pplaincb
= pplaincb
;
418 fault
->pplaincbarg
= pplaincbarg
;
420 return ossl_quic_tserver_set_plain_packet_mutator(fault
->qtserv
,
426 /* To be called from a packet_plain_listener callback */
427 int qtest_fault_resize_plain_packet(QTEST_FAULT
*fault
, size_t newlen
)
430 size_t oldlen
= fault
->pplainio
.buf_len
;
433 * Alloc'd size should always be non-zero, so if this fails we've been
436 if (fault
->pplainbuf_alloc
== 0)
439 if (newlen
> fault
->pplainbuf_alloc
) {
440 /* This exceeds our growth allowance. Fail */
444 /* Cast below is safe because we allocated the buffer */
445 buf
= (unsigned char *)fault
->pplainio
.buf
;
447 if (newlen
> oldlen
) {
448 /* Extend packet with 0 bytes */
449 memset(buf
+ oldlen
, 0, newlen
- oldlen
);
450 } /* else we're truncating or staying the same */
452 fault
->pplainio
.buf_len
= newlen
;
453 fault
->pplainhdr
.len
= newlen
;
459 * Prepend frame data into a packet. To be called from a packet_plain_listener
462 int qtest_fault_prepend_frame(QTEST_FAULT
*fault
, unsigned char *frame
,
469 * Alloc'd size should always be non-zero, so if this fails we've been
472 if (fault
->pplainbuf_alloc
== 0)
475 /* Cast below is safe because we allocated the buffer */
476 buf
= (unsigned char *)fault
->pplainio
.buf
;
477 old_len
= fault
->pplainio
.buf_len
;
479 /* Extend the size of the packet by the size of the new frame */
480 if (!TEST_true(qtest_fault_resize_plain_packet(fault
,
481 old_len
+ frame_len
)))
484 memmove(buf
+ frame_len
, buf
, old_len
);
485 memcpy(buf
, frame
, frame_len
);
490 static int handshake_mutate(const unsigned char *msgin
, size_t msginlen
,
491 unsigned char **msgout
, size_t *msgoutlen
,
494 QTEST_FAULT
*fault
= arg
;
496 unsigned long payloadlen
;
497 unsigned int msgtype
;
500 buf
= OPENSSL_malloc(msginlen
+ GROWTH_ALLOWANCE
);
504 fault
->handbuf
= buf
;
505 fault
->handbuflen
= msginlen
;
506 fault
->handbufalloc
= msginlen
+ GROWTH_ALLOWANCE
;
507 memcpy(buf
, msgin
, msginlen
);
509 if (!PACKET_buf_init(&pkt
, buf
, msginlen
)
510 || !PACKET_get_1(&pkt
, &msgtype
)
511 || !PACKET_get_net_3(&pkt
, &payloadlen
)
512 || PACKET_remaining(&pkt
) != payloadlen
)
515 /* Parse specific message types */
517 case SSL3_MT_ENCRYPTED_EXTENSIONS
:
519 QTEST_ENCRYPTED_EXTENSIONS ee
;
521 if (fault
->encextcb
== NULL
)
525 * The EncryptedExtensions message is very simple. It just has an
526 * extensions block in it and nothing else.
528 ee
.extensions
= (unsigned char *)PACKET_data(&pkt
);
529 ee
.extensionslen
= payloadlen
;
530 if (!fault
->encextcb(fault
, &ee
, payloadlen
, fault
->encextcbarg
))
535 /* No specific handlers for these message types yet */
539 if (fault
->handshakecb
!= NULL
540 && !fault
->handshakecb(fault
, buf
, fault
->handbuflen
,
541 fault
->handshakecbarg
))
545 *msgoutlen
= fault
->handbuflen
;
550 static void handshake_finish(void *arg
)
552 QTEST_FAULT
*fault
= arg
;
554 OPENSSL_free(fault
->handbuf
);
555 fault
->handbuf
= NULL
;
558 int qtest_fault_set_handshake_listener(QTEST_FAULT
*fault
,
559 qtest_fault_on_handshake_cb handshakecb
,
560 void *handshakecbarg
)
562 fault
->handshakecb
= handshakecb
;
563 fault
->handshakecbarg
= handshakecbarg
;
565 return ossl_quic_tserver_set_handshake_mutator(fault
->qtserv
,
571 int qtest_fault_set_hand_enc_ext_listener(QTEST_FAULT
*fault
,
572 qtest_fault_on_enc_ext_cb encextcb
,
575 fault
->encextcb
= encextcb
;
576 fault
->encextcbarg
= encextcbarg
;
578 return ossl_quic_tserver_set_handshake_mutator(fault
->qtserv
,
584 /* To be called from a handshake_listener callback */
585 int qtest_fault_resize_handshake(QTEST_FAULT
*fault
, size_t newlen
)
588 size_t oldlen
= fault
->handbuflen
;
591 * Alloc'd size should always be non-zero, so if this fails we've been
594 if (fault
->handbufalloc
== 0)
597 if (newlen
> fault
->handbufalloc
) {
598 /* This exceeds our growth allowance. Fail */
602 buf
= (unsigned char *)fault
->handbuf
;
604 if (newlen
> oldlen
) {
605 /* Extend packet with 0 bytes */
606 memset(buf
+ oldlen
, 0, newlen
- oldlen
);
607 } /* else we're truncating or staying the same */
609 fault
->handbuflen
= newlen
;
613 /* To be called from message specific listener callbacks */
614 int qtest_fault_resize_message(QTEST_FAULT
*fault
, size_t newlen
)
616 /* First resize the underlying message */
617 if (!qtest_fault_resize_handshake(fault
, newlen
+ SSL3_HM_HEADER_LENGTH
))
620 /* Fixup the handshake message header */
621 fault
->handbuf
[1] = (unsigned char)((newlen
>> 16) & 0xff);
622 fault
->handbuf
[2] = (unsigned char)((newlen
>> 8) & 0xff);
623 fault
->handbuf
[3] = (unsigned char)((newlen
) & 0xff);
628 int qtest_fault_delete_extension(QTEST_FAULT
*fault
,
629 unsigned int exttype
, unsigned char *ext
,
632 PACKET pkt
, sub
, subext
;
634 const unsigned char *start
, *end
;
636 size_t msglen
= fault
->handbuflen
;
638 if (!PACKET_buf_init(&pkt
, ext
, *extlen
))
641 /* Extension block starts with 2 bytes for extension block length */
642 if (!PACKET_as_length_prefixed_2(&pkt
, &sub
))
646 start
= PACKET_data(&sub
);
647 if (!PACKET_get_net_2(&sub
, &type
)
648 || !PACKET_get_length_prefixed_2(&sub
, &subext
))
650 } while (type
!= exttype
);
653 end
= PACKET_data(&sub
);
656 * If we're not the last extension we need to move the rest earlier. The
657 * cast below is safe because we own the underlying buffer and we're no
658 * longer making PACKET calls.
660 if (end
< ext
+ *extlen
)
661 memmove((unsigned char *)start
, end
, end
- start
);
664 * Calculate new extensions payload length =
666 * - 2 extension block length bytes
667 * - length of removed extension
669 newlen
= *extlen
- 2 - (end
- start
);
671 /* Fixup the length bytes for the extension block */
672 ext
[0] = (unsigned char)((newlen
>> 8) & 0xff);
673 ext
[1] = (unsigned char)((newlen
) & 0xff);
676 * Length of the whole extension block is the new payload length plus the
677 * 2 bytes for the length
679 *extlen
= newlen
+ 2;
681 /* We can now resize the message */
682 if ((size_t)(end
- start
) + SSL3_HM_HEADER_LENGTH
> msglen
)
683 return 0; /* Should not happen */
684 msglen
-= (end
- start
) + SSL3_HM_HEADER_LENGTH
;
685 if (!qtest_fault_resize_message(fault
, msglen
))
691 #define BIO_TYPE_CIPHER_PACKET_FILTER (0x80 | BIO_TYPE_FILTER)
693 static BIO_METHOD
*pcipherbiometh
= NULL
;
695 # define BIO_MSG_N(array, stride, n) (*(BIO_MSG *)((char *)(array) + (n)*(stride)))
697 static int pcipher_sendmmsg(BIO
*b
, BIO_MSG
*msg
, size_t stride
,
698 size_t num_msg
, uint64_t flags
,
699 size_t *num_processed
)
702 BIO
*next
= BIO_next(b
);
703 ossl_ssize_t ret
= 0;
704 size_t i
= 0, tmpnump
;
707 unsigned char *tmpdata
;
712 fault
= BIO_get_data(b
);
714 || (fault
->pciphercb
== NULL
&& fault
->datagramcb
== NULL
))
715 return BIO_sendmmsg(next
, msg
, stride
, num_msg
, flags
, num_processed
);
722 for (i
= 0; i
< num_msg
; ++i
) {
723 fault
->msg
= BIO_MSG_N(msg
, stride
, i
);
725 /* Take a copy of the data so that callbacks can modify it */
726 tmpdata
= OPENSSL_malloc(fault
->msg
.data_len
+ GROWTH_ALLOWANCE
);
729 memcpy(tmpdata
, fault
->msg
.data
, fault
->msg
.data_len
);
730 fault
->msg
.data
= tmpdata
;
731 fault
->msgalloc
= fault
->msg
.data_len
+ GROWTH_ALLOWANCE
;
733 if (fault
->pciphercb
!= NULL
) {
734 if (!PACKET_buf_init(&pkt
, fault
->msg
.data
, fault
->msg
.data_len
))
738 if (!ossl_quic_wire_decode_pkt_hdr(&pkt
,
739 0 /* TODO(QUIC): Not sure how this should be set*/, 1,
744 * hdr.data is const - but its our buffer so casting away the
747 if (!fault
->pciphercb(fault
, &hdr
, (unsigned char *)hdr
.data
,
748 hdr
.len
, fault
->pciphercbarg
))
752 * TODO(QUIC): At the moment modifications to hdr by the callback
753 * are ignored. We might need to rewrite the QUIC header to
754 * enable tests to change this. We also don't yet have a
755 * mechanism for the callback to change the encrypted data
756 * length. It's not clear if that's needed or not.
758 } while (PACKET_remaining(&pkt
) > 0);
761 if (fault
->datagramcb
!= NULL
762 && !fault
->datagramcb(fault
, &fault
->msg
, stride
,
763 fault
->datagramcbarg
))
766 if (!BIO_sendmmsg(next
, &fault
->msg
, stride
, 1, flags
, &tmpnump
)) {
771 OPENSSL_free(fault
->msg
.data
);
772 fault
->msg
.data
= NULL
;
779 OPENSSL_free(fault
->msg
.data
);
780 fault
->msg
.data
= NULL
;
784 static long pcipher_ctrl(BIO
*b
, int cmd
, long larg
, void *parg
)
786 BIO
*next
= BIO_next(b
);
791 return BIO_ctrl(next
, cmd
, larg
, parg
);
794 static BIO_METHOD
*get_bio_method(void)
798 if (pcipherbiometh
!= NULL
)
799 return pcipherbiometh
;
801 tmp
= BIO_meth_new(BIO_TYPE_CIPHER_PACKET_FILTER
, "Cipher Packet Filter");
806 if (!TEST_true(BIO_meth_set_sendmmsg(tmp
, pcipher_sendmmsg
))
807 || !TEST_true(BIO_meth_set_ctrl(tmp
, pcipher_ctrl
)))
810 pcipherbiometh
= tmp
;
814 return pcipherbiometh
;
817 int qtest_fault_set_packet_cipher_listener(QTEST_FAULT
*fault
,
818 qtest_fault_on_packet_cipher_cb pciphercb
,
821 fault
->pciphercb
= pciphercb
;
822 fault
->pciphercbarg
= pciphercbarg
;
827 int qtest_fault_set_datagram_listener(QTEST_FAULT
*fault
,
828 qtest_fault_on_datagram_cb datagramcb
,
831 fault
->datagramcb
= datagramcb
;
832 fault
->datagramcbarg
= datagramcbarg
;
837 /* To be called from a datagram_listener callback */
838 int qtest_fault_resize_datagram(QTEST_FAULT
*fault
, size_t newlen
)
840 if (newlen
> fault
->msgalloc
)
843 if (newlen
> fault
->msg
.data_len
)
844 memset((unsigned char *)fault
->msg
.data
+ fault
->msg
.data_len
, 0,
845 newlen
- fault
->msg
.data_len
);
847 fault
->msg
.data_len
= newlen
;