comparison README @ 8713:d6ef13c5fd8e quic

QUIC: simplified configuration. Directives that set transport parameters are removed from the configuration. Corresponding values are derived from the quic configuration or initialized to default. Whenever possible, quic configuration parameters are taken from higher-level protocol settings, i.e. HTTP/3.
author Vladimir Homutov <vl@nginx.com>
date Mon, 06 Dec 2021 15:19:54 +0300
parents 651cc905b7c2
children 44553428288d
comparison
equal deleted inserted replaced
8712:651cc905b7c2 8713:d6ef13c5fd8e
96 QUIC as client transport protocol instead of TCP or plain UDP. 96 QUIC as client transport protocol instead of TCP or plain UDP.
97 97
98 Along with "http3" or "quic", you also have to specify "reuseport" 98 Along with "http3" or "quic", you also have to specify "reuseport"
99 option [6] to make it work properly with multiple workers. 99 option [6] to make it work properly with multiple workers.
100 100
101 A number of directives were added that specify transport parameter values:
102
103 quic_max_idle_timeout
104 quic_max_ack_delay
105 quic_max_udp_payload_size
106 quic_initial_max_data
107 quic_initial_max_stream_data_bidi_local
108 quic_initial_max_stream_data_bidi_remote
109 quic_initial_max_stream_data_uni
110 quic_initial_max_streams_bidi
111 quic_initial_max_streams_uni
112 quic_ack_delay_exponent
113 quic_disable_active_migration
114 quic_active_connection_id_limit
115
116 To enable address validation: 101 To enable address validation:
117 102
118 quic_retry on; 103 quic_retry on;
119 104
120 To enable 0-RTT: 105 To enable 0-RTT:
126 ssl_protocols TLSv1.3; 111 ssl_protocols TLSv1.3;
127 112
128 To enable GSO (Generic Segmentation Offloading): 113 To enable GSO (Generic Segmentation Offloading):
129 114
130 quic_gso on; 115 quic_gso on;
116
117 To limit maximum packet size:
118
119 quic_mtu <size>;
120
121 To set host key for various tokens:
122
123 quic_host_key <filename>;
124
131 125
132 By default this Linux-specific optimization [8] is disabled. 126 By default this Linux-specific optimization [8] is disabled.
133 Enable if your network interface is configured to support GSO. 127 Enable if your network interface is configured to support GSO.
134 128
135 A number of directives were added that configure HTTP/3: 129 A number of directives were added that configure HTTP/3:
136 130
137 http3_max_table_capacity 131 http3_stream_buffer_size
138 http3_max_blocked_streams
139 http3_max_concurrent_pushes 132 http3_max_concurrent_pushes
133 http3_max_concurrent_streams
140 http3_push 134 http3_push
141 http3_push_preload 135 http3_push_preload
142 http3_hq (requires NGX_HTTP_V3_HQ macro) 136 http3_hq (requires NGX_HTTP_V3_HQ macro)
143 137
144 In http, an additional variable is available: $http3. 138 In http, an additional variable is available: $http3.