tokio_quiche/http3/driver/
connection.rs

1// Copyright (C) 2025, Cloudflare, Inc.
2// All rights reserved.
3//
4// Redistribution and use in source and binary forms, with or without
5// modification, are permitted provided that the following conditions are
6// met:
7//
8//     * Redistributions of source code must retain the above copyright notice,
9//       this list of conditions and the following disclaimer.
10//
11//     * Redistributions in binary form must reproduce the above copyright
12//       notice, this list of conditions and the following disclaimer in the
13//       documentation and/or other materials provided with the distribution.
14//
15// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
16// IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
17// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
18// PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
19// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
20// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
21// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
22// PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
23// LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
24// NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
25// SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26
27use std::net::SocketAddr;
28use std::sync::Arc;
29use std::sync::Mutex;
30use std::task::Poll;
31
32use datagram_socket::AsSocketStats;
33use datagram_socket::QuicAuditStats;
34use datagram_socket::ShutdownConnection;
35use datagram_socket::SocketStats;
36use quiche::ConnectionId;
37
38use super::client;
39use super::server;
40use super::DriverHooks;
41use super::H3Controller;
42use crate::quic::QuicConnectionStats;
43use crate::QuicConnection;
44
45pub type ClientH3Connection = H3Connection<client::ClientHooks>;
46pub type ServerH3Connection = H3Connection<server::ServerHooks>;
47
48/// A wrapper for an h3-driven [QuicConnection] together with the driver's
49/// [H3Controller].
50pub struct H3Connection<H: DriverHooks> {
51    pub quic_connection: QuicConnection,
52    pub h3_controller: H3Controller<H>,
53}
54
55impl<H: DriverHooks> H3Connection<H> {
56    /// Bundles `quic_connection` and `h3_controller` into a new [H3Connection].
57    pub fn new(
58        quic_connection: QuicConnection, h3_controller: H3Controller<H>,
59    ) -> Self {
60        Self {
61            quic_connection,
62            h3_controller,
63        }
64    }
65
66    /// The local address this connection listens on.
67    pub fn local_addr(&self) -> SocketAddr {
68        self.quic_connection.local_addr()
69    }
70
71    /// The remote address for this connection.
72    pub fn peer_addr(&self) -> SocketAddr {
73        self.quic_connection.peer_addr()
74    }
75
76    /// The [QuicConnection]'s audit stats.
77    pub fn audit_log_stats(&self) -> &Arc<QuicAuditStats> {
78        self.quic_connection.audit_log_stats()
79    }
80
81    /// The [QuicConnection]'s [`quiche`] stats.
82    pub fn stats(&self) -> &Arc<Mutex<QuicConnectionStats>> {
83        self.quic_connection.stats()
84    }
85
86    /// The [QuicConnection]'s source connection ID.
87    pub fn scid(&self) -> &ConnectionId<'static> {
88        self.quic_connection.scid()
89    }
90}
91
92impl<H: DriverHooks> ShutdownConnection for H3Connection<H> {
93    #[inline]
94    fn poll_shutdown(
95        &mut self, _cx: &mut std::task::Context,
96    ) -> Poll<std::io::Result<()>> {
97        // TODO: does nothing at the moment
98        Poll::Ready(Ok(()))
99    }
100}
101
102impl<H: DriverHooks> AsSocketStats for H3Connection<H> {
103    #[inline]
104    fn as_socket_stats(&self) -> SocketStats {
105        self.quic_connection.as_socket_stats()
106    }
107
108    #[inline]
109    fn as_quic_stats(&self) -> Option<&Arc<QuicAuditStats>> {
110        self.quic_connection.as_quic_stats()
111    }
112}
tokio_quiche/http3/driver/connection.rs

tokio_quiche/http3/driver/
connection.rs
