]>
Commit | Line | Data |
---|---|---|
99e1cc7b TM |
1 | /* |
2 | * Copyright 2022 The OpenSSL Project Authors. All Rights Reserved. | |
3 | * | |
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 | |
8 | */ | |
9 | ||
10 | #include <openssl/macros.h> | |
11 | #include <openssl/objects.h> | |
22d53c88 HL |
12 | #include <openssl/sslerr.h> |
13 | #include <crypto/rand.h> | |
99e1cc7b | 14 | #include "quic_local.h" |
2723d705 | 15 | #include "internal/quic_tls.h" |
22d53c88 HL |
16 | #include "internal/quic_rx_depack.h" |
17 | #include "internal/quic_error.h" | |
18 | #include "internal/time.h" | |
99e1cc7b | 19 | |
22d53c88 | 20 | static void aon_write_finish(QUIC_CONNECTION *qc); |
e8043229 | 21 | static int ensure_channel(QUIC_CONNECTION *qc); |
22d53c88 HL |
22 | |
23 | /* | |
24 | * QUIC Front-End I/O API: Common Utilities | |
25 | * ======================================== | |
26 | */ | |
27 | ||
28 | /* | |
29 | * Block until a predicate is met. | |
30 | * | |
31 | * Precondition: Must have a channel. | |
32 | */ | |
33 | static int block_until_pred(QUIC_CONNECTION *qc, | |
34 | int (*pred)(void *arg), void *pred_arg, | |
35 | uint32_t flags) | |
36 | { | |
37 | QUIC_REACTOR *rtor; | |
38 | ||
39 | assert(qc->ch != NULL); | |
40 | ||
41 | rtor = ossl_quic_channel_get_reactor(qc->ch); | |
42 | return ossl_quic_reactor_block_until_pred(rtor, pred, pred_arg, flags); | |
43 | } | |
44 | ||
45 | /* | |
46 | * Raise a 'normal' error, meaning one that can be reported via SSL_get_error() | |
47 | * rather than via ERR. | |
48 | */ | |
49 | static int quic_raise_normal_error(QUIC_CONNECTION *qc, | |
50 | int err) | |
51 | { | |
52 | qc->last_error = err; | |
53 | return 0; | |
54 | } | |
55 | ||
56 | /* | |
57 | * Raise a 'non-normal' error, meaning any error that is not reported via | |
58 | * SSL_get_error() and must be reported via ERR. | |
59 | */ | |
60 | static int quic_raise_non_normal_error(QUIC_CONNECTION *qc, | |
61 | const char *file, | |
62 | int line, | |
63 | const char *func, | |
64 | int reason, | |
65 | const char *fmt, | |
66 | ...) | |
67 | { | |
68 | va_list args; | |
69 | ||
70 | ERR_new(); | |
71 | ERR_set_debug(file, line, func); | |
72 | ||
73 | va_start(args, fmt); | |
74 | ERR_vset_error(ERR_LIB_SSL, reason, fmt, args); | |
75 | va_end(args); | |
76 | ||
77 | qc->last_error = SSL_ERROR_SSL; | |
78 | return 0; | |
79 | } | |
80 | ||
81 | #define QUIC_RAISE_NORMAL_ERROR(qc, err) \ | |
82 | quic_raise_normal_error((qc), (err)) | |
83 | ||
84 | #define QUIC_RAISE_NON_NORMAL_ERROR(qc, reason, msg) \ | |
85 | quic_raise_non_normal_error((qc), \ | |
86 | OPENSSL_FILE, OPENSSL_LINE, \ | |
87 | OPENSSL_FUNC, \ | |
88 | (reason), \ | |
89 | (msg)) | |
90 | ||
91 | /* | |
92 | * Should be called at entry of every public function to confirm we have a valid | |
93 | * QUIC_CONNECTION. | |
94 | */ | |
95 | static ossl_inline int expect_quic_conn(const QUIC_CONNECTION *qc) | |
96 | { | |
97 | if (!ossl_assert(qc != NULL)) | |
98 | return QUIC_RAISE_NON_NORMAL_ERROR(NULL, ERR_R_INTERNAL_ERROR, NULL); | |
99 | ||
100 | return 1; | |
101 | ||
102 | } | |
103 | ||
104 | /* | |
105 | * QUIC Front-End I/O API: Initialization | |
106 | * ====================================== | |
107 | * | |
108 | * SSL_new => ossl_quic_new | |
109 | * ossl_quic_init | |
110 | * SSL_reset => ossl_quic_reset | |
111 | * SSL_clear => ossl_quic_clear | |
112 | * ossl_quic_deinit | |
113 | * SSL_free => ossl_quic_free | |
114 | * | |
115 | */ | |
116 | ||
117 | /* SSL_new */ | |
38b051a1 TM |
118 | SSL *ossl_quic_new(SSL_CTX *ctx) |
119 | { | |
22d53c88 HL |
120 | QUIC_CONNECTION *qc = NULL; |
121 | SSL *ssl_base = NULL; | |
a7f41885 | 122 | SSL_CONNECTION *sc = NULL; |
38b051a1 TM |
123 | |
124 | qc = OPENSSL_zalloc(sizeof(*qc)); | |
125 | if (qc == NULL) | |
126 | goto err; | |
127 | ||
22d53c88 HL |
128 | /* Initialise the QUIC_CONNECTION's stub header. */ |
129 | ssl_base = &qc->ssl; | |
a7f41885 | 130 | if (!ossl_ssl_init(ssl_base, ctx, ctx->method, SSL_TYPE_QUIC_CONNECTION)) { |
22d53c88 | 131 | ssl_base = NULL; |
38b051a1 TM |
132 | goto err; |
133 | } | |
38b051a1 | 134 | |
4e3a55fd | 135 | qc->tls = ossl_ssl_connection_new_int(ctx, TLS_method()); |
a7f41885 MC |
136 | if (qc->tls == NULL || (sc = SSL_CONNECTION_FROM_SSL(qc->tls)) == NULL) |
137 | goto err; | |
a7f41885 | 138 | |
22d53c88 HL |
139 | /* Channel is not created yet. */ |
140 | qc->ssl_mode = qc->ssl.ctx->mode; | |
141 | qc->last_error = SSL_ERROR_NONE; | |
142 | qc->blocking = 1; | |
a7f41885 | 143 | |
22d53c88 HL |
144 | return ssl_base; |
145 | ||
38b051a1 | 146 | err: |
22d53c88 | 147 | OPENSSL_free(qc); |
38b051a1 TM |
148 | return NULL; |
149 | } | |
150 | ||
22d53c88 HL |
151 | /* SSL_free */ |
152 | void ossl_quic_free(SSL *s) | |
153 | { | |
154 | QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); | |
155 | ||
156 | /* We should never be called on anything but a QUIC_CONNECTION. */ | |
157 | if (!expect_quic_conn(qc)) | |
158 | return; | |
159 | ||
160 | ossl_quic_channel_free(qc->ch); | |
161 | ||
d1ac77b1 HL |
162 | BIO_free(qc->net_rbio); |
163 | BIO_free(qc->net_wbio); | |
164 | ||
22d53c88 | 165 | /* Note: SSL_free calls OPENSSL_free(qc) for us */ |
a7f41885 MC |
166 | |
167 | SSL_free(qc->tls); | |
22d53c88 HL |
168 | } |
169 | ||
170 | /* SSL method init */ | |
38b051a1 | 171 | int ossl_quic_init(SSL *s) |
99e1cc7b | 172 | { |
22d53c88 HL |
173 | QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); |
174 | ||
175 | if (!expect_quic_conn(qc)) | |
176 | return 0; | |
177 | ||
178 | /* Same op as SSL_clear, forward the call. */ | |
179 | return ossl_quic_clear(s); | |
99e1cc7b TM |
180 | } |
181 | ||
22d53c88 | 182 | /* SSL method deinit */ |
38b051a1 TM |
183 | void ossl_quic_deinit(SSL *s) |
184 | { | |
22d53c88 | 185 | /* No-op. */ |
38b051a1 TM |
186 | } |
187 | ||
22d53c88 HL |
188 | /* SSL_reset */ |
189 | int ossl_quic_reset(SSL *s) | |
190 | { | |
191 | QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); | |
192 | ||
193 | if (!expect_quic_conn(qc)) | |
194 | return 0; | |
195 | ||
c8b3fdc2 | 196 | /* TODO(QUIC); Currently a no-op. */ |
22d53c88 HL |
197 | return 1; |
198 | } | |
199 | ||
200 | /* SSL_clear */ | |
201 | int ossl_quic_clear(SSL *s) | |
99e1cc7b | 202 | { |
38b051a1 TM |
203 | QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); |
204 | ||
22d53c88 HL |
205 | if (!expect_quic_conn(qc)) |
206 | return 0; | |
207 | ||
c8b3fdc2 | 208 | /* TODO(QUIC): Currently a no-op. */ |
22d53c88 HL |
209 | return 1; |
210 | } | |
38b051a1 | 211 | |
22d53c88 HL |
212 | /* |
213 | * QUIC Front-End I/O API: Network BIO Configuration | |
214 | * ================================================= | |
215 | * | |
216 | * Handling the different BIOs is difficult: | |
217 | * | |
218 | * - It is more or less a requirement that we use non-blocking network I/O; | |
219 | * we need to be able to have timeouts on recv() calls, and make best effort | |
220 | * (non blocking) send() and recv() calls. | |
221 | * | |
222 | * The only sensible way to do this is to configure the socket into | |
223 | * non-blocking mode. We could try to do select() before calling send() or | |
224 | * recv() to get a guarantee that the call will not block, but this will | |
225 | * probably run into issues with buggy OSes which generate spurious socket | |
226 | * readiness events. In any case, relying on this to work reliably does not | |
227 | * seem sane. | |
228 | * | |
229 | * Timeouts could be handled via setsockopt() socket timeout options, but | |
230 | * this depends on OS support and adds another syscall to every network I/O | |
231 | * operation. It also has obvious thread safety concerns if we want to move | |
232 | * to concurrent use of a single socket at some later date. | |
233 | * | |
234 | * Some OSes support a MSG_DONTWAIT flag which allows a single I/O option to | |
235 | * be made non-blocking. However some OSes (e.g. Windows) do not support | |
236 | * this, so we cannot rely on this. | |
237 | * | |
238 | * As such, we need to configure any FD in non-blocking mode. This may | |
239 | * confound users who pass a blocking socket to libssl. However, in practice | |
240 | * it would be extremely strange for a user of QUIC to pass an FD to us, | |
241 | * then also try and send receive traffic on the same socket(!). Thus the | |
242 | * impact of this should be limited, and can be documented. | |
243 | * | |
244 | * - We support both blocking and non-blocking operation in terms of the API | |
245 | * presented to the user. One prospect is to set the blocking mode based on | |
246 | * whether the socket passed to us was already in blocking mode. However, | |
247 | * Windows has no API for determining if a socket is in blocking mode (!), | |
248 | * therefore this cannot be done portably. Currently therefore we expose an | |
249 | * explicit API call to set this, and default to blocking mode. | |
250 | * | |
251 | * - We need to determine our initial destination UDP address. The "natural" | |
252 | * way for a user to do this is to set the peer variable on a BIO_dgram. | |
253 | * However, this has problems because BIO_dgram's peer variable is used for | |
254 | * both transmission and reception. This means it can be constantly being | |
255 | * changed to a malicious value (e.g. if some random unrelated entity on the | |
256 | * network starts sending traffic to us) on every read call. This is not a | |
257 | * direct issue because we use the 'stateless' BIO_sendmmsg and BIO_recvmmsg | |
258 | * calls only, which do not use this variable. However, we do need to let | |
259 | * the user specify the peer in a 'normal' manner. The compromise here is | |
260 | * that we grab the current peer value set at the time the write BIO is set | |
261 | * and do not read the value again. | |
262 | * | |
263 | * - We also need to support memory BIOs (e.g. BIO_dgram_pair) or custom BIOs. | |
264 | * Currently we do this by only supporting non-blocking mode. | |
265 | * | |
266 | */ | |
267 | ||
268 | /* | |
269 | * Determines what initial destination UDP address we should use, if possible. | |
270 | * If this fails the client must set the destination address manually, or use a | |
271 | * BIO which does not need a destination address. | |
272 | */ | |
273 | static int csm_analyse_init_peer_addr(BIO *net_wbio, BIO_ADDR *peer) | |
274 | { | |
75b2920a | 275 | if (BIO_dgram_get_peer(net_wbio, peer) <= 0) |
22d53c88 HL |
276 | return 0; |
277 | ||
278 | return 1; | |
279 | } | |
280 | ||
281 | void ossl_quic_conn_set0_net_rbio(QUIC_CONNECTION *qc, BIO *net_rbio) | |
282 | { | |
283 | if (qc->net_rbio == net_rbio) | |
38b051a1 | 284 | return; |
38b051a1 | 285 | |
d1ac77b1 | 286 | if (qc->ch != NULL && !ossl_quic_channel_set_net_rbio(qc->ch, net_rbio)) |
22d53c88 HL |
287 | return; |
288 | ||
d1ac77b1 | 289 | BIO_free(qc->net_rbio); |
22d53c88 HL |
290 | qc->net_rbio = net_rbio; |
291 | ||
292 | /* | |
293 | * If what we have is not pollable (e.g. a BIO_dgram_pair) disable blocking | |
294 | * mode as we do not support it for non-pollable BIOs. | |
295 | */ | |
296 | if (net_rbio != NULL) { | |
297 | BIO_POLL_DESCRIPTOR d = {0}; | |
298 | ||
299 | if (!BIO_get_rpoll_descriptor(net_rbio, &d) | |
300 | || d.type != BIO_POLL_DESCRIPTOR_TYPE_SOCK_FD) { | |
301 | qc->blocking = 0; | |
302 | qc->can_poll_net_rbio = 0; | |
303 | } else { | |
304 | qc->can_poll_net_rbio = 1; | |
305 | } | |
306 | } | |
99e1cc7b TM |
307 | } |
308 | ||
22d53c88 | 309 | void ossl_quic_conn_set0_net_wbio(QUIC_CONNECTION *qc, BIO *net_wbio) |
38b051a1 | 310 | { |
22d53c88 HL |
311 | if (qc->net_wbio == net_wbio) |
312 | return; | |
313 | ||
d1ac77b1 | 314 | if (qc->ch != NULL && !ossl_quic_channel_set_net_wbio(qc->ch, net_wbio)) |
22d53c88 HL |
315 | return; |
316 | ||
d1ac77b1 | 317 | BIO_free(qc->net_wbio); |
22d53c88 HL |
318 | qc->net_wbio = net_wbio; |
319 | ||
320 | if (net_wbio != NULL) { | |
321 | BIO_POLL_DESCRIPTOR d = {0}; | |
38b051a1 | 322 | |
22d53c88 HL |
323 | if (!BIO_get_wpoll_descriptor(net_wbio, &d) |
324 | || d.type != BIO_POLL_DESCRIPTOR_TYPE_SOCK_FD) { | |
325 | qc->blocking = 0; | |
326 | qc->can_poll_net_wbio = 0; | |
327 | } else { | |
328 | qc->can_poll_net_wbio = 1; | |
329 | } | |
38b051a1 | 330 | |
22d53c88 HL |
331 | /* |
332 | * If we do not have a peer address yet, and we have not started trying | |
333 | * to connect yet, try to autodetect one. | |
334 | */ | |
335 | if (BIO_ADDR_family(&qc->init_peer_addr) == AF_UNSPEC | |
336 | && !qc->started) { | |
337 | if (!csm_analyse_init_peer_addr(net_wbio, &qc->init_peer_addr)) | |
338 | /* best effort */ | |
339 | BIO_ADDR_clear(&qc->init_peer_addr); | |
340 | ||
341 | if (qc->ch != NULL) | |
342 | ossl_quic_channel_set_peer_addr(qc->ch, &qc->init_peer_addr); | |
343 | } | |
38b051a1 | 344 | } |
22d53c88 | 345 | } |
38b051a1 | 346 | |
22d53c88 HL |
347 | BIO *ossl_quic_conn_get_net_rbio(const QUIC_CONNECTION *qc) |
348 | { | |
349 | return qc->net_rbio; | |
38b051a1 TM |
350 | } |
351 | ||
22d53c88 HL |
352 | BIO *ossl_quic_conn_get_net_wbio(const QUIC_CONNECTION *qc) |
353 | { | |
354 | return qc->net_wbio; | |
355 | } | |
356 | ||
357 | int ossl_quic_conn_get_blocking_mode(const QUIC_CONNECTION *qc) | |
99e1cc7b | 358 | { |
22d53c88 HL |
359 | return qc->blocking; |
360 | } | |
361 | ||
362 | int ossl_quic_conn_set_blocking_mode(QUIC_CONNECTION *qc, int blocking) | |
363 | { | |
364 | /* Cannot enable blocking mode if we do not have pollable FDs. */ | |
365 | if (blocking != 0 && | |
366 | (!qc->can_poll_net_rbio || !qc->can_poll_net_wbio)) | |
367 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_UNSUPPORTED, NULL); | |
368 | ||
369 | qc->blocking = (blocking != 0); | |
99e1cc7b TM |
370 | return 1; |
371 | } | |
372 | ||
22d53c88 HL |
373 | int ossl_quic_conn_set_initial_peer_addr(QUIC_CONNECTION *qc, |
374 | const BIO_ADDR *peer_addr) | |
99e1cc7b | 375 | { |
22d53c88 HL |
376 | if (qc->started) |
377 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED, | |
378 | NULL); | |
38b051a1 | 379 | |
22d53c88 HL |
380 | if (peer_addr == NULL) { |
381 | BIO_ADDR_clear(&qc->init_peer_addr); | |
382 | return 1; | |
383 | } | |
38b051a1 | 384 | |
22d53c88 | 385 | qc->init_peer_addr = *peer_addr; |
99e1cc7b TM |
386 | return 1; |
387 | } | |
388 | ||
22d53c88 HL |
389 | /* |
390 | * QUIC Front-End I/O API: Asynchronous I/O Management | |
391 | * =================================================== | |
392 | * | |
393 | * (BIO/)SSL_tick => ossl_quic_tick | |
394 | * (BIO/)SSL_get_tick_timeout => ossl_quic_get_tick_timeout | |
395 | * (BIO/)SSL_get_poll_fd => ossl_quic_get_poll_fd | |
396 | * | |
397 | */ | |
398 | ||
399 | /* Returns 1 if the connection is being used in blocking mode. */ | |
400 | static int blocking_mode(const QUIC_CONNECTION *qc) | |
99e1cc7b | 401 | { |
22d53c88 HL |
402 | return qc->blocking; |
403 | } | |
38b051a1 | 404 | |
22d53c88 HL |
405 | /* SSL_tick; ticks the reactor. */ |
406 | int ossl_quic_tick(QUIC_CONNECTION *qc) | |
407 | { | |
408 | if (qc->ch == NULL) | |
409 | return 1; | |
38b051a1 | 410 | |
22d53c88 | 411 | ossl_quic_reactor_tick(ossl_quic_channel_get_reactor(qc->ch)); |
99e1cc7b TM |
412 | return 1; |
413 | } | |
414 | ||
22d53c88 HL |
415 | /* |
416 | * SSL_get_tick_timeout. Get the time in milliseconds until the SSL object | |
417 | * should be ticked by the application by calling SSL_tick(). tv is set to 0 if | |
418 | * the object should be ticked immediately and tv->tv_sec is set to -1 if no | |
419 | * timeout is currently active. | |
420 | */ | |
421 | int ossl_quic_get_tick_timeout(QUIC_CONNECTION *qc, struct timeval *tv) | |
99e1cc7b | 422 | { |
a1660c94 | 423 | OSSL_TIME deadline = ossl_time_infinite(); |
e44795bd | 424 | |
22d53c88 HL |
425 | if (qc->ch != NULL) |
426 | deadline | |
427 | = ossl_quic_reactor_get_tick_deadline(ossl_quic_channel_get_reactor(qc->ch)); | |
428 | ||
429 | if (ossl_time_is_infinite(deadline)) { | |
430 | tv->tv_sec = -1; | |
431 | tv->tv_usec = 0; | |
432 | return 1; | |
433 | } | |
434 | ||
a1660c94 | 435 | *tv = ossl_time_to_timeval(ossl_time_subtract(deadline, ossl_time_now())); |
22d53c88 HL |
436 | return 1; |
437 | } | |
438 | ||
439 | /* SSL_get_rpoll_descriptor */ | |
440 | int ossl_quic_get_rpoll_descriptor(QUIC_CONNECTION *qc, BIO_POLL_DESCRIPTOR *desc) | |
441 | { | |
442 | if (desc == NULL || qc->net_rbio == NULL) | |
e44795bd TM |
443 | return 0; |
444 | ||
22d53c88 | 445 | return BIO_get_rpoll_descriptor(qc->net_rbio, desc); |
99e1cc7b TM |
446 | } |
447 | ||
22d53c88 HL |
448 | /* SSL_get_wpoll_descriptor */ |
449 | int ossl_quic_get_wpoll_descriptor(QUIC_CONNECTION *qc, BIO_POLL_DESCRIPTOR *desc) | |
99e1cc7b | 450 | { |
22d53c88 HL |
451 | if (desc == NULL || qc->net_wbio == NULL) |
452 | return 0; | |
453 | ||
454 | return BIO_get_wpoll_descriptor(qc->net_wbio, desc); | |
99e1cc7b TM |
455 | } |
456 | ||
b639475a HL |
457 | /* SSL_net_read_desired */ |
458 | int ossl_quic_get_net_read_desired(QUIC_CONNECTION *qc) | |
99e1cc7b | 459 | { |
22d53c88 HL |
460 | if (qc->ch == NULL) |
461 | return 0; | |
462 | ||
b639475a | 463 | return ossl_quic_reactor_net_read_desired(ossl_quic_channel_get_reactor(qc->ch)); |
22d53c88 | 464 | } |
e44795bd | 465 | |
b639475a HL |
466 | /* SSL_net_write_desired */ |
467 | int ossl_quic_get_net_write_desired(QUIC_CONNECTION *qc) | |
22d53c88 HL |
468 | { |
469 | if (qc->ch == NULL) | |
e44795bd TM |
470 | return 0; |
471 | ||
b639475a | 472 | return ossl_quic_reactor_net_write_desired(ossl_quic_channel_get_reactor(qc->ch)); |
99e1cc7b TM |
473 | } |
474 | ||
22d53c88 HL |
475 | /* |
476 | * QUIC Front-End I/O API: Connection Lifecycle Operations | |
477 | * ======================================================= | |
478 | * | |
479 | * SSL_do_handshake => ossl_quic_do_handshake | |
480 | * SSL_set_connect_state => ossl_quic_set_connect_state | |
481 | * SSL_set_accept_state => ossl_quic_set_accept_state | |
482 | * SSL_shutdown => ossl_quic_shutdown | |
483 | * SSL_ctrl => ossl_quic_ctrl | |
484 | * (BIO/)SSL_connect => ossl_quic_connect | |
485 | * (BIO/)SSL_accept => ossl_quic_accept | |
486 | * | |
487 | */ | |
488 | ||
489 | /* SSL_shutdown */ | |
e8043229 | 490 | static int quic_shutdown_wait(void *arg) |
99e1cc7b | 491 | { |
e8043229 | 492 | QUIC_CONNECTION *qc = arg; |
22d53c88 | 493 | |
e8043229 HL |
494 | return qc->ch == NULL || ossl_quic_channel_is_terminated(qc->ch); |
495 | } | |
22d53c88 | 496 | |
e8043229 HL |
497 | int ossl_quic_conn_shutdown(QUIC_CONNECTION *qc, uint64_t flags, |
498 | const SSL_SHUTDOWN_EX_ARGS *args, | |
499 | size_t args_len) | |
500 | { | |
501 | if (!ensure_channel(qc)) | |
502 | return -1; | |
22d53c88 | 503 | |
e8043229 HL |
504 | ossl_quic_channel_local_close(qc->ch, |
505 | args != NULL ? args->quic_error_code : 0); | |
506 | ||
1d40b151 | 507 | /* TODO(QUIC): !SSL_SHUTDOWN_FLAG_NO_STREAM_FLUSH */ |
e8043229 HL |
508 | |
509 | if (ossl_quic_channel_is_terminated(qc->ch)) | |
510 | return 1; | |
511 | ||
512 | if (blocking_mode(qc) && (flags & SSL_SHUTDOWN_FLAG_RAPID) == 0) | |
513 | block_until_pred(qc, quic_shutdown_wait, NULL, 0); | |
514 | else | |
515 | ossl_quic_reactor_tick(ossl_quic_channel_get_reactor(qc->ch)); | |
516 | ||
517 | return ossl_quic_channel_is_terminated(qc->ch); | |
99e1cc7b TM |
518 | } |
519 | ||
22d53c88 | 520 | /* SSL_ctrl */ |
e44795bd | 521 | long ossl_quic_ctrl(SSL *s, int cmd, long larg, void *parg) |
99e1cc7b | 522 | { |
22d53c88 | 523 | QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); |
38b051a1 | 524 | |
22d53c88 | 525 | if (!expect_quic_conn(qc)) |
38b051a1 TM |
526 | return 0; |
527 | ||
22d53c88 HL |
528 | switch (cmd) { |
529 | case SSL_CTRL_MODE: | |
dfc227bd HL |
530 | /* Cannot enable EPW while AON write in progress. */ |
531 | if (qc->aon_write_in_progress) | |
532 | larg &= ~SSL_MODE_ENABLE_PARTIAL_WRITE; | |
533 | ||
22d53c88 | 534 | qc->ssl_mode |= (uint32_t)larg; |
22d53c88 HL |
535 | return qc->ssl_mode; |
536 | case SSL_CTRL_CLEAR_MODE: | |
537 | qc->ssl_mode &= ~(uint32_t)larg; | |
22d53c88 HL |
538 | return qc->ssl_mode; |
539 | default: | |
540 | return 0; | |
08e49012 | 541 | } |
22d53c88 HL |
542 | } |
543 | ||
544 | /* SSL_set_connect_state */ | |
545 | void ossl_quic_set_connect_state(QUIC_CONNECTION *qc) | |
546 | { | |
547 | /* Cannot be changed after handshake started */ | |
548 | if (qc->started) | |
549 | return; | |
550 | ||
551 | qc->as_server = 0; | |
552 | } | |
553 | ||
554 | /* SSL_set_accept_state */ | |
555 | void ossl_quic_set_accept_state(QUIC_CONNECTION *qc) | |
556 | { | |
557 | /* Cannot be changed after handshake started */ | |
558 | if (qc->started) | |
559 | return; | |
560 | ||
561 | qc->as_server = 1; | |
562 | } | |
563 | ||
564 | /* SSL_do_handshake */ | |
565 | struct quic_handshake_wait_args { | |
566 | QUIC_CONNECTION *qc; | |
567 | }; | |
568 | ||
569 | static int quic_handshake_wait(void *arg) | |
570 | { | |
571 | struct quic_handshake_wait_args *args = arg; | |
572 | ||
573 | if (!ossl_quic_channel_is_active(args->qc->ch)) | |
574 | return -1; | |
575 | ||
576 | if (ossl_quic_channel_is_handshake_complete(args->qc->ch)) | |
577 | return 1; | |
578 | ||
99e1cc7b TM |
579 | return 0; |
580 | } | |
581 | ||
22d53c88 | 582 | static int configure_channel(QUIC_CONNECTION *qc) |
99e1cc7b | 583 | { |
22d53c88 | 584 | assert(qc->ch != NULL); |
08e49012 | 585 | |
d1ac77b1 HL |
586 | if (!ossl_quic_channel_set_net_rbio(qc->ch, qc->net_rbio) |
587 | || !ossl_quic_channel_set_net_wbio(qc->ch, qc->net_wbio) | |
22d53c88 HL |
588 | || !ossl_quic_channel_set_peer_addr(qc->ch, &qc->init_peer_addr)) |
589 | return 0; | |
590 | ||
591 | return 1; | |
592 | } | |
593 | ||
e8043229 | 594 | static int ensure_channel(QUIC_CONNECTION *qc) |
22d53c88 HL |
595 | { |
596 | QUIC_CHANNEL_ARGS args = {0}; | |
597 | ||
598 | if (qc->ch != NULL) | |
08e49012 | 599 | return 1; |
22d53c88 HL |
600 | |
601 | args.libctx = qc->ssl.ctx->libctx; | |
602 | args.propq = qc->ssl.ctx->propq; | |
603 | args.is_server = 0; | |
2723d705 | 604 | args.tls = qc->tls; |
22d53c88 HL |
605 | |
606 | qc->ch = ossl_quic_channel_new(&args); | |
607 | if (qc->ch == NULL) | |
608 | return 0; | |
609 | ||
e8043229 HL |
610 | return 1; |
611 | } | |
612 | ||
613 | /* | |
614 | * Creates a channel and configures it with the information we have accumulated | |
615 | * via calls made to us from the application prior to starting a handshake | |
616 | * attempt. | |
617 | */ | |
618 | static int ensure_channel_and_start(QUIC_CONNECTION *qc) | |
619 | { | |
620 | if (!ensure_channel(qc)) | |
621 | return 0; | |
622 | ||
22d53c88 HL |
623 | if (!configure_channel(qc) |
624 | || !ossl_quic_channel_start(qc->ch)) { | |
625 | ossl_quic_channel_free(qc->ch); | |
626 | qc->ch = NULL; | |
627 | return 0; | |
08e49012 | 628 | } |
22d53c88 HL |
629 | |
630 | qc->stream0 = ossl_quic_channel_get_stream_by_id(qc->ch, 0); | |
631 | if (qc->stream0 == NULL) { | |
632 | ossl_quic_channel_free(qc->ch); | |
633 | qc->ch = NULL; | |
634 | return 0; | |
635 | } | |
636 | ||
637 | qc->started = 1; | |
638 | return 1; | |
99e1cc7b TM |
639 | } |
640 | ||
22d53c88 | 641 | int ossl_quic_do_handshake(QUIC_CONNECTION *qc) |
99e1cc7b | 642 | { |
22d53c88 HL |
643 | int ret; |
644 | ||
ca41f6b7 HL |
645 | if (qc->ch != NULL && ossl_quic_channel_is_handshake_complete(qc->ch)) |
646 | /* Handshake already completed. */ | |
647 | return 1; | |
648 | ||
149a8e6c | 649 | if (qc->ch != NULL && ossl_quic_channel_is_term_any(qc->ch, NULL)) |
22d53c88 HL |
650 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, SSL_R_PROTOCOL_IS_SHUTDOWN, NULL); |
651 | ||
ca41f6b7 | 652 | if (BIO_ADDR_family(&qc->init_peer_addr) == AF_UNSPEC) { |
22d53c88 | 653 | /* Peer address must have been set. */ |
ca41f6b7 HL |
654 | QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_PASSED_INVALID_ARGUMENT, NULL); |
655 | return -1; /* Non-protocol error */ | |
656 | } | |
22d53c88 | 657 | |
ca41f6b7 | 658 | if (qc->as_server) { |
22d53c88 | 659 | /* TODO(QUIC): Server mode not currently supported */ |
ca41f6b7 HL |
660 | QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_PASSED_INVALID_ARGUMENT, NULL); |
661 | return -1; /* Non-protocol error */ | |
662 | } | |
22d53c88 | 663 | |
ca41f6b7 | 664 | if (qc->net_rbio == NULL || qc->net_wbio == NULL) { |
22d53c88 | 665 | /* Need read and write BIOs. */ |
ca41f6b7 HL |
666 | QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_PASSED_INVALID_ARGUMENT, NULL); |
667 | return -1; /* Non-protocol error */ | |
668 | } | |
22d53c88 HL |
669 | |
670 | /* | |
671 | * Start connection process. Note we may come here multiple times in | |
672 | * non-blocking mode, which is fine. | |
673 | */ | |
ca41f6b7 HL |
674 | if (!ensure_channel_and_start(qc)) { |
675 | QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
676 | return -1; /* Non-protocol error */ | |
677 | } | |
22d53c88 HL |
678 | |
679 | if (ossl_quic_channel_is_handshake_complete(qc->ch)) | |
680 | /* The handshake is now done. */ | |
681 | return 1; | |
682 | ||
683 | if (blocking_mode(qc)) { | |
684 | /* In blocking mode, wait for the handshake to complete. */ | |
685 | struct quic_handshake_wait_args args; | |
686 | ||
687 | args.qc = qc; | |
688 | ||
689 | ret = block_until_pred(qc, quic_handshake_wait, &args, 0); | |
ca41f6b7 HL |
690 | if (!ossl_quic_channel_is_active(qc->ch)) { |
691 | QUIC_RAISE_NON_NORMAL_ERROR(qc, SSL_R_PROTOCOL_IS_SHUTDOWN, NULL); | |
692 | return 0; /* Shutdown before completion */ | |
693 | } else if (ret <= 0) { | |
694 | QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
695 | return -1; /* Non-protocol error */ | |
696 | } | |
22d53c88 HL |
697 | |
698 | assert(ossl_quic_channel_is_handshake_complete(qc->ch)); | |
699 | return 1; | |
700 | } else { | |
ca41f6b7 HL |
701 | /* Try to advance the reactor. */ |
702 | ossl_quic_reactor_tick(ossl_quic_channel_get_reactor(qc->ch)); | |
703 | ||
704 | if (ossl_quic_channel_is_handshake_complete(qc->ch)) | |
705 | /* The handshake is now done. */ | |
706 | return 1; | |
707 | ||
22d53c88 | 708 | /* Otherwise, indicate that the handshake isn't done yet. */ |
ca41f6b7 HL |
709 | QUIC_RAISE_NORMAL_ERROR(qc, SSL_ERROR_WANT_READ); |
710 | return -1; /* Non-protocol error */ | |
22d53c88 | 711 | } |
99e1cc7b TM |
712 | } |
713 | ||
22d53c88 HL |
714 | /* SSL_connect */ |
715 | int ossl_quic_connect(SSL *s) | |
99e1cc7b | 716 | { |
22d53c88 HL |
717 | QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); |
718 | ||
719 | if (!expect_quic_conn(qc)) | |
720 | return 0; | |
721 | ||
722 | /* Ensure we are in connect state (no-op if non-idle). */ | |
723 | ossl_quic_set_connect_state(qc); | |
724 | ||
725 | /* Begin or continue the handshake */ | |
726 | return ossl_quic_do_handshake(qc); | |
99e1cc7b TM |
727 | } |
728 | ||
22d53c88 HL |
729 | /* SSL_accept */ |
730 | int ossl_quic_accept(SSL *s) | |
99e1cc7b | 731 | { |
22d53c88 HL |
732 | QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); |
733 | ||
734 | if (!expect_quic_conn(qc)) | |
735 | return 0; | |
736 | ||
737 | /* Ensure we are in accept state (no-op if non-idle). */ | |
738 | ossl_quic_set_accept_state(qc); | |
739 | ||
740 | /* Begin or continue the handshake */ | |
741 | return ossl_quic_do_handshake(qc); | |
99e1cc7b | 742 | } |
e44795bd | 743 | |
22d53c88 HL |
744 | /* |
745 | * QUIC Front-End I/O API: Steady-State Operations | |
746 | * =============================================== | |
747 | * | |
748 | * Here we dispatch calls to the steady-state front-end I/O API functions; that | |
749 | * is, the functions used during the established phase of a QUIC connection | |
750 | * (e.g. SSL_read, SSL_write). | |
751 | * | |
752 | * Each function must handle both blocking and non-blocking modes. As discussed | |
753 | * above, all QUIC I/O is implemented using non-blocking mode internally. | |
754 | * | |
755 | * SSL_get_error => partially implemented by ossl_quic_get_error | |
756 | * (BIO/)SSL_read => ossl_quic_read | |
757 | * (BIO/)SSL_write => ossl_quic_write | |
758 | * SSL_pending => ossl_quic_pending | |
a9979965 | 759 | * SSL_stream_conclude => ossl_quic_conn_stream_conclude |
22d53c88 HL |
760 | */ |
761 | ||
762 | /* SSL_get_error */ | |
763 | int ossl_quic_get_error(const QUIC_CONNECTION *qc, int i) | |
e44795bd | 764 | { |
22d53c88 | 765 | return qc->last_error; |
e44795bd TM |
766 | } |
767 | ||
22d53c88 HL |
768 | /* |
769 | * SSL_write | |
770 | * --------- | |
771 | * | |
772 | * The set of functions below provide the implementation of the public SSL_write | |
773 | * function. We must handle: | |
774 | * | |
775 | * - both blocking and non-blocking operation at the application level, | |
776 | * depending on how we are configured; | |
777 | * | |
778 | * - SSL_MODE_ENABLE_PARTIAL_WRITE being on or off; | |
779 | * | |
780 | * - SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER. | |
781 | * | |
782 | */ | |
783 | static void quic_post_write(QUIC_CONNECTION *qc, int did_append, int do_tick) | |
784 | { | |
785 | /* | |
786 | * We have appended at least one byte to the stream. | |
787 | * Potentially mark stream as active, depending on FC. | |
788 | */ | |
789 | if (did_append) | |
790 | ossl_quic_stream_map_update_state(ossl_quic_channel_get_qsm(qc->ch), | |
791 | qc->stream0); | |
792 | ||
793 | /* | |
794 | * Try and send. | |
795 | * | |
796 | * TODO(QUIC): It is probably inefficient to try and do this immediately, | |
797 | * plus we should eventually consider Nagle's algorithm. | |
798 | */ | |
799 | if (do_tick) | |
800 | ossl_quic_reactor_tick(ossl_quic_channel_get_reactor(qc->ch)); | |
801 | } | |
802 | ||
803 | struct quic_write_again_args { | |
804 | QUIC_CONNECTION *qc; | |
805 | const unsigned char *buf; | |
806 | size_t len; | |
807 | size_t total_written; | |
808 | }; | |
809 | ||
810 | static int quic_write_again(void *arg) | |
811 | { | |
812 | struct quic_write_again_args *args = arg; | |
813 | size_t actual_written = 0; | |
814 | ||
815 | if (!ossl_quic_channel_is_active(args->qc->ch)) | |
816 | /* If connection is torn down due to an error while blocking, stop. */ | |
817 | return -2; | |
818 | ||
819 | if (!ossl_quic_sstream_append(args->qc->stream0->sstream, | |
820 | args->buf, args->len, &actual_written)) | |
821 | return -2; | |
822 | ||
823 | quic_post_write(args->qc, actual_written > 0, 0); | |
824 | ||
825 | args->buf += actual_written; | |
826 | args->len -= actual_written; | |
827 | args->total_written += actual_written; | |
828 | ||
3f0c310b | 829 | if (args->len == 0) |
22d53c88 HL |
830 | /* Written everything, done. */ |
831 | return 1; | |
832 | ||
833 | /* Not written everything yet, keep trying. */ | |
834 | return 0; | |
835 | } | |
836 | ||
837 | static int quic_write_blocking(QUIC_CONNECTION *qc, const void *buf, size_t len, | |
838 | size_t *written) | |
e44795bd | 839 | { |
22d53c88 HL |
840 | int res; |
841 | struct quic_write_again_args args; | |
842 | size_t actual_written = 0; | |
843 | ||
844 | /* First make a best effort to append as much of the data as possible. */ | |
845 | if (!ossl_quic_sstream_append(qc->stream0->sstream, buf, len, | |
846 | &actual_written)) { | |
847 | /* Stream already finished or allocation error. */ | |
848 | *written = 0; | |
849 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
850 | } | |
851 | ||
852 | quic_post_write(qc, actual_written > 0, 1); | |
853 | ||
854 | if (actual_written == len) { | |
855 | /* Managed to append everything on the first try. */ | |
856 | *written = actual_written; | |
857 | return 1; | |
858 | } | |
859 | ||
860 | /* | |
861 | * We did not manage to append all of the data immediately, so the stream | |
862 | * buffer has probably filled up. This means we need to block until some of | |
863 | * it is freed up. | |
864 | */ | |
865 | args.qc = qc; | |
866 | args.buf = (const unsigned char *)buf + actual_written; | |
867 | args.len = len - actual_written; | |
868 | args.total_written = 0; | |
869 | ||
870 | res = block_until_pred(qc, quic_write_again, &args, 0); | |
871 | if (res <= 0) { | |
872 | if (!ossl_quic_channel_is_active(qc->ch)) | |
873 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, SSL_R_PROTOCOL_IS_SHUTDOWN, NULL); | |
874 | else | |
875 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
876 | } | |
877 | ||
878 | *written = args.total_written; | |
e44795bd TM |
879 | return 1; |
880 | } | |
881 | ||
ca41f6b7 HL |
882 | /* |
883 | * Functions to manage All-or-Nothing (AON) (that is, non-ENABLE_PARTIAL_WRITE) | |
884 | * write semantics. | |
885 | */ | |
22d53c88 HL |
886 | static void aon_write_begin(QUIC_CONNECTION *qc, const unsigned char *buf, |
887 | size_t buf_len, size_t already_sent) | |
888 | { | |
889 | assert(!qc->aon_write_in_progress); | |
890 | ||
891 | qc->aon_write_in_progress = 1; | |
892 | qc->aon_buf_base = buf; | |
893 | qc->aon_buf_pos = already_sent; | |
894 | qc->aon_buf_len = buf_len; | |
895 | } | |
896 | ||
897 | static void aon_write_finish(QUIC_CONNECTION *qc) | |
898 | { | |
899 | qc->aon_write_in_progress = 0; | |
900 | qc->aon_buf_base = NULL; | |
901 | qc->aon_buf_pos = 0; | |
902 | qc->aon_buf_len = 0; | |
903 | } | |
904 | ||
905 | static int quic_write_nonblocking_aon(QUIC_CONNECTION *qc, const void *buf, | |
906 | size_t len, size_t *written) | |
e44795bd | 907 | { |
22d53c88 HL |
908 | const void *actual_buf; |
909 | size_t actual_len, actual_written = 0; | |
910 | int accept_moving_buffer | |
911 | = ((qc->ssl_mode & SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER) != 0); | |
912 | ||
913 | if (qc->aon_write_in_progress) { | |
914 | /* | |
915 | * We are in the middle of an AON write (i.e., a previous write did not | |
75b2920a HL |
916 | * manage to append all data to the SSTREAM and we have Enable Partial |
917 | * Write (EPW) mode disabled.) | |
22d53c88 HL |
918 | */ |
919 | if ((!accept_moving_buffer && qc->aon_buf_base != buf) | |
920 | || len != qc->aon_buf_len) | |
921 | /* | |
922 | * Pointer must not have changed if we are not in accept moving | |
923 | * buffer mode. Length must never change. | |
924 | */ | |
925 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, SSL_R_BAD_WRITE_RETRY, NULL); | |
926 | ||
927 | actual_buf = (unsigned char *)buf + qc->aon_buf_pos; | |
928 | actual_len = len - qc->aon_buf_pos; | |
929 | assert(actual_len > 0); | |
930 | } else { | |
931 | actual_buf = buf; | |
932 | actual_len = len; | |
933 | } | |
934 | ||
935 | /* First make a best effort to append as much of the data as possible. */ | |
936 | if (!ossl_quic_sstream_append(qc->stream0->sstream, actual_buf, actual_len, | |
937 | &actual_written)) { | |
938 | /* Stream already finished or allocation error. */ | |
939 | *written = 0; | |
940 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
941 | } | |
942 | ||
943 | quic_post_write(qc, actual_written > 0, 1); | |
944 | ||
945 | if (actual_written == actual_len) { | |
946 | /* We have sent everything. */ | |
947 | if (qc->aon_write_in_progress) { | |
948 | /* | |
949 | * We have sent everything, and we were in the middle of an AON | |
950 | * write. The output write length is the total length of the AON | |
951 | * buffer, not however many bytes we managed to write to the stream | |
952 | * in this call. | |
953 | */ | |
954 | *written = qc->aon_buf_len; | |
955 | aon_write_finish(qc); | |
956 | } else { | |
957 | *written = actual_written; | |
958 | } | |
959 | ||
960 | return 1; | |
961 | } | |
962 | ||
963 | if (qc->aon_write_in_progress) { | |
964 | /* | |
965 | * AON write is in progress but we have not written everything yet. We | |
966 | * may have managed to send zero bytes, or some number of bytes less | |
967 | * than the total remaining which need to be appended during this | |
968 | * AON operation. | |
969 | */ | |
970 | qc->aon_buf_pos += actual_written; | |
971 | assert(qc->aon_buf_pos < qc->aon_buf_len); | |
972 | return QUIC_RAISE_NORMAL_ERROR(qc, SSL_ERROR_WANT_WRITE); | |
973 | } | |
974 | ||
08e49012 | 975 | /* |
22d53c88 HL |
976 | * Not in an existing AON operation but partial write is not enabled, so we |
977 | * need to begin a new AON operation. However we needn't bother if we didn't | |
978 | * actually append anything. | |
08e49012 | 979 | */ |
22d53c88 HL |
980 | if (actual_written > 0) |
981 | aon_write_begin(qc, buf, len, actual_written); | |
e44795bd | 982 | |
22d53c88 HL |
983 | /* |
984 | * AON - We do not publicly admit to having appended anything until AON | |
985 | * completes. | |
986 | */ | |
987 | *written = 0; | |
988 | return QUIC_RAISE_NORMAL_ERROR(qc, SSL_ERROR_WANT_WRITE); | |
e44795bd TM |
989 | } |
990 | ||
22d53c88 HL |
991 | static int quic_write_nonblocking_epw(QUIC_CONNECTION *qc, const void *buf, size_t len, |
992 | size_t *written) | |
e44795bd | 993 | { |
22d53c88 HL |
994 | /* Simple best effort operation. */ |
995 | if (!ossl_quic_sstream_append(qc->stream0->sstream, buf, len, written)) { | |
996 | /* Stream already finished or allocation error. */ | |
997 | *written = 0; | |
998 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
999 | } | |
1000 | ||
1001 | quic_post_write(qc, *written > 0, 1); | |
e44795bd TM |
1002 | return 1; |
1003 | } | |
d5ab48a1 | 1004 | |
22d53c88 | 1005 | int ossl_quic_write(SSL *s, const void *buf, size_t len, size_t *written) |
d5ab48a1 | 1006 | { |
22d53c88 HL |
1007 | QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); |
1008 | int partial_write = ((qc->ssl_mode & SSL_MODE_ENABLE_PARTIAL_WRITE) != 0); | |
1009 | ||
1010 | *written = 0; | |
1011 | ||
1012 | if (!expect_quic_conn(qc)) | |
1013 | return 0; | |
1014 | ||
149a8e6c | 1015 | if (qc->ch != NULL && ossl_quic_channel_is_term_any(qc->ch, NULL)) |
22d53c88 HL |
1016 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, SSL_R_PROTOCOL_IS_SHUTDOWN, NULL); |
1017 | ||
ca41f6b7 HL |
1018 | /* |
1019 | * If we haven't finished the handshake, try to advance it. | |
1020 | * We don't accept writes until the handshake is completed. | |
1021 | */ | |
1022 | if (ossl_quic_do_handshake(qc) < 1) | |
1023 | return 0; | |
1024 | ||
22d53c88 HL |
1025 | if (qc->stream0 == NULL || qc->stream0->sstream == NULL) |
1026 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
1027 | ||
1028 | if (blocking_mode(qc)) | |
1029 | return quic_write_blocking(qc, buf, len, written); | |
1030 | else if (partial_write) | |
1031 | return quic_write_nonblocking_epw(qc, buf, len, written); | |
1032 | else | |
1033 | return quic_write_nonblocking_aon(qc, buf, len, written); | |
d5ab48a1 RL |
1034 | } |
1035 | ||
1036 | /* | |
22d53c88 HL |
1037 | * SSL_read |
1038 | * -------- | |
d5ab48a1 | 1039 | */ |
22d53c88 HL |
1040 | struct quic_read_again_args { |
1041 | QUIC_CONNECTION *qc; | |
1042 | QUIC_STREAM *stream; | |
1043 | void *buf; | |
1044 | size_t len; | |
1045 | size_t *bytes_read; | |
1046 | int peek; | |
1047 | }; | |
1048 | ||
1049 | static int quic_read_actual(QUIC_CONNECTION *qc, | |
1050 | QUIC_STREAM *stream, | |
1051 | void *buf, size_t buf_len, | |
1052 | size_t *bytes_read, | |
1053 | int peek) | |
d5ab48a1 | 1054 | { |
22d53c88 HL |
1055 | int is_fin = 0; |
1056 | ||
a9979965 HL |
1057 | /* If the receive part of the stream is over, issue EOF. */ |
1058 | if (stream->recv_fin_retired) | |
1059 | return QUIC_RAISE_NORMAL_ERROR(qc, SSL_ERROR_ZERO_RETURN); | |
1060 | ||
22d53c88 HL |
1061 | if (stream->rstream == NULL) |
1062 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
1063 | ||
1064 | if (peek) { | |
1065 | if (!ossl_quic_rstream_peek(stream->rstream, buf, buf_len, | |
1066 | bytes_read, &is_fin)) | |
1067 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
1068 | ||
1069 | } else { | |
1070 | if (!ossl_quic_rstream_read(stream->rstream, buf, buf_len, | |
1071 | bytes_read, &is_fin)) | |
1072 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
1073 | } | |
1074 | ||
1075 | if (!peek) { | |
1076 | if (*bytes_read > 0) { | |
1077 | /* | |
1078 | * We have read at least one byte from the stream. Inform stream-level | |
1079 | * RXFC of the retirement of controlled bytes. Update the active stream | |
1080 | * status (the RXFC may now want to emit a frame granting more credit to | |
1081 | * the peer). | |
1082 | */ | |
1083 | OSSL_RTT_INFO rtt_info; | |
d50e750e | 1084 | |
22d53c88 HL |
1085 | ossl_statm_get_rtt_info(ossl_quic_channel_get_statm(qc->ch), &rtt_info); |
1086 | ||
1087 | if (!ossl_quic_rxfc_on_retire(&qc->stream0->rxfc, *bytes_read, | |
1088 | rtt_info.smoothed_rtt)) | |
1089 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
1090 | } | |
1091 | ||
1092 | if (is_fin) | |
1093 | stream->recv_fin_retired = 1; | |
1094 | ||
1095 | if (*bytes_read > 0) | |
1096 | ossl_quic_stream_map_update_state(ossl_quic_channel_get_qsm(qc->ch), | |
1097 | qc->stream0); | |
1098 | } | |
1099 | ||
d5ab48a1 RL |
1100 | return 1; |
1101 | } | |
1102 | ||
22d53c88 | 1103 | static int quic_read_again(void *arg) |
d5ab48a1 | 1104 | { |
22d53c88 HL |
1105 | struct quic_read_again_args *args = arg; |
1106 | ||
a9979965 | 1107 | if (!ossl_quic_channel_is_active(args->qc->ch)) { |
22d53c88 | 1108 | /* If connection is torn down due to an error while blocking, stop. */ |
a9979965 | 1109 | QUIC_RAISE_NON_NORMAL_ERROR(args->qc, SSL_R_PROTOCOL_IS_SHUTDOWN, NULL); |
ca41f6b7 | 1110 | return -1; |
a9979965 | 1111 | } |
22d53c88 HL |
1112 | |
1113 | if (!quic_read_actual(args->qc, args->stream, | |
1114 | args->buf, args->len, args->bytes_read, | |
1115 | args->peek)) | |
1116 | return -1; | |
1117 | ||
1118 | if (*args->bytes_read > 0) | |
1119 | /* got at least one byte, the SSL_read op can finish now */ | |
1120 | return 1; | |
1121 | ||
81b6b43c | 1122 | return 0; /* did not read anything, keep trying */ |
d5ab48a1 RL |
1123 | } |
1124 | ||
22d53c88 | 1125 | static int quic_read(SSL *s, void *buf, size_t len, size_t *bytes_read, int peek) |
d5ab48a1 | 1126 | { |
22d53c88 HL |
1127 | int res; |
1128 | QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); | |
1129 | struct quic_read_again_args args; | |
1130 | ||
1131 | *bytes_read = 0; | |
1132 | ||
1133 | if (!expect_quic_conn(qc)) | |
1134 | return 0; | |
1135 | ||
149a8e6c | 1136 | if (qc->ch != NULL && ossl_quic_channel_is_term_any(qc->ch, NULL)) |
22d53c88 HL |
1137 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, SSL_R_PROTOCOL_IS_SHUTDOWN, NULL); |
1138 | ||
a9979965 | 1139 | /* If we haven't finished the handshake, try to advance it. */ |
ca41f6b7 | 1140 | if (ossl_quic_do_handshake(qc) < 1) |
a9979965 | 1141 | return 0; /* ossl_quic_do_handshake raised error here */ |
22d53c88 HL |
1142 | |
1143 | if (qc->stream0 == NULL) | |
1144 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
1145 | ||
1146 | if (!quic_read_actual(qc, qc->stream0, buf, len, bytes_read, peek)) | |
a9979965 | 1147 | return 0; /* quic_read_actual raised error here */ |
22d53c88 HL |
1148 | |
1149 | if (*bytes_read > 0) { | |
1150 | /* | |
1151 | * Even though we succeeded, tick the reactor here to ensure we are | |
1152 | * handling other aspects of the QUIC connection. | |
1153 | */ | |
1154 | ossl_quic_reactor_tick(ossl_quic_channel_get_reactor(qc->ch)); | |
1155 | return 1; | |
1156 | } else if (blocking_mode(qc)) { | |
1157 | /* | |
1158 | * We were not able to read anything immediately, so our stream | |
1159 | * buffer is empty. This means we need to block until we get | |
1160 | * at least one byte. | |
1161 | */ | |
1162 | args.qc = qc; | |
1163 | args.stream = qc->stream0; | |
1164 | args.buf = buf; | |
1165 | args.len = len; | |
1166 | args.bytes_read = bytes_read; | |
1167 | args.peek = peek; | |
1168 | ||
1169 | res = block_until_pred(qc, quic_read_again, &args, 0); | |
a9979965 HL |
1170 | if (res == 0) |
1171 | return QUIC_RAISE_NON_NORMAL_ERROR(qc, ERR_R_INTERNAL_ERROR, NULL); | |
1172 | else if (res < 0) | |
1173 | return 0; /* quic_read_again raised error here */ | |
22d53c88 | 1174 | |
af8b52cf HL |
1175 | return 1; |
1176 | } else { | |
1177 | /* We did not get any bytes and are not in blocking mode. */ | |
1178 | return QUIC_RAISE_NORMAL_ERROR(qc, SSL_ERROR_WANT_READ); | |
1179 | } | |
d5ab48a1 RL |
1180 | } |
1181 | ||
22d53c88 HL |
1182 | int ossl_quic_read(SSL *s, void *buf, size_t len, size_t *bytes_read) |
1183 | { | |
1184 | return quic_read(s, buf, len, bytes_read, 0); | |
1185 | } | |
1186 | ||
1187 | int ossl_quic_peek(SSL *s, void *buf, size_t len, size_t *bytes_read) | |
1188 | { | |
1189 | return quic_read(s, buf, len, bytes_read, 1); | |
1190 | } | |
1191 | ||
1192 | /* | |
1193 | * SSL_pending | |
1194 | * ----------- | |
1195 | */ | |
1196 | size_t ossl_quic_pending(const SSL *s) | |
1197 | { | |
1198 | const QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_CONST_SSL(s); | |
1199 | size_t avail = 0; | |
1200 | int fin = 0; | |
1201 | ||
1202 | if (!expect_quic_conn(qc)) | |
1203 | return 0; | |
1204 | ||
1205 | if (qc->stream0 == NULL || qc->stream0->rstream == NULL) | |
1206 | /* Cannot raise errors here because we are const, just fail. */ | |
1207 | return 0; | |
1208 | ||
1209 | if (!ossl_quic_rstream_available(qc->stream0->rstream, &avail, &fin)) | |
1210 | return 0; | |
1211 | ||
1212 | return avail; | |
1213 | } | |
1214 | ||
a9979965 HL |
1215 | /* |
1216 | * SSL_stream_conclude | |
1217 | * ------------------- | |
1218 | */ | |
1219 | int ossl_quic_conn_stream_conclude(QUIC_CONNECTION *qc) | |
1220 | { | |
1221 | QUIC_STREAM *qs = qc->stream0; | |
1222 | ||
1223 | if (qs == NULL || qs->sstream == NULL) | |
1224 | return 0; | |
1225 | ||
1226 | if (!ossl_quic_channel_is_active(qc->ch) | |
1227 | || ossl_quic_sstream_get_final_size(qs->sstream, NULL)) | |
1228 | return 1; | |
1229 | ||
1230 | ossl_quic_sstream_fin(qs->sstream); | |
1231 | quic_post_write(qc, 1, 1); | |
1232 | return 1; | |
1233 | } | |
1234 | ||
22d53c88 HL |
1235 | /* |
1236 | * QUIC Front-End I/O API: SSL_CTX Management | |
1237 | * ========================================== | |
1238 | */ | |
1239 | ||
1240 | long ossl_quic_ctx_ctrl(SSL_CTX *ctx, int cmd, long larg, void *parg) | |
1241 | { | |
1242 | switch (cmd) { | |
1243 | default: | |
8a1a6d6d | 1244 | return ssl3_ctx_ctrl(ctx, cmd, larg, parg); |
22d53c88 HL |
1245 | } |
1246 | } | |
1247 | ||
1248 | long ossl_quic_callback_ctrl(SSL *s, int cmd, void (*fp) (void)) | |
1249 | { | |
8a1a6d6d | 1250 | return ssl3_callback_ctrl(s, cmd, fp); |
22d53c88 HL |
1251 | } |
1252 | ||
1253 | long ossl_quic_ctx_callback_ctrl(SSL_CTX *ctx, int cmd, void (*fp) (void)) | |
1254 | { | |
8a1a6d6d | 1255 | return ssl3_ctx_callback_ctrl(ctx, cmd, fp); |
22d53c88 HL |
1256 | } |
1257 | ||
1258 | int ossl_quic_renegotiate_check(SSL *ssl, int initok) | |
1259 | { | |
1260 | /* We never do renegotiation. */ | |
1261 | return 0; | |
1262 | } | |
1263 | ||
1264 | /* | |
1265 | * This is the subset of TLS1.3 ciphers which can be used with QUIC and which we | |
1266 | * actually support. | |
c41c7ee9 HL |
1267 | * |
1268 | * TODO(QUIC): CCM support | |
22d53c88 HL |
1269 | */ |
1270 | static SSL_CIPHER tls13_quic_ciphers[] = { | |
1271 | { | |
1272 | 1, | |
1273 | TLS1_3_RFC_AES_128_GCM_SHA256, | |
1274 | TLS1_3_RFC_AES_128_GCM_SHA256, | |
1275 | TLS1_3_CK_AES_128_GCM_SHA256, | |
1276 | SSL_kANY, | |
1277 | SSL_aANY, | |
1278 | SSL_AES128GCM, | |
1279 | SSL_AEAD, | |
1280 | TLS1_3_VERSION, TLS1_3_VERSION, | |
1281 | 0, 0, | |
1282 | SSL_HIGH, | |
1283 | SSL_HANDSHAKE_MAC_SHA256, | |
1284 | 128, | |
1285 | 128, | |
1286 | }, { | |
1287 | 1, | |
1288 | TLS1_3_RFC_AES_256_GCM_SHA384, | |
1289 | TLS1_3_RFC_AES_256_GCM_SHA384, | |
1290 | TLS1_3_CK_AES_256_GCM_SHA384, | |
1291 | SSL_kANY, | |
1292 | SSL_aANY, | |
1293 | SSL_AES256GCM, | |
1294 | SSL_AEAD, | |
1295 | TLS1_3_VERSION, TLS1_3_VERSION, | |
1296 | 0, 0, | |
1297 | SSL_HIGH, | |
1298 | SSL_HANDSHAKE_MAC_SHA384, | |
1299 | 256, | |
1300 | 256, | |
1301 | }, | |
1302 | { | |
1303 | 1, | |
1304 | TLS1_3_RFC_CHACHA20_POLY1305_SHA256, | |
1305 | TLS1_3_RFC_CHACHA20_POLY1305_SHA256, | |
1306 | TLS1_3_CK_CHACHA20_POLY1305_SHA256, | |
1307 | SSL_kANY, | |
1308 | SSL_aANY, | |
1309 | SSL_CHACHA20POLY1305, | |
1310 | SSL_AEAD, | |
1311 | TLS1_3_VERSION, TLS1_3_VERSION, | |
1312 | 0, 0, | |
1313 | SSL_HIGH, | |
1314 | SSL_HANDSHAKE_MAC_SHA256, | |
1315 | 256, | |
1316 | 256, | |
1317 | } | |
1318 | }; | |
1319 | ||
1320 | int ossl_quic_num_ciphers(void) | |
1321 | { | |
1322 | return OSSL_NELEM(tls13_quic_ciphers); | |
1323 | } | |
1324 | ||
1325 | const SSL_CIPHER *ossl_quic_get_cipher(unsigned int u) | |
1326 | { | |
1327 | if (u >= OSSL_NELEM(tls13_quic_ciphers)) | |
1328 | return NULL; | |
1329 | ||
1330 | return &tls13_quic_ciphers[u]; | |
d5ab48a1 | 1331 | } |