public/openssl
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add a reference for HTTP/3

Browse source 
We also add reference for ALPN ids

Reviewed-by: Hugo Landau <hlandau@openssl.org>
Reviewed-by: Tomas Mraz <tomas@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/22505)
This commit is contained in:
Matt Caswell 2023-10-25 12:57:12 +01:00 • committed by Hugo Landau
parent 899c910e34
commit f666599f8d
1 changed files with 7 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

12
README-QUIC.md
View file

@ -30,10 +30,10 @@ QUIC is a state-of-the-art secure transport protocol carried over UDP. It can
serve many of the use cases of SSL/TLS as well as those of DTLS. serve many of the use cases of SSL/TLS as well as those of DTLS.
QUIC delivers a number of advantages such as support for multiple streams of QUIC delivers a number of advantages such as support for multiple streams of
communication; it is the basis for HTTP/3; fast connection initiation; and communication; it is the basis for HTTP/3 [RFC 9114]; fast connection
connection migration (enabling a connection to survive IP address changes). initiation; and connection migration (enabling a connection to survive IP
For a more complete description of what QUIC is and its advantages see the address changes). For a more complete description of what QUIC is and its
[QUIC Introduction] in the OpenSSL Guide. advantages see the [QUIC Introduction] in the OpenSSL Guide.
For a more comprehensive overview of OpenSSL's QUIC implementation, see the For a more comprehensive overview of OpenSSL's QUIC implementation, see the
[openssl-quic(7) manual page]. [openssl-quic(7) manual page].
@ -63,7 +63,7 @@ $ openssl s_client -quic -alpn myalpn -connect host:port
In the above example replace `host` with the hostname of the server (e.g. In the above example replace `host` with the hostname of the server (e.g.
`www.example.com`) and `port` with the port for the server (e.g. `443`). Replace `www.example.com`) and `port` with the port for the server (e.g. `443`). Replace
`myalpn` with the Application Layer Protocol to use (e.g.`h3` represents `myalpn` with the Application Layer Protocol to use (e.g.`h3` represents
HTTP/3). HTTP/3). IANA matains a standard list of [ALPN ids] that can be used.
This example connects to a QUIC server and opens a single bidirectional stream. This example connects to a QUIC server and opens a single bidirectional stream.
Data can be passed via stdin/stdout as usual. This allows test usage of QUIC Data can be passed via stdin/stdout as usual. This allows test usage of QUIC
@ -78,3 +78,5 @@ HTTP/3 request or receiving any response data is not.
[demo found in `demos/http3`]: ./demos/http3/ [demo found in `demos/http3`]: ./demos/http3/
[openssl-quic(7) manual page]: https://www.openssl.org/docs/manmaster/man7/openssl-quic.html [openssl-quic(7) manual page]: https://www.openssl.org/docs/manmaster/man7/openssl-quic.html
[QUIC Introduction](https://www.openssl.org/docs/manmaster/man7/ossl-guide-quic-introduction.html) [QUIC Introduction](https://www.openssl.org/docs/manmaster/man7/ossl-guide-quic-introduction.html)
[RFC 9114]: https://tools.ietf.org/html/rfc9114
[ALPN ids]: https://www.iana.org/assignments/tls-extensiontype-values/tls-extensiontype-values.xhtml#alpn-protocol-ids