diff README @ 9047:c851a2ed5ce8 quic

HTTP/3: "quic" parameter of "listen" directive. Now "listen" directve has a new "quic" parameter which enables QUIC protocol for the address. Further, to enable HTTP/3, a new directive "http3" is introduced. The hq-interop protocol is enabled by "http3_hq" as before. Now application protocol is chosen by ALPN. Previously used "http3" parameter of "listen" is deprecated.
author Roman Arutyunyan <arut@nginx.com>
date Mon, 27 Feb 2023 14:00:56 +0400
parents 7da4791e0264
children 8347620e0e76
line wrap: on
line diff
--- a/README
+++ b/README
@@ -102,13 +102,13 @@ 2. Building from sources
 
 3. Configuration
 
-    The HTTP "listen" directive got a new option "http3" which enables
-    HTTP/3 over QUIC on the specified port.
+    The HTTP "listen" directive got a new option "quic" which enables
+    QUIC as client transport protocol instead of TCP.
 
     The Stream "listen" directive got a new option "quic" which enables
     QUIC as client transport protocol instead of TCP or plain UDP.
 
-    Along with "http3" or "quic", it's also possible to specify "reuseport"
+    Along with "quic", it's also possible to specify "reuseport"
     option [8] to make it work properly with multiple workers.
 
     To enable address validation:
@@ -142,12 +142,13 @@ 3. Configuration
 
     A number of directives were added that configure HTTP/3:
 
+        http3
+        http3_hq
         http3_stream_buffer_size
         http3_max_concurrent_pushes
         http3_max_concurrent_streams
         http3_push
         http3_push_preload
-        http3_hq (requires NGX_HTTP_V3_HQ macro)
 
     In http, an additional variable is available: $http3.
     The value of $http3 is "h3" for HTTP/3 connections,
@@ -169,7 +170,7 @@ Example configuration:
         server {
             # for better compatibility it's recommended
             # to use the same port for quic and https
-            listen 8443 http3 reuseport;
+            listen 8443 quic reuseport;
             listen 8443 ssl;
 
             ssl_certificate     certs/example.com.crt;
@@ -299,6 +300,13 @@ 4. Directives
     response header fields into push requests.
 
 
+    Syntax: http3 on | off;
+    Default: http3 on;
+    Context: http, server
+
+    Enables HTTP/3 protocol negotiation.
+
+
     Syntax: http3_hq on | off;
     Default: http3_hq off;
     Context: http, server