SSL_set1_initial_peer_addr.3ossl - Man Page

set the initial peer address for a QUIC connection

Synopsis

 #include <openssl/ssl.h>

 int SSL_set1_initial_peer_addr(SSL *s, const BIO_ADDR *addr);

Description

SSL_set1_initial_peer_addr() sets the initial destination peer address to be used for the purposes of establishing a QUIC connection in client mode. This function can be used only on a QUIC connection SSL object, and can be used only before a connection attempt is first made. addr must point to a BIO_ADDR representing a UDP destination address of the server to connect to.

Where a QUIC connection object is provided with a write BIO which supports the BIO_CTRL_DGRAM_GET_PEER control (for example, BIO_s_dgram), the initial destination peer address can be detected automatically; if BIO_CTRL_DGRAM_GET_PEER returns a valid (non-AF_UNSPEC) peer address and no valid peer address has yet been set, this will be set automatically as the initial peer address. This behaviour can be overridden by calling SSL_set1_initial_peer_addr() with a valid peer address explicitly.

The destination address used by QUIC may change over time in response to connection events, such as connection migration (where supported). SSL_set1_initial_peer_addr() configures the destination address used for initial connection establishment, and does not confer any guarantee about the destination address being used for communication at any later time in the connection lifecycle.

This function makes a copy of the address passed by the caller; the BIO_ADDR structure pointed to by addr may be freed by the caller after this function returns.

Return Values

Returns 1 on success and 0 on failure.

See Also

BIO_ADDR(3), ssl(7)

History

The SSL_set1_initial_peer_addr() function was added in OpenSSL 3.2.

Referenced By

openssl-quic.7ossl(7), ossl-guide-quic-client-block.7ossl(7).

2024-09-12 3.2.2 OpenSSL