blob: bff31c90f9b416433d1e1c869ddf7701b0cc449d [file] [log] [blame]
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001/*
2 * HTTP/3 protocol processing
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation, version 2.1
7 * exclusively.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17 */
18
Amaury Denoyelle5c25dc52022-09-30 17:44:15 +020019#include <import/ist.h>
20
21#include <haproxy/api.h>
Frédéric Lécailleccac11f2021-03-03 16:09:02 +010022#include <haproxy/buf.h>
Amaury Denoyelle5c25dc52022-09-30 17:44:15 +020023#include <haproxy/chunk.h>
Amaury Denoyelle99043552021-08-24 15:36:02 +020024#include <haproxy/connection.h>
Frédéric Lécailleccac11f2021-03-03 16:09:02 +010025#include <haproxy/dynbuf.h>
26#include <haproxy/h3.h>
Frédéric Lécaille6f7607e2022-05-25 22:25:37 +020027#include <haproxy/h3_stats.h>
Amaury Denoyelleb49fa1a2021-08-24 15:30:12 +020028#include <haproxy/http.h>
Amaury Denoyelle5c25dc52022-09-30 17:44:15 +020029#include <haproxy/http-hdr-t.h>
Amaury Denoyelle115ccce2022-08-17 18:02:47 +020030#include <haproxy/http_htx.h>
Amaury Denoyelleb49fa1a2021-08-24 15:30:12 +020031#include <haproxy/htx.h>
Amaury Denoyelle8c6176b2022-05-24 18:16:49 +020032#include <haproxy/intops.h>
Frédéric Lécailleccac11f2021-03-03 16:09:02 +010033#include <haproxy/istbuf.h>
Amaury Denoyelle846cc042022-04-04 16:13:44 +020034#include <haproxy/mux_quic.h>
Frédéric Lécailleccac11f2021-03-03 16:09:02 +010035#include <haproxy/pool.h>
Amaury Denoyelle381d8132023-02-17 09:51:20 +010036#include <haproxy/qmux_http.h>
Frédéric Lécailleccac11f2021-03-03 16:09:02 +010037#include <haproxy/qpack-dec.h>
Amaury Denoyelle15b09612021-08-24 16:20:27 +020038#include <haproxy/qpack-enc.h>
Amaury Denoyelle92fa63f2022-09-30 18:11:13 +020039#include <haproxy/quic_conn-t.h>
Amaury Denoyelle15b09612021-08-24 16:20:27 +020040#include <haproxy/quic_enc.h>
Amaury Denoyelle51f116d2023-05-04 15:49:02 +020041#include <haproxy/quic_frame.h>
Amaury Denoyelle5c25dc52022-09-30 17:44:15 +020042#include <haproxy/stats-t.h>
Frédéric Lécailleccac11f2021-03-03 16:09:02 +010043#include <haproxy/tools.h>
Amaury Denoyelle016aa932022-05-30 15:49:36 +020044#include <haproxy/trace.h>
Frédéric Lécailleccac11f2021-03-03 16:09:02 +010045
Amaury Denoyelle016aa932022-05-30 15:49:36 +020046/* trace source and events */
47static void h3_trace(enum trace_level level, uint64_t mask,
48 const struct trace_source *src,
49 const struct ist where, const struct ist func,
50 const void *a1, const void *a2, const void *a3, const void *a4);
51
52static const struct trace_event h3_trace_events[] = {
Amaury Denoyelle494512d2022-05-30 15:50:34 +020053#define H3_EV_RX_FRAME (1ULL << 0)
54 { .mask = H3_EV_RX_FRAME, .name = "rx_frame", .desc = "receipt of any H3 frame" },
55#define H3_EV_RX_DATA (1ULL << 1)
56 { .mask = H3_EV_RX_DATA, .name = "rx_data", .desc = "receipt of H3 DATA frame" },
57#define H3_EV_RX_HDR (1ULL << 2)
58 { .mask = H3_EV_RX_HDR, .name = "rx_hdr", .desc = "receipt of H3 HEADERS frame" },
59#define H3_EV_RX_SETTINGS (1ULL << 3)
60 { .mask = H3_EV_RX_SETTINGS, .name = "rx_settings", .desc = "receipt of H3 SETTINGS frame" },
Amaury Denoyellea717eb72022-05-30 15:51:01 +020061#define H3_EV_TX_DATA (1ULL << 4)
62 { .mask = H3_EV_TX_DATA, .name = "tx_data", .desc = "transmission of H3 DATA frame" },
63#define H3_EV_TX_HDR (1ULL << 5)
64 { .mask = H3_EV_TX_HDR, .name = "tx_hdr", .desc = "transmission of H3 HEADERS frame" },
65#define H3_EV_TX_SETTINGS (1ULL << 6)
66 { .mask = H3_EV_TX_SETTINGS, .name = "tx_settings", .desc = "transmission of H3 SETTINGS frame" },
Amaury Denoyelled5581d52022-05-30 15:51:31 +020067#define H3_EV_H3S_NEW (1ULL << 7)
68 { .mask = H3_EV_H3S_NEW, .name = "h3s_new", .desc = "new H3 stream" },
69#define H3_EV_H3S_END (1ULL << 8)
70 { .mask = H3_EV_H3S_END, .name = "h3s_end", .desc = "H3 stream terminated" },
Amaury Denoyelle56a86dd2023-01-30 15:36:51 +010071#define H3_EV_H3C_END (1ULL << 9)
72 { .mask = H3_EV_H3C_END, .name = "h3c_end", .desc = "H3 connection terminated" },
Amaury Denoyelle016aa932022-05-30 15:49:36 +020073 { }
74};
75
76static const struct name_desc h3_trace_lockon_args[4] = {
77 /* arg1 */ { /* already used by the connection */ },
78 /* arg2 */ { .name="qcs", .desc="QUIC stream" },
79 /* arg3 */ { },
80 /* arg4 */ { }
81};
82
83static const struct name_desc h3_trace_decoding[] = {
84#define H3_VERB_CLEAN 1
85 { .name="clean", .desc="only user-friendly stuff, generally suitable for level \"user\"" },
86#define H3_VERB_MINIMAL 2
87 { .name="minimal", .desc="report only qcc/qcs state and flags, no real decoding" },
88 { /* end */ }
89};
90
91struct trace_source trace_h3 = {
92 .name = IST("h3"),
93 .desc = "HTTP/3 transcoder",
94 .arg_def = TRC_ARG1_CONN, /* TRACE()'s first argument is always a connection */
95 .default_cb = h3_trace,
96 .known_events = h3_trace_events,
97 .lockon_args = h3_trace_lockon_args,
98 .decoding = h3_trace_decoding,
99 .report_events = ~0, /* report everything by default */
100};
101
102#define TRACE_SOURCE &trace_h3
103INITCALL1(STG_REGISTER, trace_register_source, TRACE_SOURCE);
104
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100105#if defined(DEBUG_H3)
106#define h3_debug_printf fprintf
107#define h3_debug_hexdump debug_hexdump
108#else
109#define h3_debug_printf(...) do { } while (0)
110#define h3_debug_hexdump(...) do { } while (0)
111#endif
112
Amaury Denoyelle302ecd42022-05-24 15:24:32 +0200113#define H3_CF_SETTINGS_SENT 0x00000001 /* SETTINGS frame already sent on local control stream */
114#define H3_CF_SETTINGS_RECV 0x00000002 /* SETTINGS frame already received on remote control stream */
115#define H3_CF_UNI_CTRL_SET 0x00000004 /* Remote H3 Control stream opened */
116#define H3_CF_UNI_QPACK_DEC_SET 0x00000008 /* Remote QPACK decoder stream opened */
117#define H3_CF_UNI_QPACK_ENC_SET 0x00000010 /* Remote QPACK encoder stream opened */
Amaury Denoyelle3d550842023-01-24 17:42:21 +0100118#define H3_CF_GOAWAY_SENT 0x00000020 /* GOAWAY sent on local control stream */
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100119
120/* Default settings */
Amaury Denoyelle33949392021-08-24 15:16:58 +0200121static uint64_t h3_settings_qpack_max_table_capacity = 0;
122static uint64_t h3_settings_qpack_blocked_streams = 4096;
123static uint64_t h3_settings_max_field_section_size = QUIC_VARINT_8_BYTE_MAX; /* Unlimited */
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100124
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +0200125struct h3c {
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100126 struct qcc *qcc;
Amaury Denoyelled7010392022-07-13 15:17:29 +0200127 struct qcs *ctrl_strm; /* Control stream */
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100128 enum h3_err err;
129 uint32_t flags;
Amaury Denoyelle9cc47512022-05-24 16:27:41 +0200130
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100131 /* Settings */
132 uint64_t qpack_max_table_capacity;
133 uint64_t qpack_blocked_streams;
134 uint64_t max_field_section_size;
Amaury Denoyelle9cc47512022-05-24 16:27:41 +0200135
Amaury Denoyelle114c9c82022-03-28 14:53:45 +0200136 uint64_t id_goaway; /* stream ID used for a GOAWAY frame */
137
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100138 struct buffer_wait buf_wait; /* wait list for buffer allocations */
Frédéric Lécaille6f7607e2022-05-25 22:25:37 +0200139 /* Stats counters */
140 struct h3_counters *prx_counters;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100141};
142
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +0200143DECLARE_STATIC_POOL(pool_head_h3c, "h3c", sizeof(struct h3c));
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100144
Amaury Denoyelle35550642022-05-24 15:14:53 +0200145#define H3_SF_UNI_INIT 0x00000001 /* stream type not parsed for unidirectional stream */
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200146#define H3_SF_UNI_NO_H3 0x00000002 /* unidirectional stream does not carry H3 frames */
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +0100147#define H3_SF_HAVE_CLEN 0x00000004 /* content-length header is present */
Amaury Denoyelle35550642022-05-24 15:14:53 +0200148
Amaury Denoyelle67e92d32022-04-27 18:04:01 +0200149struct h3s {
Amaury Denoyellec0156792022-06-03 15:29:07 +0200150 struct h3c *h3c;
151
Amaury Denoyelle3236a8e2022-05-24 15:24:03 +0200152 enum h3s_t type;
Amaury Denoyelle8d818c62022-08-02 11:32:45 +0200153 enum h3s_st_req st_req; /* only used for request streams */
Amaury Denoyelle35d90532023-01-26 16:03:45 +0100154 uint64_t demux_frame_len;
155 uint64_t demux_frame_type;
Amaury Denoyelle35550642022-05-24 15:14:53 +0200156
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +0100157 unsigned long long body_len; /* known request body length from content-length header if present */
158 unsigned long long data_len; /* total length of all parsed DATA */
159
Amaury Denoyelle35550642022-05-24 15:14:53 +0200160 int flags;
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100161 int err; /* used for stream reset */
Amaury Denoyelle67e92d32022-04-27 18:04:01 +0200162};
163
164DECLARE_STATIC_POOL(pool_head_h3s, "h3s", sizeof(struct h3s));
165
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200166/* Initialize an uni-stream <qcs> by reading its type from <b>.
Amaury Denoyelle35550642022-05-24 15:14:53 +0200167 *
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200168 * Returns the count of consumed bytes or a negative error code.
Amaury Denoyelle35550642022-05-24 15:14:53 +0200169 */
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200170static ssize_t h3_init_uni_stream(struct h3c *h3c, struct qcs *qcs,
171 struct buffer *b)
Amaury Denoyelle35550642022-05-24 15:14:53 +0200172{
173 /* decode unidirectional stream type */
174 struct h3s *h3s = qcs->ctx;
Amaury Denoyelle35550642022-05-24 15:14:53 +0200175 uint64_t type;
176 size_t len = 0, ret;
177
Amaury Denoyelled5581d52022-05-30 15:51:31 +0200178 TRACE_ENTER(H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
179
Amaury Denoyelle8d6d2462023-05-11 16:55:30 +0200180 /* Function reserved to uni streams. Must be called only once per stream instance. */
181 BUG_ON(!quic_stream_is_uni(qcs->id) || h3s->flags & H3_SF_UNI_INIT);
Amaury Denoyelle35550642022-05-24 15:14:53 +0200182
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200183 ret = b_quic_dec_int(&type, b, &len);
Amaury Denoyelle35550642022-05-24 15:14:53 +0200184 if (!ret) {
Amaury Denoyelle5aa21c12023-03-09 11:12:32 +0100185 /* not enough data to decode uni stream type, retry later */
186 TRACE_DATA("cannot decode uni stream type due to incomplete data", H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
187 goto out;
Amaury Denoyelle35550642022-05-24 15:14:53 +0200188 }
189
190 switch (type) {
191 case H3_UNI_S_T_CTRL:
192 if (h3c->flags & H3_CF_UNI_CTRL_SET) {
Amaury Denoyelle815c8ce2023-03-08 10:25:39 +0100193 TRACE_ERROR("duplicated control stream", H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
Amaury Denoyelle58721f22023-05-09 18:01:09 +0200194 qcc_set_error(qcs->qcc, H3_STREAM_CREATION_ERROR, 1);
Amaury Denoyelle815c8ce2023-03-08 10:25:39 +0100195 goto err;
Amaury Denoyelle35550642022-05-24 15:14:53 +0200196 }
197 h3c->flags |= H3_CF_UNI_CTRL_SET;
198 h3s->type = H3S_T_CTRL;
199 break;
200
201 case H3_UNI_S_T_PUSH:
202 /* TODO not supported for the moment */
203 h3s->type = H3S_T_PUSH;
204 break;
205
206 case H3_UNI_S_T_QPACK_DEC:
207 if (h3c->flags & H3_CF_UNI_QPACK_DEC_SET) {
Amaury Denoyelle815c8ce2023-03-08 10:25:39 +0100208 TRACE_ERROR("duplicated qpack decoder stream", H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
Amaury Denoyelle58721f22023-05-09 18:01:09 +0200209 qcc_set_error(qcs->qcc, H3_STREAM_CREATION_ERROR, 1);
Amaury Denoyelle815c8ce2023-03-08 10:25:39 +0100210 goto err;
Amaury Denoyelle35550642022-05-24 15:14:53 +0200211 }
212 h3c->flags |= H3_CF_UNI_QPACK_DEC_SET;
213 h3s->type = H3S_T_QPACK_DEC;
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200214 h3s->flags |= H3_SF_UNI_NO_H3;
Amaury Denoyelle35550642022-05-24 15:14:53 +0200215 break;
216
217 case H3_UNI_S_T_QPACK_ENC:
218 if (h3c->flags & H3_CF_UNI_QPACK_ENC_SET) {
Amaury Denoyelle815c8ce2023-03-08 10:25:39 +0100219 TRACE_ERROR("duplicated qpack encoder stream", H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
Amaury Denoyelle58721f22023-05-09 18:01:09 +0200220 qcc_set_error(qcs->qcc, H3_STREAM_CREATION_ERROR, 1);
Amaury Denoyelle815c8ce2023-03-08 10:25:39 +0100221 goto err;
Amaury Denoyelle35550642022-05-24 15:14:53 +0200222 }
223 h3c->flags |= H3_CF_UNI_QPACK_ENC_SET;
224 h3s->type = H3S_T_QPACK_ENC;
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200225 h3s->flags |= H3_SF_UNI_NO_H3;
Amaury Denoyelle35550642022-05-24 15:14:53 +0200226 break;
227
228 default:
Amaury Denoyelle849b24f2022-05-24 17:22:07 +0200229 /* draft-ietf-quic-http34 9. Extensions to HTTP/3
230 *
231 * Implementations MUST [...] abort reading on unidirectional
232 * streams that have unknown or unsupported types.
233 */
Amaury Denoyelle815c8ce2023-03-08 10:25:39 +0100234 TRACE_STATE("abort reading on unknown uni stream type", H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
Amaury Denoyelle663e8722022-12-09 14:58:28 +0100235 qcc_abort_stream_read(qcs);
Amaury Denoyelle815c8ce2023-03-08 10:25:39 +0100236 goto err;
237 }
Amaury Denoyelle35550642022-05-24 15:14:53 +0200238
239 h3s->flags |= H3_SF_UNI_INIT;
Amaury Denoyelle35550642022-05-24 15:14:53 +0200240
Amaury Denoyelle5aa21c12023-03-09 11:12:32 +0100241 out:
Amaury Denoyelled5581d52022-05-30 15:51:31 +0200242 TRACE_LEAVE(H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200243 return len;
Amaury Denoyelle815c8ce2023-03-08 10:25:39 +0100244
245 err:
246 TRACE_DEVEL("leaving on error", H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
247 return -1;
Amaury Denoyelle35550642022-05-24 15:14:53 +0200248}
249
Amaury Denoyelle26aa3992022-08-16 17:42:47 +0200250/* Parse a buffer <b> for a <qcs> uni-stream which does not contains H3 frames.
251 * This may be used for QPACK encoder/decoder streams for example. <fin> is set
252 * if this is the last frame of the stream.
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200253 *
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200254 * Returns the number of consumed bytes or a negative error code.
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200255 */
Amaury Denoyelle26aa3992022-08-16 17:42:47 +0200256static ssize_t h3_parse_uni_stream_no_h3(struct qcs *qcs, struct buffer *b, int fin)
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200257{
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200258 struct h3s *h3s = qcs->ctx;
259
Amaury Denoyelle8d6d2462023-05-11 16:55:30 +0200260 /* Function reserved to non-HTTP/3 unidirectional streams. */
261 BUG_ON(!quic_stream_is_uni(qcs->id) || !(h3s->flags & H3_SF_UNI_NO_H3));
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200262
263 switch (h3s->type) {
264 case H3S_T_QPACK_DEC:
Amaury Denoyelle26aa3992022-08-16 17:42:47 +0200265 if (qpack_decode_dec(b, fin, qcs))
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200266 return -1;
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200267 break;
268 case H3S_T_QPACK_ENC:
Amaury Denoyelle26aa3992022-08-16 17:42:47 +0200269 if (qpack_decode_enc(b, fin, qcs))
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200270 return -1;
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200271 break;
Amaury Denoyelle849b24f2022-05-24 17:22:07 +0200272 case H3S_T_UNKNOWN:
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200273 default:
Amaury Denoyelle849b24f2022-05-24 17:22:07 +0200274 /* Unknown stream should be flagged with QC_SF_READ_ABORTED. */
275 ABORT_NOW();
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200276 }
277
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200278 /* TODO adjust return code */
Amaury Denoyellefc99a692022-05-24 15:25:19 +0200279 return 0;
280}
281
Amaury Denoyelle88d5dd12022-05-31 11:44:52 +0200282/* Decode a H3 frame header from <rxbuf> buffer. The frame type is stored in
283 * <ftype> and length in <flen>.
284 *
285 * Returns the size of the H3 frame header. Note that the input buffer is not
286 * consumed.
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100287 */
288static inline size_t h3_decode_frm_header(uint64_t *ftype, uint64_t *flen,
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200289 struct buffer *b)
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100290{
291 size_t hlen;
292
293 hlen = 0;
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200294 if (!b_quic_dec_int(ftype, b, &hlen) ||
295 !b_quic_dec_int(flen, b, &hlen)) {
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100296 return 0;
Amaury Denoyelle88d5dd12022-05-31 11:44:52 +0200297 }
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100298
299 return hlen;
300}
301
Amaury Denoyelle302ecd42022-05-24 15:24:32 +0200302/* Check if H3 frame of type <ftype> is valid when received on stream <qcs>.
303 *
304 * Returns a boolean. If false, a connection error H3_FRAME_UNEXPECTED should
305 * be reported.
306 */
307static int h3_is_frame_valid(struct h3c *h3c, struct qcs *qcs, uint64_t ftype)
308{
309 struct h3s *h3s = qcs->ctx;
310 const uint64_t id = qcs->id;
311
Amaury Denoyelle8d6d2462023-05-11 16:55:30 +0200312 /* Stream type must be known to ensure frame is valid for this stream. */
313 BUG_ON(h3s->type == H3S_T_UNKNOWN);
Amaury Denoyelle302ecd42022-05-24 15:24:32 +0200314
315 switch (ftype) {
316 case H3_FT_DATA:
Amaury Denoyelle8d818c62022-08-02 11:32:45 +0200317 return h3s->type != H3S_T_CTRL && (h3s->st_req == H3S_ST_REQ_HEADERS ||
318 h3s->st_req == H3S_ST_REQ_DATA);
319
Amaury Denoyelle302ecd42022-05-24 15:24:32 +0200320 case H3_FT_HEADERS:
Amaury Denoyelle8d818c62022-08-02 11:32:45 +0200321 return h3s->type != H3S_T_CTRL && h3s->st_req != H3S_ST_REQ_TRAILERS;
Amaury Denoyelle302ecd42022-05-24 15:24:32 +0200322
323 case H3_FT_CANCEL_PUSH:
324 case H3_FT_GOAWAY:
325 case H3_FT_MAX_PUSH_ID:
326 /* Only allowed for control stream. First frame of control
327 * stream MUST be SETTINGS.
328 */
329 return h3s->type == H3S_T_CTRL &&
330 (h3c->flags & H3_CF_SETTINGS_RECV);
331
332 case H3_FT_SETTINGS:
333 /* draft-ietf-quic-http34 7.2.4. SETTINGS
334 *
335 * If an endpoint receives a second SETTINGS frame on the control
336 * stream, the endpoint MUST respond with a connection error of type
337 * H3_FRAME_UNEXPECTED.
338 */
339 return h3s->type == H3S_T_CTRL &&
340 !(h3c->flags & H3_CF_SETTINGS_RECV);
341
342 case H3_FT_PUSH_PROMISE:
343 return h3s->type != H3S_T_CTRL &&
344 (id & QCS_ID_SRV_INTIATOR_BIT);
345
346 default:
347 /* draft-ietf-quic-http34 9. Extensions to HTTP/3
348 *
349 * Implementations MUST discard frames [...] that have unknown
350 * or unsupported types.
351 */
352 return h3s->type != H3S_T_CTRL || (h3c->flags & H3_CF_SETTINGS_RECV);
353 }
354}
355
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +0100356/* Check from stream <qcs> that length of all DATA frames does not exceed with
357 * a previously parsed content-length header. <fin> must be set for the last
358 * data of the stream so that length of DATA frames must be equal to the
359 * content-length.
360 *
361 * This must only be called for a stream with H3_SF_HAVE_CLEN flag.
362 *
363 * Return 0 on valid else non-zero.
364 */
365static int h3_check_body_size(struct qcs *qcs, int fin)
366{
367 struct h3s *h3s = qcs->ctx;
368 int ret = 0;
369 TRACE_ENTER(H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
370
371 /* Reserved for streams with a previously parsed content-length header. */
372 BUG_ON(!(h3s->flags & H3_SF_HAVE_CLEN));
373
374 /* RFC 9114 4.1.2. Malformed Requests and Responses
375 *
376 * A request or response that is defined as having content when it
377 * contains a Content-Length header field (Section 8.6 of [HTTP]) is
378 * malformed if the value of the Content-Length header field does not
379 * equal the sum of the DATA frame lengths received.
380 *
381 * TODO for backend support
382 * A response that is
383 * defined as never having content, even when a Content-Length is
384 * present, can have a non-zero Content-Length header field even though
385 * no content is included in DATA frames.
386 */
387 if (h3s->data_len > h3s->body_len ||
388 (fin && h3s->data_len < h3s->body_len)) {
389 TRACE_ERROR("Content-length does not match DATA frame size", H3_EV_RX_FRAME|H3_EV_RX_DATA, qcs->qcc->conn, qcs);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100390 h3s->err = H3_MESSAGE_ERROR;
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +0100391 ret = -1;
392 }
393
394 TRACE_LEAVE(H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
395 return ret;
396}
397
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100398/* Parse from buffer <buf> a H3 HEADERS frame of length <len>. Data are copied
Willy Tarreau4596fe22022-05-17 19:07:51 +0200399 * in a local HTX buffer and transfer to the stream connector layer. <fin> must be
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100400 * set if this is the last data to transfer from this stream.
401 *
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100402 * Returns the number of consumed bytes or a negative error code. On error
403 * either the connection should be closed or the stream reset using codes
404 * provided in h3c.err / h3s.err.
Amaury Denoyelleb9ce14e2021-11-08 09:13:42 +0100405 */
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200406static ssize_t h3_headers_to_htx(struct qcs *qcs, const struct buffer *buf,
407 uint64_t len, char fin)
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100408{
Amaury Denoyelle2bc47862022-06-30 10:04:42 +0200409 struct h3s *h3s = qcs->ctx;
410 struct h3c *h3c = h3s->h3c;
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100411 struct buffer htx_buf = BUF_NULL;
412 struct buffer *tmp = get_trash_chunk();
Amaury Denoyelle7059ebc2021-12-08 15:51:04 +0100413 struct htx *htx = NULL;
Amaury Denoyelleb49fa1a2021-08-24 15:30:12 +0200414 struct htx_sl *sl;
Amaury Denoyellefd7cdc32021-08-24 15:13:20 +0200415 struct http_hdr list[global.tune.max_http_hdr];
Amaury Denoyelleb49fa1a2021-08-24 15:30:12 +0200416 unsigned int flags = HTX_SL_F_NONE;
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100417 struct ist meth = IST_NULL, path = IST_NULL;
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100418 struct ist scheme = IST_NULL, authority = IST_NULL;
Amaury Denoyelle2bc47862022-06-30 10:04:42 +0200419 int hdr_idx, ret;
Amaury Denoyelled6fb7a02022-12-07 14:31:42 +0100420 int cookie = -1, last_cookie = -1, i;
421
422 /* RFC 9114 4.1.2. Malformed Requests and Responses
423 *
424 * A malformed request or response is one that is an otherwise valid
425 * sequence of frames but is invalid due to:
426 * - the presence of prohibited fields or pseudo-header fields,
427 * - the absence of mandatory pseudo-header fields,
428 * - invalid values for pseudo-header fields,
429 * - pseudo-header fields after fields,
430 * - an invalid sequence of HTTP messages,
431 * - the inclusion of uppercase field names, or
432 * - the inclusion of invalid characters in field names or values.
433 *
434 * [...]
435 *
436 * Intermediaries that process HTTP requests or responses (i.e., any
437 * intermediary not acting as a tunnel) MUST NOT forward a malformed
438 * request or response. Malformed requests or responses that are
439 * detected MUST be treated as a stream error of type H3_MESSAGE_ERROR.
440 */
Frédéric Lécailleccac11f2021-03-03 16:09:02 +0100441
Amaury Denoyelle494512d2022-05-30 15:50:34 +0200442 TRACE_ENTER(H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
443
Amaury Denoyelle8d818c62022-08-02 11:32:45 +0200444 /* TODO support trailer parsing in this function */
445
Amaury Denoyelle30f23f52022-04-27 14:41:53 +0200446 /* TODO support buffer wrapping */
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200447 BUG_ON(b_head(buf) + len >= b_wrap(buf));
Amaury Denoyelle2bc47862022-06-30 10:04:42 +0200448 ret = qpack_decode_fs((const unsigned char *)b_head(buf), len, tmp,
449 list, sizeof(list) / sizeof(list[0]));
450 if (ret < 0) {
451 TRACE_ERROR("QPACK decoding error", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
452 h3c->err = -ret;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100453 len = -1;
454 goto out;
Amaury Denoyelle60ef19f2022-06-14 17:38:36 +0200455 }
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100456
Amaury Denoyelle0abde9d2023-05-11 16:52:17 +0200457 if (!qc_get_buf(qcs, &htx_buf)) {
458 TRACE_ERROR("HTX buffer alloc failure", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
459 h3c->err = H3_INTERNAL_ERROR;
460 len = -1;
461 goto out;
462 }
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100463 BUG_ON(!b_size(&htx_buf)); /* TODO */
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100464 htx = htx_from_buf(&htx_buf);
465
466 /* first treat pseudo-header to build the start line */
467 hdr_idx = 0;
468 while (1) {
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100469 /* RFC 9114 4.3. HTTP Control Data
470 *
471 * Endpoints MUST treat a request or response that contains
472 * undefined or invalid pseudo-header fields as malformed.
473 *
474 * All pseudo-header fields MUST appear in the header section before
475 * regular header fields. Any request or response that contains a
476 * pseudo-header field that appears in a header section after a regular
477 * header field MUST be treated as malformed.
478 */
479
480 /* Stop at first non pseudo-header. */
481 if (!istmatch(list[hdr_idx].n, ist(":")))
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100482 break;
483
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100484 /* pseudo-header. Malformed name with uppercase character or
485 * invalid token will be rejected in the else clause.
486 */
487 if (isteq(list[hdr_idx].n, ist(":method"))) {
488 if (isttest(meth)) {
489 TRACE_ERROR("duplicated method pseudo-header", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100490 h3s->err = H3_MESSAGE_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100491 len = -1;
492 goto out;
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100493 }
494 meth = list[hdr_idx].v;
495 }
496 else if (isteq(list[hdr_idx].n, ist(":path"))) {
497 if (isttest(path)) {
498 TRACE_ERROR("duplicated path pseudo-header", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100499 h3s->err = H3_MESSAGE_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100500 len = -1;
501 goto out;
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100502 }
503 path = list[hdr_idx].v;
504 }
505 else if (isteq(list[hdr_idx].n, ist(":scheme"))) {
506 if (isttest(scheme)) {
507 /* duplicated pseudo-header */
508 TRACE_ERROR("duplicated scheme pseudo-header", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100509 h3s->err = H3_MESSAGE_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100510 len = -1;
511 goto out;
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100512 }
513 scheme = list[hdr_idx].v;
514 }
515 else if (isteq(list[hdr_idx].n, ist(":authority"))) {
516 if (isttest(authority)) {
517 TRACE_ERROR("duplicated authority pseudo-header", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100518 h3s->err = H3_MESSAGE_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100519 len = -1;
520 goto out;
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100521 }
522 authority = list[hdr_idx].v;
523 }
524 else {
525 TRACE_ERROR("unknown pseudo-header", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100526 h3s->err = H3_MESSAGE_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100527 len = -1;
528 goto out;
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100529 }
530
531 ++hdr_idx;
532 }
533
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100534 if (!istmatch(meth, ist("CONNECT"))) {
535 /* RFC 9114 4.3.1. Request Pseudo-Header Fields
536 *
537 * All HTTP/3 requests MUST include exactly one value for the :method,
538 * :scheme, and :path pseudo-header fields, unless the request is a
539 * CONNECT request; see Section 4.4.
540 */
541 if (!isttest(meth) || !isttest(scheme) || !isttest(path)) {
542 TRACE_ERROR("missing mandatory pseudo-header", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100543 h3s->err = H3_MESSAGE_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100544 len = -1;
545 goto out;
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100546 }
547 }
548
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100549 flags |= HTX_SL_F_VER_11;
Amaury Denoyelle0fa14a62022-04-26 16:24:39 +0200550 flags |= HTX_SL_F_XFER_LEN;
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100551
552 sl = htx_add_stline(htx, HTX_BLK_REQ_SL, flags, meth, path, ist("HTTP/3.0"));
Amaury Denoyelle2bc47862022-06-30 10:04:42 +0200553 if (!sl) {
554 h3c->err = H3_INTERNAL_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100555 len = -1;
556 goto out;
Amaury Denoyelle2bc47862022-06-30 10:04:42 +0200557 }
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100558
559 if (fin)
560 sl->flags |= HTX_SL_F_BODYLESS;
561
562 sl->info.req.meth = find_http_meth(meth.ptr, meth.len);
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100563
Amaury Denoyellec4913f62022-12-15 10:58:05 +0100564 if (isttest(authority)) {
565 if (!htx_add_header(htx, ist("host"), authority)) {
566 h3c->err = H3_INTERNAL_ERROR;
567 len = -1;
568 goto out;
569 }
570 }
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100571
572 /* now treat standard headers */
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100573 while (1) {
574 if (isteq(list[hdr_idx].n, ist("")))
575 break;
576
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100577 if (istmatch(list[hdr_idx].n, ist(":"))) {
578 TRACE_ERROR("pseudo-header field after fields", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100579 h3s->err = H3_MESSAGE_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100580 len = -1;
581 goto out;
Amaury Denoyelle7b5a6712022-12-07 14:33:26 +0100582 }
583
Amaury Denoyelled6fb7a02022-12-07 14:31:42 +0100584 for (i = 0; i < list[hdr_idx].n.len; ++i) {
585 const char c = list[hdr_idx].n.ptr[i];
586 if ((uint8_t)(c - 'A') < 'Z' - 'A' || !HTTP_IS_TOKEN(c)) {
587 TRACE_ERROR("invalid characters in field name", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100588 h3s->err = H3_MESSAGE_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100589 len = -1;
590 goto out;
Amaury Denoyelled6fb7a02022-12-07 14:31:42 +0100591 }
592 }
593
Amaury Denoyelle115ccce2022-08-17 18:02:47 +0200594 if (isteq(list[hdr_idx].n, ist("cookie"))) {
595 http_cookie_register(list, hdr_idx, &cookie, &last_cookie);
Amaury Denoyelle19942e32022-12-15 09:18:25 +0100596 ++hdr_idx;
Amaury Denoyelle115ccce2022-08-17 18:02:47 +0200597 continue;
598 }
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +0100599 else if (isteq(list[hdr_idx].n, ist("content-length"))) {
600 ret = http_parse_cont_len_header(&list[hdr_idx].v,
601 &h3s->body_len,
602 h3s->flags & H3_SF_HAVE_CLEN);
603 if (ret < 0) {
604 TRACE_ERROR("invalid content-length", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +0100605 h3s->err = H3_MESSAGE_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100606 len = -1;
607 goto out;
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +0100608 }
609 else if (!ret) {
610 /* Skip duplicated value. */
611 ++hdr_idx;
612 continue;
613 }
614
615 h3s->flags |= H3_SF_HAVE_CLEN;
616 /* This will fail if current frame is the last one and
617 * content-length is not null.
618 */
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100619 if (h3_check_body_size(qcs, fin)) {
620 len = -1;
621 goto out;
622 }
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +0100623 }
Amaury Denoyelle8ad26692023-01-17 17:47:06 +0100624 else if (isteq(list[hdr_idx].n, ist("connection")) ||
625 isteq(list[hdr_idx].n, ist("proxy-connection")) ||
626 isteq(list[hdr_idx].n, ist("keep-alive")) ||
627 isteq(list[hdr_idx].n, ist("transfer-encoding"))) {
628 /* RFC 9114 4.2. HTTP Fields
629 *
630 * HTTP/3 does not use the Connection header field to indicate
631 * connection-specific fields; in this protocol, connection-
632 * specific metadata is conveyed by other means. An endpoint
633 * MUST NOT generate an HTTP/3 field section containing
634 * connection-specific fields; any message containing
635 * connection-specific fields MUST be treated as malformed.
636 */
637 TRACE_ERROR("invalid connection header", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
638 h3s->err = H3_MESSAGE_ERROR;
639 len = -1;
640 goto out;
641 }
642 else if (isteq(list[hdr_idx].n, ist("te")) &&
643 !isteq(list[hdr_idx].v, ist("trailers"))) {
644 /* RFC 9114 4.2. HTTP Fields
645 *
646 * The only exception to this is the TE header field, which MAY
647 * be present in an HTTP/3 request header; when it is, it MUST
648 * NOT contain any value other than "trailers".
649 */
650 TRACE_ERROR("invalid te header", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
651 h3s->err = H3_MESSAGE_ERROR;
652 len = -1;
653 goto out;
654 }
Amaury Denoyelle115ccce2022-08-17 18:02:47 +0200655
Amaury Denoyellec4913f62022-12-15 10:58:05 +0100656 if (!htx_add_header(htx, list[hdr_idx].n, list[hdr_idx].v)) {
657 h3c->err = H3_INTERNAL_ERROR;
658 len = -1;
659 goto out;
660 }
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100661 ++hdr_idx;
662 }
663
Amaury Denoyelle115ccce2022-08-17 18:02:47 +0200664 if (cookie >= 0) {
665 if (http_cookie_merge(htx, list, cookie)) {
666 h3c->err = H3_INTERNAL_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100667 len = -1;
668 goto out;
Amaury Denoyelle115ccce2022-08-17 18:02:47 +0200669 }
670 }
671
Amaury Denoyellec4913f62022-12-15 10:58:05 +0100672 if (!htx_add_endof(htx, HTX_BLK_EOH)) {
673 h3c->err = H3_INTERNAL_ERROR;
674 len = -1;
675 goto out;
676 }
677
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100678 if (fin)
679 htx->flags |= HTX_FL_EOM;
680
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100681 htx_to_buf(htx, &htx_buf);
682 htx = NULL;
683
Amaury Denoyellebf86d892023-05-12 18:16:31 +0200684 if (!qc_attach_sc(qcs, &htx_buf, fin)) {
Amaury Denoyelle2bc47862022-06-30 10:04:42 +0200685 h3c->err = H3_INTERNAL_ERROR;
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100686 len = -1;
687 goto out;
Amaury Denoyelle2bc47862022-06-30 10:04:42 +0200688 }
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100689
Amaury Denoyelle114c9c82022-03-28 14:53:45 +0200690 /* RFC 9114 5.2. Connection Shutdown
691 *
692 * The GOAWAY frame contains an identifier that
693 * indicates to the receiver the range of requests or pushes that were
694 * or might be processed in this connection. The server sends a client-
695 * initiated bidirectional stream ID; the client sends a push ID.
696 * Requests or pushes with the indicated identifier or greater are
697 * rejected (Section 4.1.1) by the sender of the GOAWAY. This
698 * identifier MAY be zero if no requests or pushes were processed.
699 */
700 if (qcs->id >= h3c->id_goaway)
701 h3c->id_goaway = qcs->id + 4;
702
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100703 out:
704 /* HTX may be non NULL if error before previous htx_to_buf(). */
705 if (htx)
706 htx_to_buf(htx, &htx_buf);
707
Willy Tarreau4596fe22022-05-17 19:07:51 +0200708 /* buffer is transferred to the stream connector and set to NULL
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100709 * except on stream creation error.
710 */
Amaury Denoyelle788fc052022-12-15 10:53:55 +0100711 if (b_size(&htx_buf)) {
712 b_free(&htx_buf);
713 offer_buffers(NULL, 1);
714 }
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100715
Amaury Denoyelle494512d2022-05-30 15:50:34 +0200716 TRACE_LEAVE(H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle314578a2022-04-27 14:52:52 +0200717 return len;
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +0100718}
719
Amaury Denoyelleedfcb552023-01-13 16:40:31 +0100720/* Parse from buffer <buf> a H3 HEADERS frame of length <len> used as trailers.
721 * Data are copied in a local HTX buffer and transfer to the stream connector
722 * layer. <fin> must be set if this is the last data to transfer from this
723 * stream.
724 *
725 * Returns the number of consumed bytes or a negative error code. On error
726 * either the connection should be closed or the stream reset using codes
727 * provided in h3c.err / h3s.err.
728 */
729static ssize_t h3_trailers_to_htx(struct qcs *qcs, const struct buffer *buf,
730 uint64_t len, char fin)
731{
732 struct h3s *h3s = qcs->ctx;
733 struct h3c *h3c = h3s->h3c;
734 struct buffer htx_buf = BUF_NULL;
735 struct buffer *tmp = get_trash_chunk();
736 struct htx *htx = NULL;
737 struct htx_sl *sl;
738 struct http_hdr list[global.tune.max_http_hdr];
739 int hdr_idx, ret;
740 int i;
741
742 TRACE_ENTER(H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
743
744 /* TODO support buffer wrapping */
745 BUG_ON(b_head(buf) + len >= b_wrap(buf));
746 ret = qpack_decode_fs((const unsigned char *)b_head(buf), len, tmp,
747 list, sizeof(list) / sizeof(list[0]));
748 if (ret < 0) {
749 TRACE_ERROR("QPACK decoding error", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
750 h3c->err = -ret;
751 len = -1;
752 goto out;
753 }
754
Amaury Denoyelle0abde9d2023-05-11 16:52:17 +0200755 if (!qc_get_buf(qcs, &htx_buf)) {
756 TRACE_ERROR("HTX buffer alloc failure", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
757 h3c->err = H3_INTERNAL_ERROR;
758 len = -1;
759 goto out;
760 }
Amaury Denoyelleedfcb552023-01-13 16:40:31 +0100761 BUG_ON(!b_size(&htx_buf)); /* TODO */
762 htx = htx_from_buf(&htx_buf);
763
764 if (!h3s->data_len) {
765 /* Notify that no body is present. This can only happens if
766 * there is H3 HEADERS as trailers without or empty H3 DATA
767 * frame. So this is probably not realistice ?
768 *
769 * TODO if sl is NULL because already consumed there is no way
770 * to notify about missing body.
771 */
772 sl = http_get_stline(htx);
773 if (sl)
774 sl->flags |= HTX_SL_F_BODYLESS;
775 else
776 TRACE_ERROR("cannot notify missing body after trailers", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
777 }
778
779 hdr_idx = 0;
780 while (1) {
781 if (isteq(list[hdr_idx].n, ist("")))
782 break;
783
784 /* RFC 9114 4.3. HTTP Control Data
785 *
786 * Pseudo-header
787 * fields MUST NOT appear in trailer sections.
788 */
789 if (istmatch(list[hdr_idx].n, ist(":"))) {
790 TRACE_ERROR("pseudo-header field in trailers", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
791 h3s->err = H3_MESSAGE_ERROR;
792 len = -1;
793 goto out;
794 }
795
796 for (i = 0; i < list[hdr_idx].n.len; ++i) {
797 const char c = list[hdr_idx].n.ptr[i];
798 if ((uint8_t)(c - 'A') < 'Z' - 'A' || !HTTP_IS_TOKEN(c)) {
799 TRACE_ERROR("invalid characters in field name", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
800 h3s->err = H3_MESSAGE_ERROR;
801 len = -1;
802 goto out;
803 }
804 }
805
806 /* forbidden HTTP/3 headers, cf h3_headers_to_htx() */
807 if (isteq(list[hdr_idx].n, ist("host")) ||
808 isteq(list[hdr_idx].n, ist("content-length")) ||
809 isteq(list[hdr_idx].n, ist("connection")) ||
810 isteq(list[hdr_idx].n, ist("proxy-connection")) ||
811 isteq(list[hdr_idx].n, ist("keep-alive")) ||
812 isteq(list[hdr_idx].n, ist("te")) ||
813 isteq(list[hdr_idx].n, ist("transfer-encoding"))) {
814 TRACE_ERROR("forbidden HTTP/3 headers", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
815 h3s->err = H3_MESSAGE_ERROR;
816 len = -1;
817 goto out;
818 }
819
820 if (!htx_add_trailer(htx, list[hdr_idx].n, list[hdr_idx].v)) {
821 TRACE_ERROR("cannot add trailer", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
822 h3c->err = H3_INTERNAL_ERROR;
823 len = -1;
824 goto out;
825 }
826
827 ++hdr_idx;
828 }
829
830 if (!htx_add_endof(htx, HTX_BLK_EOT)) {
831 TRACE_ERROR("cannot add trailer", H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
832 h3c->err = H3_INTERNAL_ERROR;
833 len = -1;
834 goto out;
835 }
836
837 if (fin)
838 htx->flags |= HTX_FL_EOM;
839
840 htx_to_buf(htx, &htx_buf);
841 htx = NULL;
842
843 out:
844 /* HTX may be non NULL if error before previous htx_to_buf(). */
845 if (htx)
846 htx_to_buf(htx, &htx_buf);
847
848 TRACE_LEAVE(H3_EV_RX_FRAME|H3_EV_RX_HDR, qcs->qcc->conn, qcs);
849 return len;
850}
851
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100852/* Copy from buffer <buf> a H3 DATA frame of length <len> in QUIC stream <qcs>
853 * HTX buffer. <fin> must be set if this is the last data to transfer from this
854 * stream.
855 *
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200856 * Returns the number of consumed bytes or a negative error code.
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100857 */
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200858static ssize_t h3_data_to_htx(struct qcs *qcs, const struct buffer *buf,
859 uint64_t len, char fin)
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100860{
Amaury Denoyelle0abde9d2023-05-11 16:52:17 +0200861 struct h3s *h3s = qcs->ctx;
862 struct h3c *h3c = h3s->h3c;
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100863 struct buffer *appbuf;
864 struct htx *htx = NULL;
Amaury Denoyelle1290f1e2022-05-13 14:49:05 +0200865 size_t htx_sent = 0;
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100866 int htx_space;
Amaury Denoyelle30f23f52022-04-27 14:41:53 +0200867 char *head;
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100868
Amaury Denoyelle494512d2022-05-30 15:50:34 +0200869 TRACE_ENTER(H3_EV_RX_FRAME|H3_EV_RX_DATA, qcs->qcc->conn, qcs);
870
Amaury Denoyelle0abde9d2023-05-11 16:52:17 +0200871 if (!(appbuf = qc_get_buf(qcs, &qcs->rx.app_buf))) {
872 TRACE_ERROR("data buffer alloc failure", H3_EV_RX_FRAME|H3_EV_RX_DATA, qcs->qcc->conn, qcs);
873 h3c->err = H3_INTERNAL_ERROR;
874 len = -1;
875 goto out;
876 }
877
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100878 htx = htx_from_buf(appbuf);
879
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200880 if (len > b_data(buf)) {
881 len = b_data(buf);
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +0200882 fin = 0;
883 }
884
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200885 head = b_head(buf);
Amaury Denoyelle30f23f52022-04-27 14:41:53 +0200886 retry:
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100887 htx_space = htx_free_data_space(htx);
Amaury Denoyellef1fc0b32022-05-02 11:07:06 +0200888 if (!htx_space) {
889 qcs->flags |= QC_SF_DEM_FULL;
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +0200890 goto out;
Amaury Denoyellef1fc0b32022-05-02 11:07:06 +0200891 }
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +0200892
893 if (len > htx_space) {
894 len = htx_space;
895 fin = 0;
Amaury Denoyelleff191de2022-02-21 18:38:29 +0100896 }
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100897
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200898 if (head + len > b_wrap(buf)) {
899 size_t contig = b_wrap(buf) - head;
900 htx_sent = htx_add_data(htx, ist2(b_head(buf), contig));
Amaury Denoyelle73d6ffe2022-05-16 13:54:31 +0200901 if (htx_sent < contig) {
902 qcs->flags |= QC_SF_DEM_FULL;
903 goto out;
904 }
905
Amaury Denoyelle30f23f52022-04-27 14:41:53 +0200906 len -= contig;
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200907 head = b_orig(buf);
Amaury Denoyelle30f23f52022-04-27 14:41:53 +0200908 goto retry;
Amaury Denoyelleff191de2022-02-21 18:38:29 +0100909 }
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100910
Amaury Denoyelle30f23f52022-04-27 14:41:53 +0200911 htx_sent += htx_add_data(htx, ist2(head, len));
Amaury Denoyelle73d6ffe2022-05-16 13:54:31 +0200912 if (htx_sent < len) {
913 qcs->flags |= QC_SF_DEM_FULL;
914 goto out;
915 }
Amaury Denoyelle30f23f52022-04-27 14:41:53 +0200916
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +0200917 if (fin && len == htx_sent)
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100918 htx->flags |= HTX_FL_EOM;
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100919
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +0200920 out:
Amaury Denoyelle0abde9d2023-05-11 16:52:17 +0200921 if (appbuf)
922 htx_to_buf(htx, appbuf);
Amaury Denoyelle494512d2022-05-30 15:50:34 +0200923
924 TRACE_LEAVE(H3_EV_RX_FRAME|H3_EV_RX_DATA, qcs->qcc->conn, qcs);
Amaury Denoyelle314578a2022-04-27 14:52:52 +0200925 return htx_sent;
Amaury Denoyelle91379f72022-02-14 17:14:59 +0100926}
927
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200928/* Parse a SETTINGS frame of length <len> of payload <buf>.
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +0200929 *
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200930 * Returns the number of consumed bytes or a negative error code.
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +0200931 */
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +0200932static ssize_t h3_parse_settings_frm(struct h3c *h3c, const struct buffer *buf,
933 size_t len)
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +0200934{
Amaury Denoyelle8c6176b2022-05-24 18:16:49 +0200935 struct buffer b;
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +0200936 uint64_t id, value;
Amaury Denoyelle8c6176b2022-05-24 18:16:49 +0200937 size_t ret = 0;
938 long mask = 0; /* used to detect duplicated settings identifier */
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +0200939
Amaury Denoyelle494512d2022-05-30 15:50:34 +0200940 TRACE_ENTER(H3_EV_RX_FRAME|H3_EV_RX_SETTINGS, h3c->qcc->conn);
941
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200942 /* Work on a copy of <buf>. */
Amaury Denoyelle3a2fcfd2022-06-09 11:54:38 +0200943 b = b_make(b_orig(buf), b_size(buf), b_head_ofs(buf), len);
Amaury Denoyelle62eef852022-06-03 16:40:34 +0200944
Amaury Denoyelle8c6176b2022-05-24 18:16:49 +0200945 while (b_data(&b)) {
946 if (!b_quic_dec_int(&id, &b, &ret) || !b_quic_dec_int(&value, &b, &ret)) {
947 h3c->err = H3_FRAME_ERROR;
948 return -1;
949 }
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +0200950
951 h3_debug_printf(stderr, "%s id: %llu value: %llu\n",
952 __func__, (unsigned long long)id, (unsigned long long)value);
Amaury Denoyelle8c6176b2022-05-24 18:16:49 +0200953
954 /* draft-ietf-quic-http34 7.2.4. SETTINGS
955 *
956 * The same setting identifier MUST NOT occur more than once in the
957 * SETTINGS frame. A receiver MAY treat the presence of duplicate
958 * setting identifiers as a connection error of type H3_SETTINGS_ERROR.
959 */
960
961 /* Ignore duplicate check for ID too big used for GREASE. */
962 if (id < sizeof(mask)) {
963 if (ha_bit_test(id, &mask)) {
964 h3c->err = H3_SETTINGS_ERROR;
965 return -1;
966 }
967 ha_bit_set(id, &mask);
968 }
969
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +0200970 switch (id) {
971 case H3_SETTINGS_QPACK_MAX_TABLE_CAPACITY:
972 h3c->qpack_max_table_capacity = value;
973 break;
974 case H3_SETTINGS_MAX_FIELD_SECTION_SIZE:
975 h3c->max_field_section_size = value;
976 break;
977 case H3_SETTINGS_QPACK_BLOCKED_STREAMS:
978 h3c->qpack_blocked_streams = value;
979 break;
Amaury Denoyelle8c6176b2022-05-24 18:16:49 +0200980
981 case H3_SETTINGS_RESERVED_0:
982 case H3_SETTINGS_RESERVED_2:
983 case H3_SETTINGS_RESERVED_3:
984 case H3_SETTINGS_RESERVED_4:
985 case H3_SETTINGS_RESERVED_5:
986 /* draft-ietf-quic-http34 7.2.4.1. Defined SETTINGS Parameters
987 *
988 * Setting identifiers which were defined in [HTTP2] where there is no
989 * corresponding HTTP/3 setting have also been reserved
990 * (Section 11.2.2). These reserved settings MUST NOT be sent, and
991 * their receipt MUST be treated as a connection error of type
992 * H3_SETTINGS_ERROR.
993 */
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +0200994 h3c->err = H3_SETTINGS_ERROR;
Amaury Denoyelle8c6176b2022-05-24 18:16:49 +0200995 return -1;
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +0200996 default:
997 /* MUST be ignored */
998 break;
999 }
1000 }
1001
Frédéric Lécaillebefcf702022-09-08 16:04:55 +02001002 TRACE_LEAVE(H3_EV_RX_FRAME|H3_EV_RX_SETTINGS, h3c->qcc->conn);
Amaury Denoyelle8c6176b2022-05-24 18:16:49 +02001003 return ret;
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +02001004}
1005
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +01001006/* Decode <qcs> remotely initiated bidi-stream. <fin> must be set to indicate
1007 * that we received the last data of the stream.
Amaury Denoyelle0ffd6e72022-05-24 11:07:28 +02001008 *
1009 * Returns 0 on success else non-zero.
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +01001010 */
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +02001011static ssize_t h3_decode_qcs(struct qcs *qcs, struct buffer *b, int fin)
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +01001012{
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +02001013 struct h3s *h3s = qcs->ctx;
Amaury Denoyellec0156792022-06-03 15:29:07 +02001014 struct h3c *h3c = h3s->h3c;
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +02001015 ssize_t total = 0, ret;
Amaury Denoyelle7b0f1222022-02-14 17:13:55 +01001016
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001017 TRACE_ENTER(H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001018
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +02001019 if (quic_stream_is_uni(qcs->id) && !(h3s->flags & H3_SF_UNI_INIT)) {
Amaury Denoyelle5aa21c12023-03-09 11:12:32 +01001020 ret = h3_init_uni_stream(h3c, qcs, b);
1021 if (ret < 0) {
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001022 TRACE_ERROR("cannot initialize uni stream", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
1023 goto err;
1024 }
Amaury Denoyelle5aa21c12023-03-09 11:12:32 +01001025 else if (!ret) {
1026 /* not enough data to initialize uni stream, retry later */
1027 goto done;
1028 }
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +02001029
1030 total += ret;
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +02001031 }
1032
1033 if (quic_stream_is_uni(qcs->id) && (h3s->flags & H3_SF_UNI_NO_H3)) {
1034 /* For non-h3 STREAM, parse it and return immediately. */
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001035 if ((ret = h3_parse_uni_stream_no_h3(qcs, b, fin)) < 0) {
1036 TRACE_ERROR("error when parsing non-HTTP3 uni stream", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
1037 goto err;
1038 }
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +02001039
1040 total += ret;
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001041 goto done;
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +02001042 }
1043
Amaury Denoyelle6b02c6b2022-08-16 17:16:47 +02001044 /* RFC 9114 6.2.1. Control Streams
1045 *
1046 * The sender MUST NOT close the control stream, and the receiver MUST NOT
1047 * request that the sender close the control stream. If either control
1048 * stream is closed at any point, this MUST be treated as a connection
1049 * error of type H3_CLOSED_CRITICAL_STREAM.
1050 */
1051 if (h3s->type == H3S_T_CTRL && fin) {
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001052 TRACE_ERROR("control stream closed by remote peer", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
Amaury Denoyelle58721f22023-05-09 18:01:09 +02001053 qcc_set_error(qcs->qcc, H3_CLOSED_CRITICAL_STREAM, 1);
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001054 goto err;
Amaury Denoyelle6b02c6b2022-08-16 17:16:47 +02001055 }
1056
Amaury Denoyelle381d8132023-02-17 09:51:20 +01001057 if (!b_data(b) && fin && quic_stream_is_bidi(qcs->id)) {
Amaury Denoyelle93dd23c2023-05-11 16:49:28 +02001058 struct buffer *appbuf;
1059 struct htx *htx;
1060
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001061 TRACE_PROTO("received FIN without data", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
Amaury Denoyelle0abde9d2023-05-11 16:52:17 +02001062 if (!(appbuf = qc_get_buf(qcs, &qcs->rx.app_buf))) {
1063 TRACE_ERROR("data buffer alloc failure", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
1064 h3c->err = H3_INTERNAL_ERROR;
Amaury Denoyelle6133aba2023-05-15 09:35:59 +02001065 goto err;
Amaury Denoyelle0abde9d2023-05-11 16:52:17 +02001066 }
Amaury Denoyelle93dd23c2023-05-11 16:49:28 +02001067
1068 htx = htx_from_buf(appbuf);
1069 if (!htx_set_eom(htx)) {
1070 TRACE_ERROR("cannot set EOM", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
1071 h3c->err = H3_INTERNAL_ERROR;
1072 }
1073 htx_to_buf(htx, appbuf);
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001074 goto done;
Amaury Denoyelle381d8132023-02-17 09:51:20 +01001075 }
1076
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +01001077 while (b_data(b) && !(qcs->flags & QC_SF_DEM_FULL) && !h3c->err && !h3s->err) {
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001078 uint64_t ftype, flen;
Amaury Denoyelle95b93a32022-02-14 15:49:53 +01001079 char last_stream_frame = 0;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001080
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +02001081 if (!h3s->demux_frame_len) {
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +01001082 /* Switch to a new frame. */
Amaury Denoyelle62eef852022-06-03 16:40:34 +02001083 size_t hlen = h3_decode_frm_header(&ftype, &flen, b);
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001084 if (!hlen) {
1085 TRACE_PROTO("pause parsing on incomplete frame header", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +02001086 break;
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001087 }
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001088
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +02001089 h3s->demux_frame_type = ftype;
1090 h3s->demux_frame_len = flen;
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +02001091 total += hlen;
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001092 TRACE_PROTO("parsing a new frame", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
Amaury Denoyelle417c7c02022-05-31 14:18:33 +02001093
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +01001094 /* Check that content-length is not exceeded on a new DATA frame. */
1095 if (ftype == H3_FT_DATA) {
1096 h3s->data_len += flen;
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +01001097 if (h3s->flags & H3_SF_HAVE_CLEN && h3_check_body_size(qcs, fin))
1098 break;
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +01001099 }
1100
Amaury Denoyelle417c7c02022-05-31 14:18:33 +02001101 if (!h3_is_frame_valid(h3c, qcs, ftype)) {
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001102 TRACE_ERROR("received an invalid frame", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
Amaury Denoyelle58721f22023-05-09 18:01:09 +02001103 qcc_set_error(qcs->qcc, H3_FRAME_UNEXPECTED, 1);
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001104 goto err;
Amaury Denoyelle417c7c02022-05-31 14:18:33 +02001105 }
1106
Amaury Denoyelle62eef852022-06-03 16:40:34 +02001107 if (!b_data(b))
Amaury Denoyelle417c7c02022-05-31 14:18:33 +02001108 break;
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +02001109 }
Amaury Denoyelle0484f922022-02-15 16:59:39 +01001110
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +02001111 flen = h3s->demux_frame_len;
1112 ftype = h3s->demux_frame_type;
Amaury Denoyelle80097cc2022-05-24 11:13:46 +02001113
1114 /* Do not demux incomplete frames except H3 DATA which can be
1115 * fragmented in multiple HTX blocks.
1116 */
Amaury Denoyelle62eef852022-06-03 16:40:34 +02001117 if (flen > b_data(b) && ftype != H3_FT_DATA) {
Amaury Denoyelle80097cc2022-05-24 11:13:46 +02001118 /* Reject frames bigger than bufsize.
1119 *
1120 * TODO HEADERS should in complement be limited with H3
1121 * SETTINGS_MAX_FIELD_SECTION_SIZE parameter to prevent
1122 * excessive decompressed size.
1123 */
Amaury Denoyelle62eef852022-06-03 16:40:34 +02001124 if (flen > QC_S_RX_BUF_SZ) {
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001125 TRACE_ERROR("received a too big frame", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
Amaury Denoyelle58721f22023-05-09 18:01:09 +02001126 qcc_set_error(qcs->qcc, H3_EXCESSIVE_LOAD, 1);
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001127 goto err;
Amaury Denoyelle80097cc2022-05-24 11:13:46 +02001128 }
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +02001129 break;
Amaury Denoyelleb5454d42022-05-12 16:56:16 +02001130 }
Amaury Denoyelle80097cc2022-05-24 11:13:46 +02001131
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +01001132 /* Check content-length equality with DATA frames length on the last frame. */
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +01001133 if (fin && h3s->flags & H3_SF_HAVE_CLEN && h3_check_body_size(qcs, fin))
1134 break;
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +01001135
Amaury Denoyelle62eef852022-06-03 16:40:34 +02001136 last_stream_frame = (fin && flen == b_data(b));
Amaury Denoyelle95b93a32022-02-14 15:49:53 +01001137
Frédéric Lécaille6f7607e2022-05-25 22:25:37 +02001138 h3_inc_frame_type_cnt(h3c->prx_counters, ftype);
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001139 switch (ftype) {
1140 case H3_FT_DATA:
Amaury Denoyelle62eef852022-06-03 16:40:34 +02001141 ret = h3_data_to_htx(qcs, b, flen, last_stream_frame);
Amaury Denoyelle8d818c62022-08-02 11:32:45 +02001142 h3s->st_req = H3S_ST_REQ_DATA;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001143 break;
1144 case H3_FT_HEADERS:
Amaury Denoyelleedfcb552023-01-13 16:40:31 +01001145 if (h3s->st_req == H3S_ST_REQ_BEFORE) {
1146 ret = h3_headers_to_htx(qcs, b, flen, last_stream_frame);
1147 h3s->st_req = H3S_ST_REQ_HEADERS;
1148 }
1149 else {
1150 ret = h3_trailers_to_htx(qcs, b, flen, last_stream_frame);
1151 h3s->st_req = H3S_ST_REQ_TRAILERS;
1152 }
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001153 break;
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +02001154 case H3_FT_CANCEL_PUSH:
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001155 case H3_FT_PUSH_PROMISE:
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +02001156 case H3_FT_MAX_PUSH_ID:
1157 case H3_FT_GOAWAY:
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001158 /* Not supported */
Amaury Denoyelle80097cc2022-05-24 11:13:46 +02001159 ret = flen;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001160 break;
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +02001161 case H3_FT_SETTINGS:
Amaury Denoyelle62eef852022-06-03 16:40:34 +02001162 ret = h3_parse_settings_frm(qcs->qcc->ctx, b, flen);
Amaury Denoyelle8c6176b2022-05-24 18:16:49 +02001163 if (ret < 0) {
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001164 TRACE_ERROR("error on SETTINGS parsing", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
Amaury Denoyelle58721f22023-05-09 18:01:09 +02001165 qcc_set_error(qcs->qcc, h3c->err, 1);
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001166 goto err;
Amaury Denoyelle8c6176b2022-05-24 18:16:49 +02001167 }
1168 h3c->flags |= H3_CF_SETTINGS_RECV;
Amaury Denoyellef8db5aa2022-05-24 15:26:07 +02001169 break;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001170 default:
Amaury Denoyelled1acaf92021-11-15 15:52:55 +01001171 /* draft-ietf-quic-http34 9. Extensions to HTTP/3
Amaury Denoyelle302ecd42022-05-24 15:24:32 +02001172 *
1173 * Implementations MUST discard frames [...] that have unknown
1174 * or unsupported types.
Amaury Denoyelled1acaf92021-11-15 15:52:55 +01001175 */
Amaury Denoyelle80097cc2022-05-24 11:13:46 +02001176 ret = flen;
1177 break;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001178 }
Amaury Denoyelle314578a2022-04-27 14:52:52 +02001179
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +01001180 if (ret > 0) {
Amaury Denoyelle291ee252022-05-02 10:35:39 +02001181 BUG_ON(h3s->demux_frame_len < ret);
1182 h3s->demux_frame_len -= ret;
Amaury Denoyelle62eef852022-06-03 16:40:34 +02001183 b_del(b, ret);
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +02001184 total += ret;
Amaury Denoyelle291ee252022-05-02 10:35:39 +02001185 }
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001186 }
1187
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001188 /* Reset demux frame type for traces. */
1189 if (!h3s->demux_frame_len)
1190 h3s->demux_frame_type = H3_FT_UNINIT;
1191
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +01001192 /* Interrupt decoding on stream/connection error detected. */
1193 if (h3s->err) {
1194 qcc_abort_stream_read(qcs);
1195 qcc_reset_stream(qcs, h3s->err);
1196 return b_data(b);
1197 }
1198 else if (h3c->err) {
Amaury Denoyelle58721f22023-05-09 18:01:09 +02001199 qcc_set_error(qcs->qcc, h3c->err, 1);
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +01001200 return b_data(b);
1201 }
1202
Amaury Denoyelle03cc62c2022-04-27 16:53:16 +02001203 /* TODO may be useful to wakeup the MUX if blocked due to full buffer.
1204 * However, currently, io-cb of MUX does not handle Rx.
1205 */
1206
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001207 done:
1208 TRACE_LEAVE(H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
Amaury Denoyelle1f21ebd2022-06-07 17:30:55 +02001209 return total;
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001210
1211 err:
1212 TRACE_DEVEL("leaving on error", H3_EV_RX_FRAME, qcs->qcc->conn, qcs);
1213 return -1;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001214}
1215
Amaury Denoyellea5871362021-10-07 16:26:12 +02001216/* Returns buffer for data sending.
1217 * May be NULL if the allocation failed.
1218 */
1219static struct buffer *mux_get_buf(struct qcs *qcs)
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001220{
Amaury Denoyellea5871362021-10-07 16:26:12 +02001221 if (!b_size(&qcs->tx.buf))
1222 b_alloc(&qcs->tx.buf);
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001223
Amaury Denoyellea5871362021-10-07 16:26:12 +02001224 return &qcs->tx.buf;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001225}
1226
Amaury Denoyelle6b923942022-05-23 14:25:53 +02001227/* Function used to emit stream data from <qcs> control uni-stream */
1228static int h3_control_send(struct qcs *qcs, void *ctx)
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001229{
1230 int ret;
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +02001231 struct h3c *h3c = ctx;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001232 unsigned char data[(2 + 3) * 2 * QUIC_VARINT_MAX_SIZE]; /* enough for 3 settings */
Amaury Denoyellea5871362021-10-07 16:26:12 +02001233 struct buffer pos, *res;
Amaury Denoyelle65df3ad2022-05-24 15:06:10 +02001234 size_t frm_len;
Amaury Denoyelle65df3ad2022-05-24 15:06:10 +02001235
Amaury Denoyellea717eb72022-05-30 15:51:01 +02001236 TRACE_ENTER(H3_EV_TX_SETTINGS, qcs->qcc->conn, qcs);
1237
Amaury Denoyelle65df3ad2022-05-24 15:06:10 +02001238 BUG_ON_HOT(h3c->flags & H3_CF_SETTINGS_SENT);
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001239
1240 ret = 0;
Amaury Denoyellea5871362021-10-07 16:26:12 +02001241 pos = b_make((char *)data, sizeof(data), 0, 0);
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001242
Amaury Denoyelle65df3ad2022-05-24 15:06:10 +02001243 frm_len = quic_int_getsize(H3_SETTINGS_QPACK_MAX_TABLE_CAPACITY) +
1244 quic_int_getsize(h3_settings_qpack_max_table_capacity) +
1245 quic_int_getsize(H3_SETTINGS_QPACK_BLOCKED_STREAMS) +
1246 quic_int_getsize(h3_settings_qpack_blocked_streams);
1247 if (h3_settings_max_field_section_size) {
1248 frm_len += quic_int_getsize(H3_SETTINGS_MAX_FIELD_SECTION_SIZE) +
1249 quic_int_getsize(h3_settings_max_field_section_size);
1250 }
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001251
Amaury Denoyelle7d78eff2023-01-17 15:21:16 +01001252 b_quic_enc_int(&pos, H3_UNI_S_T_CTRL, 0);
Amaury Denoyelle65df3ad2022-05-24 15:06:10 +02001253 /* Build a SETTINGS frame */
Amaury Denoyelle7d78eff2023-01-17 15:21:16 +01001254 b_quic_enc_int(&pos, H3_FT_SETTINGS, 0);
1255 b_quic_enc_int(&pos, frm_len, 0);
1256 b_quic_enc_int(&pos, H3_SETTINGS_QPACK_MAX_TABLE_CAPACITY, 0);
1257 b_quic_enc_int(&pos, h3_settings_qpack_max_table_capacity, 0);
1258 b_quic_enc_int(&pos, H3_SETTINGS_QPACK_BLOCKED_STREAMS, 0);
1259 b_quic_enc_int(&pos, h3_settings_qpack_blocked_streams, 0);
Amaury Denoyelle65df3ad2022-05-24 15:06:10 +02001260 if (h3_settings_max_field_section_size) {
Amaury Denoyelle7d78eff2023-01-17 15:21:16 +01001261 b_quic_enc_int(&pos, H3_SETTINGS_MAX_FIELD_SECTION_SIZE, 0);
1262 b_quic_enc_int(&pos, h3_settings_max_field_section_size, 0);
Amaury Denoyelle65df3ad2022-05-24 15:06:10 +02001263 }
Amaury Denoyellea5871362021-10-07 16:26:12 +02001264
Amaury Denoyelle65df3ad2022-05-24 15:06:10 +02001265 res = mux_get_buf(qcs);
1266 if (b_room(res) < b_data(&pos)) {
1267 // TODO the mux should be put in blocked state, with
1268 // the stream in state waiting for settings to be sent
1269 ABORT_NOW();
1270 }
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001271
Amaury Denoyelle65df3ad2022-05-24 15:06:10 +02001272 ret = b_force_xfer(res, &pos, b_data(&pos));
Amaury Denoyelle20f2a422023-01-03 14:39:24 +01001273 if (ret > 0) {
1274 /* Register qcs for sending before other streams. */
Amaury Denoyellef9b03262023-01-09 10:34:25 +01001275 qcc_send_stream(qcs, 1);
Amaury Denoyelle65df3ad2022-05-24 15:06:10 +02001276 h3c->flags |= H3_CF_SETTINGS_SENT;
Amaury Denoyelle20f2a422023-01-03 14:39:24 +01001277 }
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001278
Amaury Denoyellea717eb72022-05-30 15:51:01 +02001279 TRACE_LEAVE(H3_EV_TX_SETTINGS, qcs->qcc->conn, qcs);
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001280 return ret;
1281}
1282
Amaury Denoyelle15b09612021-08-24 16:20:27 +02001283static int h3_resp_headers_send(struct qcs *qcs, struct htx *htx)
1284{
1285 struct buffer outbuf;
1286 struct buffer headers_buf = BUF_NULL;
1287 struct buffer *res;
1288 struct http_hdr list[global.tune.max_http_hdr];
1289 struct htx_sl *sl;
1290 struct htx_blk *blk;
1291 enum htx_blk_type type;
1292 int frame_length_size; /* size in bytes of frame length varint field */
1293 int ret = 0;
1294 int hdr;
1295 int status = 0;
1296
Amaury Denoyellea717eb72022-05-30 15:51:01 +02001297 TRACE_ENTER(H3_EV_TX_HDR, qcs->qcc->conn, qcs);
1298
Amaury Denoyelle15b09612021-08-24 16:20:27 +02001299 sl = NULL;
1300 hdr = 0;
1301 for (blk = htx_get_head_blk(htx); blk; blk = htx_get_next_blk(htx, blk)) {
1302 type = htx_get_blk_type(blk);
1303
1304 if (type == HTX_BLK_UNUSED)
1305 continue;
1306
1307 if (type == HTX_BLK_EOH)
1308 break;
1309
1310 if (type == HTX_BLK_RES_SL) {
1311 /* start-line -> HEADERS h3 frame */
1312 BUG_ON(sl);
1313 sl = htx_get_blk_ptr(htx, blk);
1314 /* TODO should be on h3 layer */
1315 status = sl->info.res.status;
1316 }
1317 else if (type == HTX_BLK_HDR) {
Amaury Denoyelle60ef19f2022-06-14 17:38:36 +02001318 if (unlikely(hdr >= sizeof(list) / sizeof(list[0]) - 1))
Amaury Denoyellefa7fadc2022-06-15 15:52:27 +02001319 goto err;
Amaury Denoyelle15b09612021-08-24 16:20:27 +02001320 list[hdr].n = htx_get_blk_name(htx, blk);
1321 list[hdr].v = htx_get_blk_value(htx, blk);
1322 hdr++;
1323 }
1324 else {
1325 ABORT_NOW();
1326 goto err;
1327 }
1328 }
1329
1330 BUG_ON(!sl);
1331
1332 list[hdr].n = ist("");
1333
Amaury Denoyelled3d97c62021-10-05 11:45:58 +02001334 res = mux_get_buf(qcs);
Amaury Denoyelle15b09612021-08-24 16:20:27 +02001335
1336 /* At least 5 bytes to store frame type + length as a varint max size */
1337 if (b_room(res) < 5)
1338 ABORT_NOW();
1339
1340 b_reset(&outbuf);
1341 outbuf = b_make(b_tail(res), b_contig_space(res), 0, 0);
1342 /* Start the headers after frame type + length */
1343 headers_buf = b_make(b_head(res) + 5, b_size(res) - 5, 0, 0);
1344
1345 if (qpack_encode_field_section_line(&headers_buf))
1346 ABORT_NOW();
1347 if (qpack_encode_int_status(&headers_buf, status))
1348 ABORT_NOW();
1349
1350 for (hdr = 0; hdr < sizeof(list) / sizeof(list[0]); ++hdr) {
1351 if (isteq(list[hdr].n, ist("")))
1352 break;
1353
Amaury Denoyelle8ad26692023-01-17 17:47:06 +01001354 /* RFC 9114 4.2. HTTP Fields
1355 *
1356 * An intermediary transforming an HTTP/1.x message to HTTP/3
1357 * MUST remove connection-specific header fields as discussed in
1358 * Section 7.6.1 of [HTTP], or their messages will be treated by
1359 * other HTTP/3 endpoints as malformed.
Amaury Denoyelleffafb3d2022-02-15 16:10:42 +01001360 */
Amaury Denoyelle8ad26692023-01-17 17:47:06 +01001361 if (isteq(list[hdr].n, ist("connection")) ||
1362 isteq(list[hdr].n, ist("proxy-connection")) ||
1363 isteq(list[hdr].n, ist("keep-alive")) ||
1364 isteq(list[hdr].n, ist("transfer-encoding"))) {
Amaury Denoyelleffafb3d2022-02-15 16:10:42 +01001365 continue;
Amaury Denoyelle8ad26692023-01-17 17:47:06 +01001366 }
1367 else if (isteq(list[hdr].n, ist("te"))) {
1368 /* "te" may only be sent with "trailers" if this value
1369 * is present, otherwise it must be deleted.
1370 */
1371 const struct ist v = istist(list[hdr].v, ist("trailers"));
1372 if (!isttest(v) || (v.len > 8 && v.ptr[8] != ','))
1373 continue;
1374 list[hdr].v = ist("trailers");
1375 }
Amaury Denoyelleffafb3d2022-02-15 16:10:42 +01001376
Amaury Denoyelle15b09612021-08-24 16:20:27 +02001377 if (qpack_encode_header(&headers_buf, list[hdr].n, list[hdr].v))
1378 ABORT_NOW();
1379 }
1380
1381 /* Now that all headers are encoded, we are certain that res buffer is
1382 * big enough
1383 */
1384 frame_length_size = quic_int_getsize(b_data(&headers_buf));
1385 res->head += 4 - frame_length_size;
1386 b_putchr(res, 0x01); /* h3 HEADERS frame type */
Amaury Denoyelle7d78eff2023-01-17 15:21:16 +01001387 if (!b_quic_enc_int(res, b_data(&headers_buf), 0))
Amaury Denoyelle15b09612021-08-24 16:20:27 +02001388 ABORT_NOW();
1389 b_add(res, b_data(&headers_buf));
1390
1391 ret = 0;
1392 blk = htx_get_head_blk(htx);
1393 while (blk) {
1394 type = htx_get_blk_type(blk);
1395 ret += htx_get_blksz(blk);
1396 blk = htx_remove_blk(htx, blk);
1397 if (type == HTX_BLK_EOH)
1398 break;
1399 }
1400
Amaury Denoyellea717eb72022-05-30 15:51:01 +02001401 TRACE_LEAVE(H3_EV_TX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle15b09612021-08-24 16:20:27 +02001402 return ret;
1403
1404 err:
Amaury Denoyellea717eb72022-05-30 15:51:01 +02001405 TRACE_DEVEL("leaving on error", H3_EV_TX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle15b09612021-08-24 16:20:27 +02001406 return 0;
1407}
1408
Amaury Denoyelle4e520102023-01-12 14:53:43 +01001409/* Convert a series of HTX trailer blocks from <htx> buffer into <qcs> buffer
1410 * as a H3 HEADERS frame. H3 forbidden trailers are skipped. HTX trailer blocks
1411 * are removed from <htx> until EOT is found and itself removed.
1412 *
1413 * If only a EOT HTX block is present without trailer, no H3 frame is produced.
1414 * Caller is responsible to emit an empty QUIC STREAM frame to signal the end
1415 * of the stream.
1416 *
1417 * Returns the size of HTX blocks removed.
1418 */
1419static int h3_resp_trailers_send(struct qcs *qcs, struct htx *htx)
1420{
1421 struct buffer headers_buf = BUF_NULL;
1422 struct buffer *res;
1423 struct http_hdr list[global.tune.max_http_hdr];
1424 struct htx_blk *blk;
1425 enum htx_blk_type type;
1426 char *tail;
1427 int ret = 0;
1428 int hdr;
1429
1430 TRACE_ENTER(H3_EV_TX_HDR, qcs->qcc->conn, qcs);
1431
1432 hdr = 0;
1433 for (blk = htx_get_head_blk(htx); blk; blk = htx_get_next_blk(htx, blk)) {
1434 type = htx_get_blk_type(blk);
1435
1436 if (type == HTX_BLK_UNUSED)
1437 continue;
1438
1439 if (type == HTX_BLK_EOT)
1440 break;
1441
1442 if (type == HTX_BLK_TLR) {
1443 if (unlikely(hdr >= sizeof(list) / sizeof(list[0]) - 1))
1444 goto err;
1445 list[hdr].n = htx_get_blk_name(htx, blk);
1446 list[hdr].v = htx_get_blk_value(htx, blk);
1447 hdr++;
1448 }
1449 else {
1450 TRACE_ERROR("unexpected HTX block", H3_EV_TX_HDR, qcs->qcc->conn, qcs);
1451 goto err;
1452 }
1453 }
1454
Amaury Denoyelle4be54352023-01-26 17:49:21 +01001455 if (!hdr) {
1456 /* No headers encoded here so no need to generate a H3 HEADERS
1457 * frame. Mux will send an empty QUIC STREAM frame with FIN.
1458 */
1459 TRACE_DATA("skipping trailer", H3_EV_TX_HDR, qcs->qcc->conn, qcs);
1460 goto end;
1461 }
Amaury Denoyelle4e520102023-01-12 14:53:43 +01001462 list[hdr].n = ist("");
1463
1464 res = mux_get_buf(qcs);
1465
1466 /* At least 9 bytes to store frame type + length as a varint max size */
1467 if (b_room(res) < 9) {
1468 qcs->flags |= QC_SF_BLK_MROOM;
1469 goto err;
1470 }
1471
1472 /* Force buffer realignment as size required to encode headers is unknown. */
1473 if (b_space_wraps(res))
1474 b_slow_realign(res, trash.area, b_data(res));
1475 /* Start the headers after frame type + length */
1476 headers_buf = b_make(b_peek(res, b_data(res) + 9), b_contig_space(res) - 9, 0, 0);
1477
Amaury Denoyelle224ba5c2023-01-26 17:41:58 +01001478 if (qpack_encode_field_section_line(&headers_buf)) {
1479 qcs->flags |= QC_SF_BLK_MROOM;
1480 goto err;
1481 }
Amaury Denoyelle4e520102023-01-12 14:53:43 +01001482
1483 tail = b_tail(&headers_buf);
1484 for (hdr = 0; hdr < sizeof(list) / sizeof(list[0]); ++hdr) {
1485 if (isteq(list[hdr].n, ist("")))
1486 break;
1487
1488 /* forbidden HTTP/3 headers, cf h3_resp_headers_send() */
1489 if (isteq(list[hdr].n, ist("host")) ||
1490 isteq(list[hdr].n, ist("content-length")) ||
1491 isteq(list[hdr].n, ist("connection")) ||
1492 isteq(list[hdr].n, ist("proxy-connection")) ||
1493 isteq(list[hdr].n, ist("keep-alive")) ||
1494 isteq(list[hdr].n, ist("te")) ||
1495 isteq(list[hdr].n, ist("transfer-encoding"))) {
1496 continue;
1497 }
1498
Amaury Denoyelle224ba5c2023-01-26 17:41:58 +01001499 if (qpack_encode_header(&headers_buf, list[hdr].n, list[hdr].v)) {
1500 qcs->flags |= QC_SF_BLK_MROOM;
1501 goto err;
1502 }
Amaury Denoyelle4e520102023-01-12 14:53:43 +01001503 }
1504
Amaury Denoyelle4e520102023-01-12 14:53:43 +01001505 /* Check that at least one header was encoded in buffer. */
Amaury Denoyelle4be54352023-01-26 17:49:21 +01001506 if (b_tail(&headers_buf) == tail) {
Amaury Denoyelle4e520102023-01-12 14:53:43 +01001507 /* No headers encoded here so no need to generate a H3 HEADERS
1508 * frame. Mux will send an empty QUIC STREAM frame with FIN.
1509 */
1510 TRACE_DATA("skipping trailer", H3_EV_TX_HDR, qcs->qcc->conn, qcs);
Amaury Denoyelle4be54352023-01-26 17:49:21 +01001511 goto end;
Amaury Denoyelle4e520102023-01-12 14:53:43 +01001512 }
1513
Amaury Denoyelle4be54352023-01-26 17:49:21 +01001514 /* Now that all headers are encoded, we are certain that res buffer is
1515 * big enough.
1516 */
1517 b_putchr(res, 0x01); /* h3 HEADERS frame type */
1518 if (!b_quic_enc_int(res, b_data(&headers_buf), 8))
1519 ABORT_NOW();
1520 b_add(res, b_data(&headers_buf));
1521
1522 end:
Amaury Denoyelle4e520102023-01-12 14:53:43 +01001523 ret = 0;
1524 blk = htx_get_head_blk(htx);
1525 while (blk) {
1526 type = htx_get_blk_type(blk);
1527 ret += htx_get_blksz(blk);
1528 blk = htx_remove_blk(htx, blk);
1529 if (type == HTX_BLK_EOT)
1530 break;
1531 }
1532
1533 TRACE_LEAVE(H3_EV_TX_HDR, qcs->qcc->conn, qcs);
1534 return ret;
1535
1536 err:
1537 TRACE_DEVEL("leaving on error", H3_EV_TX_HDR, qcs->qcc->conn, qcs);
1538 return 0;
1539}
1540
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001541/* Returns the total of bytes sent. */
Amaury Denoyelle9534e592022-09-19 17:14:27 +02001542static int h3_resp_data_send(struct qcs *qcs, struct htx *htx, size_t count)
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001543{
1544 struct buffer outbuf;
1545 struct buffer *res;
1546 size_t total = 0;
Amaury Denoyellea543eb12021-10-06 14:53:13 +02001547 int bsize, fsize, hsize;
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001548 struct htx_blk *blk;
1549 enum htx_blk_type type;
1550
Amaury Denoyellea717eb72022-05-30 15:51:01 +02001551 TRACE_ENTER(H3_EV_TX_DATA, qcs->qcc->conn, qcs);
1552
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001553 new_frame:
1554 if (!count || htx_is_empty(htx))
1555 goto end;
1556
1557 blk = htx_get_head_blk(htx);
1558 type = htx_get_blk_type(blk);
1559 fsize = bsize = htx_get_blksz(blk);
1560
1561 if (type != HTX_BLK_DATA)
1562 goto end;
1563
Amaury Denoyelled3d97c62021-10-05 11:45:58 +02001564 res = mux_get_buf(qcs);
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001565
1566 if (fsize > count)
1567 fsize = count;
1568
Amaury Denoyellea543eb12021-10-06 14:53:13 +02001569 /* h3 DATA headers : 1-byte frame type + varint frame length */
1570 hsize = 1 + QUIC_VARINT_MAX_SIZE;
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001571
Amaury Denoyellea543eb12021-10-06 14:53:13 +02001572 while (1) {
1573 b_reset(&outbuf);
1574 outbuf = b_make(b_tail(res), b_contig_space(res), 0, 0);
1575 if (b_size(&outbuf) > hsize || !b_space_wraps(res))
1576 break;
1577 b_slow_realign(res, trash.area, b_data(res));
1578 }
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001579
Amaury Denoyelle84ea8dc2021-12-03 14:40:01 +01001580 /* Not enough room for headers and at least one data byte, block the
Willy Tarreau4596fe22022-05-17 19:07:51 +02001581 * stream. It is expected that the stream connector layer will subscribe
1582 * on SEND.
Amaury Denoyellea543eb12021-10-06 14:53:13 +02001583 */
Amaury Denoyelle84ea8dc2021-12-03 14:40:01 +01001584 if (b_size(&outbuf) <= hsize) {
1585 qcs->flags |= QC_SF_BLK_MROOM;
1586 goto end;
1587 }
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001588
Amaury Denoyellea543eb12021-10-06 14:53:13 +02001589 if (b_size(&outbuf) < hsize + fsize)
1590 fsize = b_size(&outbuf) - hsize;
1591 BUG_ON(fsize <= 0);
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001592
Amaury Denoyellea543eb12021-10-06 14:53:13 +02001593 b_putchr(&outbuf, 0x00); /* h3 frame type = DATA */
Amaury Denoyelle7d78eff2023-01-17 15:21:16 +01001594 b_quic_enc_int(&outbuf, fsize, 0); /* h3 frame length */
Amaury Denoyellea543eb12021-10-06 14:53:13 +02001595
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001596 b_putblk(&outbuf, htx_get_blk_ptr(htx, blk), fsize);
Amaury Denoyellea543eb12021-10-06 14:53:13 +02001597 total += fsize;
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001598 count -= fsize;
1599
1600 if (fsize == bsize)
1601 htx_remove_blk(htx, blk);
1602 else
1603 htx_cut_data_blk(htx, blk, fsize);
1604
Amaury Denoyellea543eb12021-10-06 14:53:13 +02001605 /* commit the buffer */
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001606 b_add(res, b_data(&outbuf));
1607 goto new_frame;
1608
1609 end:
Amaury Denoyellea717eb72022-05-30 15:51:01 +02001610 TRACE_LEAVE(H3_EV_TX_DATA, qcs->qcc->conn, qcs);
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001611 return total;
1612}
1613
Amaury Denoyelle9534e592022-09-19 17:14:27 +02001614static size_t h3_snd_buf(struct qcs *qcs, struct htx *htx, size_t count)
Amaury Denoyelle26dfd902021-08-24 16:33:53 +02001615{
1616 size_t total = 0;
Amaury Denoyelle26dfd902021-08-24 16:33:53 +02001617 enum htx_blk_type btype;
1618 struct htx_blk *blk;
1619 uint32_t bsize;
1620 int32_t idx;
1621 int ret;
1622
Amaury Denoyelled8769d12022-03-25 15:28:33 +01001623 h3_debug_printf(stderr, "%s\n", __func__);
Amaury Denoyelledeed7772021-12-03 11:36:46 +01001624
Amaury Denoyelle84ea8dc2021-12-03 14:40:01 +01001625 while (count && !htx_is_empty(htx) && !(qcs->flags & QC_SF_BLK_MROOM)) {
Amaury Denoyelle26dfd902021-08-24 16:33:53 +02001626 idx = htx_get_head(htx);
1627 blk = htx_get_blk(htx, idx);
1628 btype = htx_get_blk_type(blk);
1629 bsize = htx_get_blksz(blk);
1630
1631 /* Not implemented : QUIC on backend side */
1632 BUG_ON(btype == HTX_BLK_REQ_SL);
1633
1634 switch (btype) {
1635 case HTX_BLK_RES_SL:
Amaury Denoyelle15b09612021-08-24 16:20:27 +02001636 /* start-line -> HEADERS h3 frame */
1637 ret = h3_resp_headers_send(qcs, htx);
1638 if (ret > 0) {
1639 total += ret;
1640 count -= ret;
1641 if (ret < bsize)
1642 goto out;
1643 }
1644 break;
Amaury Denoyelle26dfd902021-08-24 16:33:53 +02001645
1646 case HTX_BLK_DATA:
Amaury Denoyelle9534e592022-09-19 17:14:27 +02001647 ret = h3_resp_data_send(qcs, htx, count);
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001648 if (ret > 0) {
Amaury Denoyelle8e2a9982021-08-24 16:24:37 +02001649 total += ret;
1650 count -= ret;
1651 if (ret < bsize)
1652 goto out;
1653 }
1654 break;
Amaury Denoyelle26dfd902021-08-24 16:33:53 +02001655
1656 case HTX_BLK_TLR:
1657 case HTX_BLK_EOT:
Amaury Denoyelle4e520102023-01-12 14:53:43 +01001658 ret = h3_resp_trailers_send(qcs, htx);
1659 if (ret > 0) {
1660 total += ret;
1661 count -= ret;
1662 if (ret < bsize)
1663 goto out;
1664 }
1665 break;
Amaury Denoyelle26dfd902021-08-24 16:33:53 +02001666
1667 default:
1668 htx_remove_blk(htx, blk);
1669 total += bsize;
1670 count -= bsize;
1671 break;
1672 }
1673 }
1674
Amaury Denoyelle26dfd902021-08-24 16:33:53 +02001675 out:
1676 return total;
Amaury Denoyellef52151d2021-08-24 16:11:18 +02001677}
1678
Amaury Denoyelle1e340ba2023-01-30 12:12:11 +01001679/* Notify about a closure on <qcs> stream requested by the remote peer.
1680 *
1681 * Stream channel <side> is explained relative to our endpoint : WR for
1682 * STOP_SENDING or RD for RESET_STREAM reception. Callback decode_qcs() is used
1683 * instead for closure performed using a STREAM frame with FIN bit.
1684 *
1685 * The main objective of this function is to check if closure is valid
1686 * according to HTTP/3 specification.
1687 *
1688 * Returns 0 on success else non-zero. A CONNECTION_CLOSE is generated on
1689 * error.
1690 */
1691static int h3_close(struct qcs *qcs, enum qcc_app_ops_close_side side)
1692{
Amaury Denoyelle87f87662023-01-30 12:12:43 +01001693 struct h3s *h3s = qcs->ctx;
1694 struct h3c *h3c = h3s->h3c;;
1695
1696 /* RFC 9114 6.2.1. Control Streams
1697 *
1698 * The sender
1699 * MUST NOT close the control stream, and the receiver MUST NOT
1700 * request that the sender close the control stream. If either
1701 * control stream is closed at any point, this MUST be treated
1702 * as a connection error of type H3_CLOSED_CRITICAL_STREAM.
1703 */
Amaury Denoyellee269aeb2023-01-30 12:13:22 +01001704 if (qcs == h3c->ctrl_strm || h3s->type == H3S_T_CTRL) {
Amaury Denoyellee31867b2023-01-31 16:01:22 +01001705 TRACE_ERROR("closure detected on control stream", H3_EV_H3S_END, qcs->qcc->conn, qcs);
Amaury Denoyelle58721f22023-05-09 18:01:09 +02001706 qcc_set_error(qcs->qcc, H3_CLOSED_CRITICAL_STREAM, 1);
Amaury Denoyelle87f87662023-01-30 12:12:43 +01001707 return 1;
1708 }
1709
Amaury Denoyelle1e340ba2023-01-30 12:12:11 +01001710 return 0;
1711}
1712
Amaury Denoyellec0156792022-06-03 15:29:07 +02001713static int h3_attach(struct qcs *qcs, void *conn_ctx)
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001714{
Amaury Denoyelle3d550842023-01-24 17:42:21 +01001715 struct h3c *h3c = conn_ctx;
1716 struct h3s *h3s = NULL;
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001717
Amaury Denoyelled5581d52022-05-30 15:51:31 +02001718 TRACE_ENTER(H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
1719
Amaury Denoyelle3d550842023-01-24 17:42:21 +01001720 /* RFC 9114 5.2. Connection Shutdown
1721 *
1722 * Upon sending
1723 * a GOAWAY frame, the endpoint SHOULD explicitly cancel (see
1724 * Sections 4.1.1 and 7.2.3) any requests or pushes that have
1725 * identifiers greater than or equal to the one indicated, in
1726 * order to clean up transport state for the affected streams.
1727 * The endpoint SHOULD continue to do so as more requests or
1728 * pushes arrive.
1729 */
1730 if (h3c->flags & H3_CF_GOAWAY_SENT && qcs->id >= h3c->id_goaway &&
1731 quic_stream_is_bidi(qcs->id)) {
1732 /* Reject request and do not allocate a h3s context.
1733 * TODO support push uni-stream rejection.
1734 */
1735 TRACE_STATE("reject stream higher than goaway", H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
1736 qcc_abort_stream_read(qcs);
1737 qcc_reset_stream(qcs, H3_REQUEST_REJECTED);
1738 goto done;
1739 }
1740
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001741 h3s = pool_alloc(pool_head_h3s);
Amaury Denoyelle3d550842023-01-24 17:42:21 +01001742 if (!h3s) {
1743 TRACE_ERROR("h3s allocation failure", H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
Amaury Denoyelle3d550842023-01-24 17:42:21 +01001744 goto err;
1745 }
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001746
1747 qcs->ctx = h3s;
Amaury Denoyellec0156792022-06-03 15:29:07 +02001748 h3s->h3c = conn_ctx;
1749
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +02001750 h3s->demux_frame_len = 0;
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001751 h3s->demux_frame_type = H3_FT_UNINIT;
Amaury Denoyelled2c5ee62022-12-08 16:54:42 +01001752 h3s->body_len = 0;
1753 h3s->data_len = 0;
Amaury Denoyelle35550642022-05-24 15:14:53 +02001754 h3s->flags = 0;
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +01001755 h3s->err = 0;
Amaury Denoyelle48f01bd2022-04-27 15:37:20 +02001756
Amaury Denoyelle3236a8e2022-05-24 15:24:03 +02001757 if (quic_stream_is_bidi(qcs->id)) {
1758 h3s->type = H3S_T_REQ;
Amaury Denoyelle8d818c62022-08-02 11:32:45 +02001759 h3s->st_req = H3S_ST_REQ_BEFORE;
Amaury Denoyelle30e260e2022-08-03 11:17:57 +02001760 qcs_wait_http_req(qcs);
Amaury Denoyelle3236a8e2022-05-24 15:24:03 +02001761 }
1762 else {
1763 /* stream type must be decoded for unidirectional streams */
1764 h3s->type = H3S_T_UNKNOWN;
1765 }
1766
Amaury Denoyelle3d550842023-01-24 17:42:21 +01001767 done:
Amaury Denoyelled5581d52022-05-30 15:51:31 +02001768 TRACE_LEAVE(H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001769 return 0;
Amaury Denoyelle3d550842023-01-24 17:42:21 +01001770
1771 err:
1772 TRACE_DEVEL("leaving in error", H3_EV_H3S_NEW, qcs->qcc->conn, qcs);
1773 return 1;
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001774}
1775
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001776static void h3_detach(struct qcs *qcs)
1777{
1778 struct h3s *h3s = qcs->ctx;
Amaury Denoyelled5581d52022-05-30 15:51:31 +02001779
1780 TRACE_ENTER(H3_EV_H3S_END, qcs->qcc->conn, qcs);
1781
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001782 pool_free(pool_head_h3s, h3s);
1783 qcs->ctx = NULL;
Amaury Denoyelled5581d52022-05-30 15:51:31 +02001784
1785 TRACE_LEAVE(H3_EV_H3S_END, qcs->qcc->conn, qcs);
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001786}
1787
Amaury Denoyelle71fd0362023-01-24 17:35:37 +01001788/* Initialize H3 control stream and prepare SETTINGS emission.
1789 *
1790 * Returns 0 on success else non-zero.
1791 */
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001792static int h3_finalize(void *ctx)
1793{
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +02001794 struct h3c *h3c = ctx;
Amaury Denoyelle9cc47512022-05-24 16:27:41 +02001795 struct qcs *qcs;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001796
Amaury Denoyelleb1437232022-07-08 11:53:22 +02001797 qcs = qcc_init_stream_local(h3c->qcc, 0);
Amaury Denoyelle9cc47512022-05-24 16:27:41 +02001798 if (!qcs)
Amaury Denoyelle71fd0362023-01-24 17:35:37 +01001799 return 1;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001800
Amaury Denoyelle9cc47512022-05-24 16:27:41 +02001801 h3_control_send(qcs, h3c);
Amaury Denoyelled7010392022-07-13 15:17:29 +02001802 h3c->ctrl_strm = qcs;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001803
Amaury Denoyelle71fd0362023-01-24 17:35:37 +01001804 return 0;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001805}
1806
Amaury Denoyelle114c9c82022-03-28 14:53:45 +02001807/* Generate a GOAWAY frame for <h3c> connection on the control stream.
1808 *
1809 * Returns 0 on success else non-zero.
1810 */
1811static int h3_send_goaway(struct h3c *h3c)
1812{
1813 struct qcs *qcs = h3c->ctrl_strm;
1814 struct buffer pos, *res;
1815 unsigned char data[3 * QUIC_VARINT_MAX_SIZE];
1816 size_t frm_len = quic_int_getsize(h3c->id_goaway);
1817
Amaury Denoyelle78adb4b2023-01-31 15:50:16 +01001818 TRACE_ENTER(H3_EV_H3C_END, h3c->qcc->conn);
Amaury Denoyelle56a86dd2023-01-30 15:36:51 +01001819
1820 if (!qcs) {
Amaury Denoyelle78adb4b2023-01-31 15:50:16 +01001821 TRACE_ERROR("control stream not initialized", H3_EV_H3C_END, h3c->qcc->conn);
Amaury Denoyelle56a86dd2023-01-30 15:36:51 +01001822 goto err;
1823 }
Amaury Denoyelle114c9c82022-03-28 14:53:45 +02001824
1825 pos = b_make((char *)data, sizeof(data), 0, 0);
1826
Amaury Denoyelle7d78eff2023-01-17 15:21:16 +01001827 b_quic_enc_int(&pos, H3_FT_GOAWAY, 0);
1828 b_quic_enc_int(&pos, frm_len, 0);
1829 b_quic_enc_int(&pos, h3c->id_goaway, 0);
Amaury Denoyelle114c9c82022-03-28 14:53:45 +02001830
1831 res = mux_get_buf(qcs);
1832 if (!res || b_room(res) < b_data(&pos)) {
1833 /* Do not try forcefully to emit GOAWAY if no space left. */
Amaury Denoyelle78adb4b2023-01-31 15:50:16 +01001834 TRACE_ERROR("cannot send GOAWAY", H3_EV_H3C_END, h3c->qcc->conn, qcs);
Amaury Denoyelle56a86dd2023-01-30 15:36:51 +01001835 goto err;
Amaury Denoyelle114c9c82022-03-28 14:53:45 +02001836 }
1837
1838 b_force_xfer(res, &pos, b_data(&pos));
Amaury Denoyelle19adeb52023-01-25 10:50:03 +01001839 qcc_send_stream(qcs, 1);
Amaury Denoyelle114c9c82022-03-28 14:53:45 +02001840
Amaury Denoyelle3d550842023-01-24 17:42:21 +01001841 h3c->flags |= H3_CF_GOAWAY_SENT;
Amaury Denoyelle78adb4b2023-01-31 15:50:16 +01001842 TRACE_LEAVE(H3_EV_H3C_END, h3c->qcc->conn);
Amaury Denoyelle114c9c82022-03-28 14:53:45 +02001843 return 0;
Amaury Denoyelle56a86dd2023-01-30 15:36:51 +01001844
1845 err:
Amaury Denoyelle3d550842023-01-24 17:42:21 +01001846 /* Consider GOAWAY as sent even if not really the case. This will
1847 * block future stream opening using H3_REQUEST_REJECTED reset.
1848 */
1849 h3c->flags |= H3_CF_GOAWAY_SENT;
Amaury Denoyelle78adb4b2023-01-31 15:50:16 +01001850 TRACE_DEVEL("leaving in error", H3_EV_H3C_END, h3c->qcc->conn);
Amaury Denoyelle56a86dd2023-01-30 15:36:51 +01001851 return 1;
Amaury Denoyelle114c9c82022-03-28 14:53:45 +02001852}
1853
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001854/* Initialize the HTTP/3 context for <qcc> mux.
1855 * Return 1 if succeeded, 0 if not.
1856 */
1857static int h3_init(struct qcc *qcc)
1858{
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +02001859 struct h3c *h3c;
Frédéric Lécaille6f7607e2022-05-25 22:25:37 +02001860 struct quic_conn *qc = qcc->conn->handle.qc;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001861
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +02001862 h3c = pool_alloc(pool_head_h3c);
1863 if (!h3c)
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001864 goto fail_no_h3;
1865
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +02001866 h3c->qcc = qcc;
Amaury Denoyelled7010392022-07-13 15:17:29 +02001867 h3c->ctrl_strm = NULL;
Amaury Denoyelle2fe93ab2022-12-09 15:01:31 +01001868 h3c->err = 0;
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +02001869 h3c->flags = 0;
Amaury Denoyelle114c9c82022-03-28 14:53:45 +02001870 h3c->id_goaway = 0;
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001871
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +02001872 qcc->ctx = h3c;
Amaury Denoyelle5c25dc52022-09-30 17:44:15 +02001873 /* TODO cleanup only ref to quic_conn */
Frédéric Lécaille6f7607e2022-05-25 22:25:37 +02001874 h3c->prx_counters =
1875 EXTRA_COUNTERS_GET(qc->li->bind_conf->frontend->extra_counters_fe,
1876 &h3_stats_module);
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +02001877 LIST_INIT(&h3c->buf_wait.list);
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001878
1879 return 1;
1880
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001881 fail_no_h3:
1882 return 0;
1883}
1884
Amaury Denoyellef8aaf8b2022-09-14 16:23:47 +02001885/* Send a HTTP/3 GOAWAY followed by a CONNECTION_CLOSE_APP. */
1886static void h3_shutdown(void *ctx)
Amaury Denoyelle8347f272022-03-29 14:46:55 +02001887{
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +02001888 struct h3c *h3c = ctx;
Amaury Denoyelle069288b2022-07-15 10:58:25 +02001889
Amaury Denoyelle78adb4b2023-01-31 15:50:16 +01001890 TRACE_ENTER(H3_EV_H3C_END, h3c->qcc->conn);
Amaury Denoyelle56a86dd2023-01-30 15:36:51 +01001891
Amaury Denoyelle069288b2022-07-15 10:58:25 +02001892 /* RFC 9114 5.2. Connection Shutdown
1893 *
Amaury Denoyelle114c9c82022-03-28 14:53:45 +02001894 * Even when a connection is not idle, either endpoint can decide to
1895 * stop using the connection and initiate a graceful connection close.
1896 * Endpoints initiate the graceful shutdown of an HTTP/3 connection by
1897 * sending a GOAWAY frame.
1898 */
1899 h3_send_goaway(h3c);
1900
1901 /* RFC 9114 5.2. Connection Shutdown
1902 *
Amaury Denoyelle069288b2022-07-15 10:58:25 +02001903 * An endpoint that completes a
1904 * graceful shutdown SHOULD use the H3_NO_ERROR error code when closing
1905 * the connection.
1906 */
Amaury Denoyelle51f116d2023-05-04 15:49:02 +02001907 h3c->qcc->err = quic_err_app(H3_NO_ERROR);
Amaury Denoyelle56a86dd2023-01-30 15:36:51 +01001908
Amaury Denoyelle78adb4b2023-01-31 15:50:16 +01001909 TRACE_LEAVE(H3_EV_H3C_END, h3c->qcc->conn);
Amaury Denoyellef8aaf8b2022-09-14 16:23:47 +02001910}
Amaury Denoyelle069288b2022-07-15 10:58:25 +02001911
Amaury Denoyellef8aaf8b2022-09-14 16:23:47 +02001912static void h3_release(void *ctx)
1913{
1914 struct h3c *h3c = ctx;
Amaury Denoyelle8d1ecac2022-05-24 14:55:43 +02001915 pool_free(pool_head_h3c, h3c);
Amaury Denoyelle8347f272022-03-29 14:46:55 +02001916}
1917
Frédéric Lécaille6f7607e2022-05-25 22:25:37 +02001918/* Increment the h3 error code counters for <error_code> value */
1919static void h3_stats_inc_err_cnt(void *ctx, int err_code)
1920{
1921 struct h3c *h3c = ctx;
1922
1923 h3_inc_err_cnt(h3c->prx_counters, err_code);
1924}
1925
Amaury Denoyelle35d90532023-01-26 16:03:45 +01001926static inline const char *h3_ft_str(uint64_t type)
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001927{
1928 switch (type) {
1929 case H3_FT_DATA: return "DATA";
1930 case H3_FT_HEADERS: return "HEADERS";
1931 case H3_FT_SETTINGS: return "SETTINGS";
1932 case H3_FT_PUSH_PROMISE: return "PUSH_PROMISE";
1933 case H3_FT_MAX_PUSH_ID: return "MAX_PUSH_ID";
1934 case H3_FT_CANCEL_PUSH: return "CANCEL_PUSH";
1935 case H3_FT_GOAWAY: return "GOAWAY";
1936 default: return "_UNKNOWN_";
1937 }
1938}
1939
Amaury Denoyelle016aa932022-05-30 15:49:36 +02001940/* h3 trace handler */
1941static void h3_trace(enum trace_level level, uint64_t mask,
1942 const struct trace_source *src,
1943 const struct ist where, const struct ist func,
1944 const void *a1, const void *a2, const void *a3, const void *a4)
1945{
1946 const struct connection *conn = a1;
1947 const struct qcc *qcc = conn ? conn->ctx : NULL;
1948 const struct qcs *qcs = a2;
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001949 const struct h3s *h3s = qcs ? qcs->ctx : NULL;
Amaury Denoyelle016aa932022-05-30 15:49:36 +02001950
Frédéric Lécaille1c725aa2022-09-08 15:49:37 +02001951 if (!qcc)
1952 return;
1953
Amaury Denoyelle016aa932022-05-30 15:49:36 +02001954 if (src->verbosity > H3_VERB_CLEAN) {
1955 chunk_appendf(&trace_buf, " : qcc=%p(F)", qcc);
Frédéric Lécaille2eb5faa2022-09-08 16:03:13 +02001956 if (qcc->conn->handle.qc)
1957 chunk_appendf(&trace_buf, " qc=%p", qcc->conn->handle.qc);
Amaury Denoyelle016aa932022-05-30 15:49:36 +02001958
1959 if (qcs)
Frédéric Lécaille628e89c2022-06-24 12:13:53 +02001960 chunk_appendf(&trace_buf, " qcs=%p(%llu)", qcs, (ull)qcs->id);
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001961
1962 if (h3s && h3s->demux_frame_type != H3_FT_UNINIT) {
Amaury Denoyelle35d90532023-01-26 16:03:45 +01001963 chunk_appendf(&trace_buf, " h3s.dem=%s/%llu",
1964 h3_ft_str(h3s->demux_frame_type), (ull)h3s->demux_frame_len);
Amaury Denoyelle14037bf2023-02-17 15:56:06 +01001965 }
Amaury Denoyelle016aa932022-05-30 15:49:36 +02001966 }
1967}
1968
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001969/* HTTP/3 application layer operations */
1970const struct qcc_app_ops h3_ops = {
1971 .init = h3_init,
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001972 .attach = h3_attach,
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001973 .decode_qcs = h3_decode_qcs,
Amaury Denoyelleabbe91e2021-11-12 16:09:29 +01001974 .snd_buf = h3_snd_buf,
Amaury Denoyelle1e340ba2023-01-30 12:12:11 +01001975 .close = h3_close,
Amaury Denoyelle67e92d32022-04-27 18:04:01 +02001976 .detach = h3_detach,
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001977 .finalize = h3_finalize,
Amaury Denoyellef8aaf8b2022-09-14 16:23:47 +02001978 .shutdown = h3_shutdown,
Frédéric Lécaille6f7607e2022-05-25 22:25:37 +02001979 .inc_err_cnt = h3_stats_inc_err_cnt,
Amaury Denoyellef8aaf8b2022-09-14 16:23:47 +02001980 .release = h3_release,
Frédéric Lécailleccac11f2021-03-03 16:09:02 +01001981};