mirror of
https://github.com/n0-computer/noq.git
synced 2026-10-12 15:59:03 +00:00
deploy: 1bf12365d0
This commit is contained in:
djc
@@ -97,7 +97,7 @@
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">2.</strong> Quinn introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">2.</strong> QUIC introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
+3
-3
@@ -95,7 +95,7 @@
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">2.</strong> Quinn introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">2.</strong> QUIC introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
@@ -208,7 +208,7 @@ However, data loss of a single packet will still block all response streams beca
|
||||
|
||||
|
||||
|
||||
<a rel="next" href="quinn.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next" href="quic.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@@ -222,7 +222,7 @@ However, data loss of a single packet will still block all response streams beca
|
||||
|
||||
|
||||
|
||||
<a rel="next" href="quinn.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next" href="quic.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
|
||||
@@ -95,7 +95,7 @@
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html" class="active"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">2.</strong> Quinn introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html" class="active"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">2.</strong> QUIC introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
@@ -208,7 +208,7 @@ However, data loss of a single packet will still block all response streams beca
|
||||
|
||||
|
||||
|
||||
<a rel="next" href="quinn.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next" href="quic.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@@ -222,7 +222,7 @@ However, data loss of a single packet will still block all response streams beca
|
||||
|
||||
|
||||
|
||||
<a rel="next" href="quinn.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next" href="quic.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
|
||||
+23
-102
@@ -97,7 +97,7 @@
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">2.</strong> Quinn introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">2.</strong> QUIC introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
@@ -202,6 +202,26 @@ To improve on this, HTTP 2 introduced request multiplexing within a TCP data str
|
||||
However, data loss of a single packet will still block all response streams because they exist within the context of a single TCP stream.</p>
|
||||
<h3 id="connection-setup-duration"><a class="header" href="#connection-setup-duration">Connection Setup Duration</a></h3>
|
||||
<p>In the usual TCP + TLS + HTTP stack, TCP needs 6 handshake messages to set up a session between server and client. TLS performs its own, sending 4 messages for setting up an initial connection over TLS 1.3. By integrating the transport protocol and TLS handshakes, QUIC can make connection setup more efficient.</p>
|
||||
<h1 id="the-quic-protocol"><a class="header" href="#the-quic-protocol">The QUIC protocol</a></h1>
|
||||
<p><a href="https://en.wikipedia.org/wiki/QUIC">QUIC</a> is a general-purpose network protocol built on top of UDP.
|
||||
The protocol is still under development and standardized by the <a href="https://www.ietf.org/">IETF</a>.
|
||||
Quinn strives to implement the latest <a href="https://datatracker.ietf.org/doc/draft-ietf-quic-transport/">draft</a> but may lag a bit behind. Although QUIC is still in a draft phase,
|
||||
the protocol is used for all connections from Chrome web browsers to the Google servers. </p>
|
||||
<p>QUIC solves a number of transport-layer and application-layer problems experienced by modern web applications.
|
||||
It is very similar to TCP+TLS+HTTP2, but implemented on top of UDP.
|
||||
Having QUIC as a self-contained protocol allows innovations which aren’t
|
||||
possible with existing protocols as they are hampered by legacy clients and middleboxes.</p>
|
||||
<p>Key advantages of QUIC over TCP+TLS+HTTP2 include:</p>
|
||||
<ul>
|
||||
<li>Improved connection establishment speed (0-rtt).</li>
|
||||
<li>Improved congestion control by moving congestion control algorithms into the user space at both endpoints.</li>
|
||||
<li>Improved bandwidth estimation in each direction to avoid congestion. </li>
|
||||
<li>Improved multiplexing without head-of-line blocking.</li>
|
||||
<li>Contains forward error correction (FEC). </li>
|
||||
</ul>
|
||||
<p>While QUIC's intentions are originally web-oriented, it offers interesting opportunities in other areas like game networking.
|
||||
One thing is for sure, QUIC has many great potentials and will serve us in the future with HTTP/3. </p>
|
||||
<p>In the upcoming chapter we will be discussing various aspects of QUIC also in relation to Quinn. </p>
|
||||
<h1 align="center"><img width="500" src="https://raw.githubusercontent.com/quinn-rs/quinn/51a3cea225670757cb844a342428e4e1341d9f13/docs/thumbnail.svg" /></h1>
|
||||
<p><a href="https://docs.rs/quinn/"><img src="https://docs.rs/quinn/badge.svg" alt="Documentation" /></a>
|
||||
<a href="https://crates.io/crates/quinn"><img src="https://img.shields.io/crates/v/quinn.svg" alt="Crates.io" /></a>
|
||||
@@ -301,106 +321,7 @@ crates will always be at least 6 months old at the time of release.</p>
|
||||
<li><strong>Benjamin Saunders</strong> - <em>Project owner & founder</em></li>
|
||||
<li><strong>Jean-Christophe Begue</strong> - <em>Project collaborator, author of the HTTP/3 Implementation</em></li>
|
||||
</ul>
|
||||
<h1 align="center"><img width="500" src="https://raw.githubusercontent.com/quinn-rs/quinn/51a3cea225670757cb844a342428e4e1341d9f13/docs/thumbnail.svg" /></h1>
|
||||
<p><a href="https://docs.rs/quinn/"><img src="https://docs.rs/quinn/badge.svg" alt="Documentation" /></a>
|
||||
<a href="https://crates.io/crates/quinn"><img src="https://img.shields.io/crates/v/quinn.svg" alt="Crates.io" /></a>
|
||||
<a href="https://github.com/djc/quinn/actions?query=workflow%3ACI"><img src="https://github.com/quinn-rs/quinn/workflows/CI/badge.svg" alt="Build status" /></a>
|
||||
<a href="https://codecov.io/gh/quinn-rs/quinn"><img src="https://codecov.io/gh/quinn-rs/quinn/branch/main/graph/badge.svg" alt="codecov" /></a>
|
||||
<a href="https://matrix.to/#/#quinn:matrix.org"><img src="https://img.shields.io/badge/chat-%23quinn:matrix.org-%2346BC99?logo=matrix" alt="Chat" /></a>
|
||||
<a href="https://gitter.im/djc/quinn"><img src="https://badges.gitter.im/gitterHQ/gitter.svg" alt="Chat" /></a>
|
||||
<a href="LICENSE-MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT" /></a>
|
||||
<a href="LICENSE-APACHE"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License: Apache 2.0" /></a></p>
|
||||
<h1 id="pure-rust-quic-protocol-implementation-1"><a class="header" href="#pure-rust-quic-protocol-implementation-1">Pure-rust QUIC protocol implementation</a></h1>
|
||||
<p>Quinn is a pure-rust, future-based implementation of the <a href="https://quicwg.github.io/">QUIC</a> transport protocol undergoing standardization by the IETF.
|
||||
This library is at <a href="https://datatracker.ietf.org/doc/draft-ietf-quic-transport/32/">draft 32</a>.</p>
|
||||
<h2 id="features-1"><a class="header" href="#features-1">Features</a></h2>
|
||||
<ul>
|
||||
<li>Simultaneous client/server operation</li>
|
||||
<li>Ordered and unordered stream reads for improved performance</li>
|
||||
<li>Works on stable Rust, tested on Linux, macOS and Windows</li>
|
||||
<li>Pluggable cryptography, with a standard implementation backed by
|
||||
<a href="https://github.com/ctz/rustls">rustls</a> and <a href="https://github.com/briansmith/ring"><em>ring</em></a></li>
|
||||
<li>Application-layer datagrams for small, unreliable messages</li>
|
||||
<li>Future-based async API</li>
|
||||
<li>Experimental HTTP over QUIC</li>
|
||||
<li>The minimum supported Rust version is 1.45.0</li>
|
||||
</ul>
|
||||
<h2 id="overview-1"><a class="header" href="#overview-1">Overview</a></h2>
|
||||
<ul>
|
||||
<li><strong>quinn:</strong> High-level async API based on tokio, see for usage. This will be used by most developers. (Basic benchmarks are included.)</li>
|
||||
<li><strong>quinn-proto:</strong> Deterministic state machine of the protocol which performs <a href="https://sans-io.readthedocs.io/how-to-sans-io.html"><strong>no</strong> I/O</a> internally and is suitable for use with custom event loops (and potentially a C or C++ API).</li>
|
||||
<li><strong>quinn-h3:</strong> Contains an implementation of HTTP-3 and QPACK. It is split internally in a deterministic state machine and a tokio-based high-level async API.</li>
|
||||
<li><strong>bench:</strong> Benchmarks without any framework.</li>
|
||||
<li><strong>interop:</strong> Tooling that helps to run interoperability tests.</li>
|
||||
<li><strong>fuzz:</strong> Fuzz tests.</li>
|
||||
</ul>
|
||||
<h1 id="getting-started-1"><a class="header" href="#getting-started-1">Getting Started</a></h1>
|
||||
<p><strong>Examples</strong></p>
|
||||
<pre><code class="language-sh">$ cargo run --example server ./
|
||||
$ cargo run --example client https://localhost:4433/Cargo.toml
|
||||
</code></pre>
|
||||
<p>This launches an HTTP 0.9 server on the loopback address serving the current
|
||||
working directory, with the client fetching <code>./Cargo.toml</code>. By default, the
|
||||
server generates a self-signed certificate and stores it to disk, where the
|
||||
client will automatically find and trust it.</p>
|
||||
<p><strong>Links</strong></p>
|
||||
<ul>
|
||||
<li>Talk at <a href="https://paris.rustfest.eu/sessions/a-quic-future-in-rust">RustFest Paris (May 2018) presentation</a>; <a href="https://dirkjan.ochtman.nl/files/quic-future-in-rust.pdf">slides</a>; <a href="https://www.youtube.com/watch?v=EHgyY5DNdvI">YouTube</a></li>
|
||||
<li>Usage <a href="https://github.com/djc/quinn/tree/main/quinn/examples">examples</a></li>
|
||||
<li>Guide <a href="https://github.com/djc/quinn/issues/865">book</a></li>
|
||||
</ul>
|
||||
<h2 id="usage-notes-1"><a class="header" href="#usage-notes-1">Usage Notes</a></h2>
|
||||
<details>
|
||||
<summary>
|
||||
Click to show the notes
|
||||
</summary>
|
||||
<h3 id="buffers-1"><a class="header" href="#buffers-1">Buffers</a></h3>
|
||||
<p>A Quinn endpoint corresponds to a single UDP socket, no matter how many
|
||||
connections are in use. Handling high aggregate data rates on a single endpoint
|
||||
can require a larger UDP buffer than is configured by default in most
|
||||
environments. If you observe erratic latency and/or throughput over a stable
|
||||
network link, consider increasing the buffer sizes used. For example, you could
|
||||
adjust the <code>SO_SNDBUF</code> and <code>SO_RCVBUF</code> options of the UDP socket to be used
|
||||
before passing it in to Quinn. Note that some platforms (e.g. Linux) require
|
||||
elevated privileges or modified system configuration for a process to increase
|
||||
its UDP buffer sizes.</p>
|
||||
<h3 id="certificates-1"><a class="header" href="#certificates-1">Certificates</a></h3>
|
||||
<p>By default, Quinn clients validate the cryptographic identity of servers they
|
||||
connect to. This prevents an active, on-path attacker from intercepting
|
||||
messages, but requires trusting some certificate authority. For many purposes,
|
||||
this can be accomplished by using certificates from <a href="https://letsencrypt.org/">Let's Encrypt</a>
|
||||
for servers, and relying on the default configuration for clients.</p>
|
||||
<p>For some cases, including peer-to-peer, trust-on-first-use, deliberately
|
||||
insecure applications, or any case where servers are not identified by domain
|
||||
name, this isn't practical. Arbitrary certificate validation logic can be
|
||||
implemented by enabling the <code>dangerous_configuration</code> feature of <code>rustls</code> and
|
||||
constructing a Quinn <code>ClientConfig</code> with an overridden certificate verifier by
|
||||
hand.</p>
|
||||
<p>When operating your own certificate authority doesn't make sense, <a href="https://crates.io/crates/rcgen">rcgen</a>
|
||||
can be used to generate self-signed certificates on demand. To support
|
||||
trust-on-first-use, servers that automatically generate self-signed certificates
|
||||
should write their generated certificate to persistent storage and reuse it on
|
||||
future runs.</p>
|
||||
</details>
|
||||
<p></p>
|
||||
<h2 id="contribution-1"><a class="header" href="#contribution-1">Contribution</a></h2>
|
||||
<p>All feedback welcome. Feel free to file bugs, requests for documentation and
|
||||
any other feedback to the <a href="https://github.com/djc/quinn/issues">issue tracker</a>.</p>
|
||||
<p>The quinn-proto test suite uses simulated IO for reproducibility and to avoid
|
||||
long sleeps in certain timing-sensitive tests. If the <code>SSLKEYLOGFILE</code>
|
||||
environment variable is set, the tests will emit UDP packets for inspection
|
||||
using external protocol analyzers like Wireshark, and NSS-compatible key logs
|
||||
for the client side of each connection will be written to the path specified in
|
||||
the variable.</p>
|
||||
<p>The minimum supported Rust version for published releases of our
|
||||
crates will always be at least 6 months old at the time of release.</p>
|
||||
<h2 id="authors-1"><a class="header" href="#authors-1">Authors</a></h2>
|
||||
<ul>
|
||||
<li><strong>Dirkjan Ochtman</strong> - <em>Project owner & founder</em></li>
|
||||
<li><strong>Benjamin Saunders</strong> - <em>Project owner & founder</em></li>
|
||||
<li><strong>Jean-Christophe Begue</strong> - <em>Project collaborator, author of the HTTP/3 Implementation</em></li>
|
||||
</ul>
|
||||
<h1 id="certificates-2"><a class="header" href="#certificates-2">Certificates</a></h1>
|
||||
<h1 id="certificates-1"><a class="header" href="#certificates-1">Certificates</a></h1>
|
||||
<p>In this chapter, we discuss the configuration of the certificates that are <strong>required</strong> for a working Quinn connection. </p>
|
||||
<p>As QUIC uses TLS 1.3 for authentication of connections, the server needs to provide the client with a certificate confirming its identity, and the client must be configured to trust the certificates it receives from the server. </p>
|
||||
<h2 id="insecure-connection"><a class="header" href="#insecure-connection">Insecure Connection</a></h2>
|
||||
@@ -717,7 +638,7 @@ This could be useful if data arrival isn't essential or when high throughput is
|
||||
}
|
||||
<span class="boring">}
|
||||
</span></code></pre></pre>
|
||||
<h1 id="the-quic-protocol"><a class="header" href="#the-quic-protocol">The QUIC protocol</a></h1>
|
||||
<h1 id="the-quic-protocol-1"><a class="header" href="#the-quic-protocol-1">The QUIC protocol</a></h1>
|
||||
<p><a href="https://en.wikipedia.org/wiki/QUIC">QUIC</a> is a general-purpose network protocol built on top of UDP.
|
||||
The protocol is still under development and standardized by the <a href="https://www.ietf.org/">IETF</a>.
|
||||
Quinn strives to implement the latest <a href="https://datatracker.ietf.org/doc/draft-ietf-quic-transport/">draft</a> but may lag a bit behind. Although QUIC is still in a draft phase,
|
||||
|
||||
@@ -95,7 +95,7 @@
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">2.</strong> Quinn introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html" class="active"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quic.html" class="active"><strong aria-hidden="true">2.</strong> QUIC introduction</a></li><li class="chapter-item expanded "><a href="quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html" class="active"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
@@ -189,12 +189,16 @@ One thing is for sure, QUIC has many great potentials and will serve us in the f
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
|
||||
<a rel="prev" href="quinn/data-transfer.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<a rel="prev" href="networking-introduction.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
|
||||
|
||||
<a rel="next" href="quinn.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
|
||||
<div style="clear: both"></div>
|
||||
</nav>
|
||||
@@ -203,12 +207,16 @@ One thing is for sure, QUIC has many great potentials and will serve us in the f
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
|
||||
<a rel="prev" href="quinn/data-transfer.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<a rel="prev" href="networking-introduction.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
|
||||
|
||||
<a rel="next" href="quinn.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
</nav>
|
||||
|
||||
</div>
|
||||
|
||||
+5
-5
@@ -95,7 +95,7 @@
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quinn.html" class="active"><strong aria-hidden="true">2.</strong> Quinn introduction</a></li><li class="chapter-item expanded "><a href="quinn.html" class="active"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">2.</strong> QUIC introduction</a></li><li class="chapter-item expanded "><a href="quinn.html" class="active"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
@@ -268,13 +268,13 @@ crates will always be at least 6 months old at the time of release.</p>
|
||||
<nav class="nav-wrapper" aria-label="Page navigation">
|
||||
<!-- Mobile navigation buttons -->
|
||||
|
||||
<a rel="prev" href="networking-introduction.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<a rel="prev" href="quic.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
|
||||
|
||||
<a rel="next" href="quinn.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next" href="quinn/certificate.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
@@ -286,13 +286,13 @@ crates will always be at least 6 months old at the time of release.</p>
|
||||
|
||||
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
||||
|
||||
<a rel="prev" href="networking-introduction.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<a rel="prev" href="quic.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
||||
<i class="fa fa-angle-left"></i>
|
||||
</a>
|
||||
|
||||
|
||||
|
||||
<a rel="next" href="quinn.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<a rel="next" href="quinn/certificate.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
||||
<i class="fa fa-angle-right"></i>
|
||||
</a>
|
||||
|
||||
|
||||
@@ -95,7 +95,7 @@
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="../networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="../quinn.html"><strong aria-hidden="true">2.</strong> Quinn introduction</a></li><li class="chapter-item expanded "><a href="../quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../quinn/certificate.html" class="active"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="../quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="../quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="../quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="../networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="../quic.html"><strong aria-hidden="true">2.</strong> QUIC introduction</a></li><li class="chapter-item expanded "><a href="../quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../quinn/certificate.html" class="active"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="../quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="../quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="../quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
@@ -95,7 +95,7 @@
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="../networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="../quinn.html"><strong aria-hidden="true">2.</strong> Quinn introduction</a></li><li class="chapter-item expanded "><a href="../quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="../quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="../quinn/data-transfer.html" class="active"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="../quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="../networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="../quic.html"><strong aria-hidden="true">2.</strong> QUIC introduction</a></li><li class="chapter-item expanded "><a href="../quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="../quinn/set-up-connection.html"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="../quinn/data-transfer.html" class="active"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="../quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
@@ -95,7 +95,7 @@
|
||||
|
||||
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
||||
<div class="sidebar-scrollbox">
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="../networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="../quinn.html"><strong aria-hidden="true">2.</strong> Quinn introduction</a></li><li class="chapter-item expanded "><a href="../quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="../quinn/set-up-connection.html" class="active"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="../quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="../quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
<ol class="chapter"><li class="chapter-item expanded "><a href="../networking-introduction.html"><strong aria-hidden="true">1.</strong> Networking introduction</a></li><li class="chapter-item expanded "><a href="../quic.html"><strong aria-hidden="true">2.</strong> QUIC introduction</a></li><li class="chapter-item expanded "><a href="../quinn.html"><strong aria-hidden="true">3.</strong> QUINN Introduction</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../quinn/certificate.html"><strong aria-hidden="true">3.1.</strong> Certificate Configuration</a></li><li class="chapter-item expanded "><a href="../quinn/set-up-connection.html" class="active"><strong aria-hidden="true">3.2.</strong> Connection Setup</a></li><li class="chapter-item expanded "><a href="../quinn/data-transfer.html"><strong aria-hidden="true">3.3.</strong> Data Transfer</a></li></ol></li><li class="chapter-item expanded "><a href="../quic.html"><strong aria-hidden="true">4.</strong> The QUIC protocol</a></li></ol>
|
||||
</div>
|
||||
<div id="sidebar-resize-handle" class="sidebar-resize-handle"></div>
|
||||
</nav>
|
||||
|
||||
+1
-1
File diff suppressed because one or more lines are too long
+1
-1
File diff suppressed because one or more lines are too long
Reference in New Issue
Block a user