diff options
-rw-r--r-- | doc/man3/SSL_get_rpoll_descriptor.pod | 26 | ||||
-rw-r--r-- | include/internal/quic_reactor.h | 12 | ||||
-rw-r--r-- | include/internal/quic_ssl.h | 4 | ||||
-rw-r--r-- | include/openssl/ssl.h.in | 4 | ||||
-rw-r--r-- | ssl/quic/quic_channel.c | 22 | ||||
-rw-r--r-- | ssl/quic/quic_impl.c | 12 | ||||
-rw-r--r-- | ssl/quic/quic_reactor.c | 20 | ||||
-rw-r--r-- | ssl/ssl_lib.c | 8 | ||||
-rw-r--r-- | util/libssl.num | 4 |
9 files changed, 56 insertions, 56 deletions
diff --git a/doc/man3/SSL_get_rpoll_descriptor.pod b/doc/man3/SSL_get_rpoll_descriptor.pod index 62378576f0..475aac6a44 100644 --- a/doc/man3/SSL_get_rpoll_descriptor.pod +++ b/doc/man3/SSL_get_rpoll_descriptor.pod @@ -2,8 +2,8 @@ =head1 NAME -SSL_get_rpoll_descriptor, SSL_get_wpoll_descriptor, SSL_want_net_read, -SSL_want_net_write - obtain information which can be used to determine when +SSL_get_rpoll_descriptor, SSL_get_wpoll_descriptor, SSL_net_read_desired, +SSL_net_write_desired - obtain information which can be used to determine when network I/O can be performed =head1 SYNOPSIS @@ -12,8 +12,8 @@ network I/O can be performed int SSL_get_rpoll_descriptor(SSL *s, BIO_POLL_DESCRIPTOR *desc); int SSL_get_wpoll_descriptor(SSL *s, BIO_POLL_DESCRIPTOR *desc); - int SSL_want_net_read(SSL *s); - int SSL_want_net_write(SSL *s); + int SSL_net_read_desired(SSL *s); + int SSL_net_write_desired(SSL *s); =head1 DESCRIPTION @@ -25,13 +25,13 @@ object in nonblocking mode can determine when it should call SSL_tick(). On success, these functions output poll descriptors. For more information on poll descriptors, see L<BIO_get_rpoll_descriptor(3)>. -The functions SSL_want_net_read() and SSL_want_net_write() return 1 or 0 +The functions SSL_net_read_desired() and SSL_net_write_desired() return 1 or 0 depending on whether the SSL object is currently interested in receiving data from the network and/or writing data to the network respectively. If an SSL object is not interested in reading data from the network at the -current time, SSL_want_net_read() will return 0; likewise, if an SSL object is +current time, SSL_net_read_desired() will return 0; likewise, if an SSL object is not interested in writing data to the network at the current time, -SSL_want_net_write() will return 0. +SSL_net_write_desired() will return 0. The intention is that an application using QUIC in nonblocking mode can use these calls, in conjunction with L<SSL_get_tick_timeout(3)> to wait for network @@ -49,21 +49,21 @@ SSL_get_tick_timeout(3) (if any) expires =item * -If the last call to SSL_want_net_read() returned 1, SSL_tick() should be called +If the last call to SSL_net_read_desired() returned 1, SSL_tick() should be called whenever the poll descriptor output by SSL_get_rpoll_descriptor() becomes readable. =item * -If the last call to SSL_want_net_write() returned 1, SSL_tick() should be called +If the last call to SSL_net_write_desired() returned 1, SSL_tick() should be called whenever the poll descriptor output by SSL_get_wpoll_descriptor() becomes writable. =back -The return values of the SSL_want_net_read() and SSL_want_net_write() functions +The return values of the SSL_net_read_desired() and SSL_net_write_desired() functions may change in response to any call to the SSL object other than -SSL_want_net_read(), SSL_want_net_write(), SSL_get_rpoll_descriptor(), +SSL_net_read_desired(), SSL_net_write_desired(), SSL_get_rpoll_descriptor(), SSL_get_wpoll_descriptor() and SSL_get_tick_timeout(). These functions are not supported on non-QUIC SSL objects. @@ -78,8 +78,8 @@ L<SSL_tick(3)>, L<SSL_get_tick_timeout(3)>, L<ssl(7)> =head1 HISTORY -The SSL_get_rpoll_descriptor(), SSL_get_wpoll_descriptor(), SSL_want_net_read() -and SSL_want_net_write() functions were added in OpenSSL 3.2. +The SSL_get_rpoll_descriptor(), SSL_get_wpoll_descriptor(), SSL_net_read_desired() +and SSL_net_write_desired() functions were added in OpenSSL 3.2. =head1 COPYRIGHT diff --git a/include/internal/quic_reactor.h b/include/internal/quic_reactor.h index 90243e936b..b2bd980b6a 100644 --- a/include/internal/quic_reactor.h +++ b/include/internal/quic_reactor.h @@ -68,8 +68,8 @@ * the reactor interface. */ typedef struct quic_tick_result_st { - char want_net_read; - char want_net_write; + char net_read_desired; + char net_write_desired; OSSL_TIME tick_deadline; } QUIC_TICK_RESULT; @@ -92,8 +92,8 @@ typedef struct quic_reactor_st { * These are true if we would like to know when we can read or write from * the network respectively. */ - unsigned int want_net_read : 1; - unsigned int want_net_write : 1; + unsigned int net_read_desired : 1; + unsigned int net_write_desired : 1; } QUIC_REACTOR; void ossl_quic_reactor_init(QUIC_REACTOR *rtor, @@ -111,9 +111,9 @@ const BIO_POLL_DESCRIPTOR *ossl_quic_reactor_get_poll_r(QUIC_REACTOR *rtor); const BIO_POLL_DESCRIPTOR *ossl_quic_reactor_get_poll_w(QUIC_REACTOR *rtor); -int ossl_quic_reactor_want_net_read(QUIC_REACTOR *rtor); +int ossl_quic_reactor_net_read_desired(QUIC_REACTOR *rtor); -int ossl_quic_reactor_want_net_write(QUIC_REACTOR *rtor); +int ossl_quic_reactor_net_write_desired(QUIC_REACTOR *rtor); OSSL_TIME ossl_quic_reactor_get_tick_deadline(QUIC_REACTOR *rtor); diff --git a/include/internal/quic_ssl.h b/include/internal/quic_ssl.h index 899aca5b35..d319faef51 100644 --- a/include/internal/quic_ssl.h +++ b/include/internal/quic_ssl.h @@ -48,8 +48,8 @@ __owur int ossl_quic_tick(QUIC_CONNECTION *qc); __owur int ossl_quic_get_tick_timeout(QUIC_CONNECTION *qc, struct timeval *tv); __owur int ossl_quic_get_rpoll_descriptor(QUIC_CONNECTION *qc, BIO_POLL_DESCRIPTOR *d); __owur int ossl_quic_get_wpoll_descriptor(QUIC_CONNECTION *qc, BIO_POLL_DESCRIPTOR *d); -__owur int ossl_quic_get_want_net_read(QUIC_CONNECTION *qc); -__owur int ossl_quic_get_want_net_write(QUIC_CONNECTION *qc); +__owur int ossl_quic_get_net_read_desired(QUIC_CONNECTION *qc); +__owur int ossl_quic_get_net_write_desired(QUIC_CONNECTION *qc); __owur int ossl_quic_get_error(const QUIC_CONNECTION *qc, int i); __owur int ossl_quic_conn_get_blocking_mode(const QUIC_CONNECTION *qc); __owur int ossl_quic_conn_set_blocking_mode(QUIC_CONNECTION *qc, int blocking); diff --git a/include/openssl/ssl.h.in b/include/openssl/ssl.h.in index 66da9ef43c..0a44968444 100644 --- a/include/openssl/ssl.h.in +++ b/include/openssl/ssl.h.in @@ -2252,8 +2252,8 @@ int SSL_tick(SSL *s); __owur int SSL_get_tick_timeout(SSL *s, struct timeval *tv); __owur int SSL_get_rpoll_descriptor(SSL *s, BIO_POLL_DESCRIPTOR *desc); __owur int SSL_get_wpoll_descriptor(SSL *s, BIO_POLL_DESCRIPTOR *desc); -__owur int SSL_want_net_read(SSL *s); -__owur int SSL_want_net_write(SSL *s); +__owur int SSL_net_read_desired(SSL *s); +__owur int SSL_net_write_desired(SSL *s); __owur int SSL_set_blocking_mode(SSL *s, int blocking); __owur int SSL_get_blocking_mode(SSL *s); __owur int SSL_set_initial_peer_addr(SSL *s, const BIO_ADDR *peer_addr); diff --git a/ssl/quic/quic_channel.c b/ssl/quic/quic_channel.c index 0fb5c6d5d3..209309a424 100644 --- a/ssl/quic/quic_channel.c +++ b/ssl/quic/quic_channel.c @@ -998,9 +998,9 @@ static void ch_tick(QUIC_TICK_RESULT *res, void *arg) /* If we are in the TERMINATED state, there is nothing to do. */ if (ossl_quic_channel_is_terminated(ch)) { - res->want_net_read = 0; - res->want_net_write = 0; - res->tick_deadline = ossl_time_infinite(); + res->net_read_desired = 0; + res->net_write_desired = 0; + res->tick_deadline = ossl_time_infinite(); return; } @@ -1013,9 +1013,9 @@ static void ch_tick(QUIC_TICK_RESULT *res, void *arg) if (ossl_time_compare(now, ch->terminate_deadline) >= 0) { ch_on_terminating_timeout(ch); - res->want_net_read = 0; - res->want_net_write = 0; - res->tick_deadline = ossl_time_infinite(); + res->net_read_desired = 0; + res->net_write_desired = 0; + res->tick_deadline = ossl_time_infinite(); return; /* abort normal processing, nothing to do */ } } @@ -1057,9 +1057,9 @@ static void ch_tick(QUIC_TICK_RESULT *res, void *arg) * send a CONN_CLOSE frame; go straight to TERMINATED. */ ch_on_idle_timeout(ch); - res->want_net_read = 0; - res->want_net_write = 0; - res->tick_deadline = ossl_time_infinite(); + res->net_read_desired = 0; + res->net_write_desired = 0; + res->tick_deadline = ossl_time_infinite(); return; } @@ -1079,10 +1079,10 @@ static void ch_tick(QUIC_TICK_RESULT *res, void *arg) * errors in ch_rx_pre() or ch_tx() may have caused us to transition to the * Terminated state. */ - res->want_net_read = !ossl_quic_channel_is_terminated(ch); + res->net_read_desired = !ossl_quic_channel_is_terminated(ch); /* We want to write to the network if we have any in our queue. */ - res->want_net_write + res->net_write_desired = (!ossl_quic_channel_is_terminated(ch) && ossl_qtx_get_queue_len_datagrams(ch->qtx) > 0); } diff --git a/ssl/quic/quic_impl.c b/ssl/quic/quic_impl.c index 991605c36a..c5490cd075 100644 --- a/ssl/quic/quic_impl.c +++ b/ssl/quic/quic_impl.c @@ -445,22 +445,22 @@ int ossl_quic_get_wpoll_descriptor(QUIC_CONNECTION *qc, BIO_POLL_DESCRIPTOR *des return BIO_get_wpoll_descriptor(qc->net_wbio, desc); } -/* SSL_want_net_read */ -int ossl_quic_get_want_net_read(QUIC_CONNECTION *qc) +/* SSL_net_read_desired */ +int ossl_quic_get_net_read_desired(QUIC_CONNECTION *qc) { if (qc->ch == NULL) return 0; - return ossl_quic_reactor_want_net_read(ossl_quic_channel_get_reactor(qc->ch)); + return ossl_quic_reactor_net_read_desired(ossl_quic_channel_get_reactor(qc->ch)); } -/* SSL_want_net_write */ -int ossl_quic_get_want_net_write(QUIC_CONNECTION *qc) +/* SSL_net_write_desired */ +int ossl_quic_get_net_write_desired(QUIC_CONNECTION *qc) { if (qc->ch == NULL) return 0; - return ossl_quic_reactor_want_net_write(ossl_quic_channel_get_reactor(qc->ch)); + return ossl_quic_reactor_net_write_desired(ossl_quic_channel_get_reactor(qc->ch)); } /* diff --git a/ssl/quic/quic_reactor.c b/ssl/quic/quic_reactor.c index aa4cff9a1d..95a54ad6b7 100644 --- a/ssl/quic/quic_reactor.c +++ b/ssl/quic/quic_reactor.c @@ -20,8 +20,8 @@ void ossl_quic_reactor_init(QUIC_REACTOR *rtor, { rtor->poll_r.type = BIO_POLL_DESCRIPTOR_TYPE_NONE; rtor->poll_w.type = BIO_POLL_DESCRIPTOR_TYPE_NONE; - rtor->want_net_read = 0; - rtor->want_net_write = 0; + rtor->net_read_desired = 0; + rtor->net_write_desired = 0; rtor->tick_deadline = initial_tick_deadline; rtor->tick_cb = tick_cb; @@ -48,14 +48,14 @@ const BIO_POLL_DESCRIPTOR *ossl_quic_reactor_get_poll_w(QUIC_REACTOR *rtor) return &rtor->poll_w; } -int ossl_quic_reactor_want_net_read(QUIC_REACTOR *rtor) +int ossl_quic_reactor_net_read_desired(QUIC_REACTOR *rtor) { - return rtor->want_net_read; + return rtor->net_read_desired; } -int ossl_quic_reactor_want_net_write(QUIC_REACTOR *rtor) +int ossl_quic_reactor_net_write_desired(QUIC_REACTOR *rtor) { - return rtor->want_net_write; + return rtor->net_write_desired; } OSSL_TIME ossl_quic_reactor_get_tick_deadline(QUIC_REACTOR *rtor) @@ -76,8 +76,8 @@ int ossl_quic_reactor_tick(QUIC_REACTOR *rtor) */ rtor->tick_cb(&res, rtor->tick_cb_arg); - rtor->want_net_read = res.want_net_read; - rtor->want_net_write = res.want_net_write; + rtor->net_read_desired = res.net_read_desired; + rtor->net_write_desired = res.net_write_desired; rtor->tick_deadline = res.tick_deadline; return 1; } @@ -280,9 +280,9 @@ int ossl_quic_reactor_block_until_pred(QUIC_REACTOR *rtor, return res; if (!poll_two_descriptors(ossl_quic_reactor_get_poll_r(rtor), - ossl_quic_reactor_want_net_read(rtor), + ossl_quic_reactor_net_read_desired(rtor), ossl_quic_reactor_get_poll_w(rtor), - ossl_quic_reactor_want_net_write(rtor), + ossl_quic_reactor_net_write_desired(rtor), ossl_quic_reactor_get_tick_deadline(rtor))) /* * We don't actually care why the call succeeded (timeout, FD diff --git a/ssl/ssl_lib.c b/ssl/ssl_lib.c index 9db3c28073..39a334c989 100644 --- a/ssl/ssl_lib.c +++ b/ssl/ssl_lib.c @@ -7105,7 +7105,7 @@ int SSL_get_wpoll_descriptor(SSL *s, BIO_POLL_DESCRIPTOR *desc) #endif } -int SSL_want_net_read(SSL *s) +int SSL_net_read_desired(SSL *s) { #ifndef OPENSSL_NO_QUIC QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); @@ -7113,13 +7113,13 @@ int SSL_want_net_read(SSL *s) if (qc == NULL) return 0; - return ossl_quic_get_want_net_read(qc); + return ossl_quic_get_net_read_desired(qc); #else return 0; #endif } -int SSL_want_net_write(SSL *s) +int SSL_net_write_desired(SSL *s) { #ifndef OPENSSL_NO_QUIC QUIC_CONNECTION *qc = QUIC_CONNECTION_FROM_SSL(s); @@ -7127,7 +7127,7 @@ int SSL_want_net_write(SSL *s) if (qc == NULL) return 0; - return ossl_quic_get_want_net_write(qc); + return ossl_quic_get_net_write_desired(qc); #else return 0; #endif diff --git a/util/libssl.num b/util/libssl.num index 554c99619a..38535b11b0 100644 --- a/util/libssl.num +++ b/util/libssl.num @@ -536,8 +536,8 @@ SSL_tick ? 3_2_0 EXIST::FUNCTION: SSL_get_tick_timeout ? 3_2_0 EXIST::FUNCTION: SSL_get_rpoll_descriptor ? 3_2_0 EXIST::FUNCTION: SSL_get_wpoll_descriptor ? 3_2_0 EXIST::FUNCTION: -SSL_want_net_read ? 3_2_0 EXIST::FUNCTION: -SSL_want_net_write ? 3_2_0 EXIST::FUNCTION: SSL_set_blocking_mode ? 3_2_0 EXIST::FUNCTION: SSL_get_blocking_mode ? 3_2_0 EXIST::FUNCTION: SSL_set_initial_peer_addr ? 3_2_0 EXIST::FUNCTION: +SSL_net_read_desired ? 3_2_0 EXIST::FUNCTION: +SSL_net_write_desired ? 3_2_0 EXIST::FUNCTION: |