From ce7a9e23fb1ea249e08c3dfa9c9f701a701f2719 Mon Sep 17 00:00:00 2001 From: Hugo Landau Date: Wed, 23 Aug 2023 08:19:01 +0100 Subject: QUIC: Rename SSL_set_initial_peer_addr to SSL_set1_initial_peer_addr Fixes #21701 Reviewed-by: Tomas Mraz Reviewed-by: Matt Caswell (Merged from https://github.com/openssl/openssl/pull/21814) --- doc/designs/quic-design/quic-api-ssl-funcs.md | 3 +-- doc/designs/quic-design/quic-api.md | 8 ++++---- 2 files changed, 5 insertions(+), 6 deletions(-) (limited to 'doc/designs') diff --git a/doc/designs/quic-design/quic-api-ssl-funcs.md b/doc/designs/quic-design/quic-api-ssl-funcs.md index 6ff536b845..52e199cee6 100644 --- a/doc/designs/quic-design/quic-api-ssl-funcs.md +++ b/doc/designs/quic-design/quic-api-ssl-funcs.md @@ -629,8 +629,7 @@ Notes: | `SSL_get_wpoll_descriptor` | CSSM | 🟦N | 🟩A | 🟥QSA | 🟢Done | | `SSL_want_net_read` | CSSM | 🟦N | 🟩A | 🟥QSA | 🟢Done | | `SSL_want_net_write` | CSSM | 🟦N | 🟩A | 🟥QSA | 🟢Done | -| `SSL_get_initial_peer_addr` | CSSM | 🟦N | 🟩A | 🟥QSA | 🟢Done | -| `SSL_set_initial_peer_addr` | CSSM | 🟦N | 🟩A | 🟥QSA | 🟢Done | +| `SSL_set1_initial_peer_addr` | CSSM | 🟦N | 🟩A | 🟥QSA | 🟢Done | | `SSL_shutdown_ex` | CSSM | 🟦N | 🟩A | 🟥QSA | 🟡TODO | | `SSL_stream_conclude` | CSSM | 🟦N | 🟩A | 🟥QSA | 🟡TODO | | `SSL_stream_reset` | CSSM | 🟦N | 🟩A | 🟥QSA | 🟡TODO | diff --git a/doc/designs/quic-design/quic-api.md b/doc/designs/quic-design/quic-api.md index 332293716d..ab1c81e2f1 100644 --- a/doc/designs/quic-design/quic-api.md +++ b/doc/designs/quic-design/quic-api.md @@ -36,7 +36,7 @@ designs and the relevant design decisions. - [`SSL_get_rpoll_descriptor`, `SSL_get_wpoll_descriptor`](#-ssl-get-rpoll-descriptor----ssl-get-wpoll-descriptor-) - [`SSL_net_read_desired`, `SSL_net_write_desired`](#-ssl-want-net-read----ssl-want-net-write-) - [`SSL_want`, `SSL_want_read`, `SSL_want_write`](#-ssl-want----ssl-want-read----ssl-want-write-) - - [`SSL_set_initial_peer_addr`, `SSL_get_initial_peer_addr`](#-ssl-set-initial-peer-addr----ssl-get-initial-peer-addr-) + - [`SSL_set1_initial_peer_addr`](#-ssl-set-initial-peer-addr-) - [`SSL_shutdown_ex`](#-ssl-shutdown-ex-) - [`SSL_stream_conclude`](#-ssl-stream-conclude-) - [`SSL_stream_reset`](#-ssl-stream-reset-) @@ -519,20 +519,20 @@ write), not both. This call will not be implemented for QUIC (e.g. always returns `SSL_NOTHING`) and `SSL_net_read_desired` and `SSL_net_write_desired` will be used instead. -#### `SSL_set_initial_peer_addr`, `SSL_get_initial_peer_addr` +#### `SSL_set1_initial_peer_addr` | Semantics | `SSL_get_error` | Can Tick? | CSHL | | --------- | ------------- | --------- | ------------- | | New | Never | No | CS | -`SSL_set_initial_peer_addr` sets the initial L4 UDP peer address for an outgoing +`SSL_set1_initial_peer_addr` sets the initial L4 UDP peer address for an outgoing QUIC connection. The initial peer address may be autodetected if no peer address has already been set explicitly and the QUIC connection SSL object is provided with a `BIO_s_dgram` with a peer set. -`SSL_set_initial_peer_addr` cannot be called after a connection is established. +`SSL_set1_initial_peer_addr` cannot be called after a connection is established. #### `SSL_shutdown_ex` -- cgit v1.2.3