mirror of
https://github.com/openssl/openssl.git
synced 2024-12-21 06:09:35 +08:00
33ca076372
Reviewed-by: Tomas Mraz <tomas@openssl.org> Reviewed-by: Matt Caswell <matt@openssl.org> (Merged from https://github.com/openssl/openssl/pull/22674)
143 lines
4.5 KiB
C
143 lines
4.5 KiB
C
/*
|
|
* Copyright 2023 The OpenSSL Project Authors. All Rights Reserved.
|
|
*
|
|
* Licensed under the Apache License 2.0 (the "License"). You may not use
|
|
* this file except in compliance with the License. You can obtain a copy
|
|
* in the file LICENSE in the source distribution or at
|
|
* https://www.openssl.org/source/license.html
|
|
*/
|
|
#ifndef OSSL_QUIC_PORT_H
|
|
# define OSSL_QUIC_PORT_H
|
|
|
|
# include <openssl/ssl.h>
|
|
# include "internal/quic_types.h"
|
|
# include "internal/quic_reactor.h"
|
|
# include "internal/quic_demux.h"
|
|
# include "internal/quic_predef.h"
|
|
# include "internal/thread_arch.h"
|
|
|
|
# ifndef OPENSSL_NO_QUIC
|
|
|
|
/*
|
|
* QUIC Port
|
|
* =========
|
|
*
|
|
* A QUIC Port (QUIC_PORT) represents a single UDP network socket and contains
|
|
* zero or more subsidiary QUIC_CHANNEL instances, each of which represents a
|
|
* single QUIC connection. All QUIC_CHANNEL instances must belong to a
|
|
* QUIC_PORT.
|
|
*
|
|
* A QUIC port is responsible for managing a set of channels which all use the
|
|
* same UDP socket, and (in future) for automatically creating new channels when
|
|
* incoming connections are received.
|
|
*
|
|
* In order to retain compatibility with QUIC_TSERVER, it also supports a point
|
|
* of legacy compatibility where a caller can create an incoming (server role)
|
|
* channel and that channel will be automatically be bound to the next incoming
|
|
* connection. In the future this will go away once QUIC_TSERVER is removed.
|
|
*
|
|
* All QUIC_PORT instances are created by a QUIC_ENGINE.
|
|
*/
|
|
typedef struct quic_port_args_st {
|
|
/* The engine which the QUIC port is to be a child of. */
|
|
QUIC_ENGINE *engine;
|
|
|
|
/*
|
|
* This SSL_CTX will be used when constructing the handshake layer object
|
|
* inside newly created channels.
|
|
*/
|
|
SSL_CTX *channel_ctx;
|
|
|
|
/*
|
|
* If 1, this port is to be used for multiple connections, so
|
|
* non-zero-length CIDs should be used. If 0, this port will only be used
|
|
* for a single connection, so a zero-length local CID can be used.
|
|
*/
|
|
int is_multi_conn;
|
|
} QUIC_PORT_ARGS;
|
|
|
|
/* Only QUIC_ENGINE should use this function. */
|
|
QUIC_PORT *ossl_quic_port_new(const QUIC_PORT_ARGS *args);
|
|
|
|
void ossl_quic_port_free(QUIC_PORT *port);
|
|
|
|
/*
|
|
* Operations
|
|
* ==========
|
|
*/
|
|
|
|
/* Create an outgoing channel using this port. */
|
|
QUIC_CHANNEL *ossl_quic_port_create_outgoing(QUIC_PORT *port, SSL *tls);
|
|
|
|
/*
|
|
* Create an incoming channel using this port.
|
|
*
|
|
* TODO(QUIC SERVER): temporary TSERVER use only - will be removed.
|
|
*/
|
|
QUIC_CHANNEL *ossl_quic_port_create_incoming(QUIC_PORT *port, SSL *tls);
|
|
|
|
/*
|
|
* Queries and Accessors
|
|
* =====================
|
|
*/
|
|
|
|
/* Gets/sets the underlying network read and write BIO. */
|
|
BIO *ossl_quic_port_get_net_rbio(QUIC_PORT *port);
|
|
BIO *ossl_quic_port_get_net_wbio(QUIC_PORT *port);
|
|
int ossl_quic_port_set_net_rbio(QUIC_PORT *port, BIO *net_rbio);
|
|
int ossl_quic_port_set_net_wbio(QUIC_PORT *port, BIO *net_wbio);
|
|
|
|
/*
|
|
* Re-poll the network BIOs already set to determine if their support
|
|
* for polling has changed.
|
|
*/
|
|
int ossl_quic_port_update_poll_descriptors(QUIC_PORT *port);
|
|
|
|
/* Gets the engine which this port is a child of. */
|
|
QUIC_ENGINE *ossl_quic_port_get0_engine(QUIC_PORT *port);
|
|
|
|
/* Gets the reactor which can be used to tick/poll on the port. */
|
|
QUIC_REACTOR *ossl_quic_port_get0_reactor(QUIC_PORT *port);
|
|
|
|
/* Gets the demuxer belonging to the port. */
|
|
QUIC_DEMUX *ossl_quic_port_get0_demux(QUIC_PORT *port);
|
|
|
|
/* Gets the mutex used by the port. */
|
|
CRYPTO_MUTEX *ossl_quic_port_get0_mutex(QUIC_PORT *port);
|
|
|
|
/* Gets the current time. */
|
|
OSSL_TIME ossl_quic_port_get_time(QUIC_PORT *port);
|
|
|
|
int ossl_quic_port_get_rx_short_dcid_len(const QUIC_PORT *port);
|
|
int ossl_quic_port_get_tx_init_dcid_len(const QUIC_PORT *port);
|
|
|
|
/* Returns 1 if the port is running/healthy, 0 if it has failed. */
|
|
int ossl_quic_port_is_running(const QUIC_PORT *port);
|
|
|
|
/*
|
|
* Restores port-level error to the error stack. To be called only if
|
|
* the port is no longer running.
|
|
*/
|
|
void ossl_quic_port_restore_err_state(const QUIC_PORT *port);
|
|
|
|
/* For use by QUIC_ENGINE. You should not need to call this directly. */
|
|
void ossl_quic_port_subtick(QUIC_PORT *port, QUIC_TICK_RESULT *r,
|
|
uint32_t flags);
|
|
|
|
/*
|
|
* Events
|
|
* ======
|
|
*/
|
|
|
|
/*
|
|
* Called if a permanent network error occurs. Terminates all channels
|
|
* immediately. triggering_ch is an optional argument designating
|
|
* a channel which encountered the network error.
|
|
*/
|
|
void ossl_quic_port_raise_net_error(QUIC_PORT *port,
|
|
QUIC_CHANNEL *triggering_ch);
|
|
|
|
# endif
|
|
|
|
#endif
|