lsquic_qdec_hdl.c revision a4f5dac3
1/* Copyright (c) 2017 - 2020 LiteSpeed Technologies Inc.  See LICENSE. */
2/*
3 * lsquic_qdec_hdl.c -- QPACK decoder streams handler
4 */
5
6#include <assert.h>
7#include <errno.h>
8#include <inttypes.h>
9#include <stdlib.h>
10#include <string.h>
11#include <sys/queue.h>
12
13#include "lsquic.h"
14#include "lsquic_types.h"
15#include "lsquic_int_types.h"
16#include "lsquic_sfcw.h"
17#include "lsquic_varint.h"
18#include "lsquic_hq.h"
19#include "lsquic_hash.h"
20#include "lsquic_stream.h"
21#include "lsquic_frab_list.h"
22#include "lsqpack.h"
23#include "lsquic_http1x_if.h"
24#include "lsquic_qdec_hdl.h"
25#include "lsquic_mm.h"
26#include "lsquic_engine_public.h"
27#include "lsquic_headers.h"
28#include "lsquic_http1x_if.h"
29#include "lsquic_conn.h"
30
31#define LSQUIC_LOGGER_MODULE LSQLM_QDEC_HDL
32#define LSQUIC_LOG_CONN_ID lsquic_conn_log_cid(qdh->qdh_conn)
33#include "lsquic_logger.h"
34
35static void
36qdh_hblock_unblocked (void *);
37
38
39static int
40qdh_write_decoder (struct qpack_dec_hdl *qdh, const unsigned char *buf,
41                                                                size_t sz)
42{
43    ssize_t nw;
44
45    if (!(qdh->qdh_dec_sm_out && lsquic_frab_list_empty(&qdh->qdh_fral)))
46    {
47  write_to_frab:
48        if (0 == lsquic_frab_list_write(&qdh->qdh_fral,
49                                                (unsigned char *) buf, sz))
50        {
51            LSQ_DEBUG("wrote %zu bytes to frab list", sz);
52            lsquic_stream_wantwrite(qdh->qdh_dec_sm_out, 1);
53            return 0;
54        }
55        else
56        {
57            LSQ_INFO("error writing to frab list");
58            return -1;
59        }
60    }
61
62    nw = lsquic_stream_write(qdh->qdh_dec_sm_out, buf, sz);
63    if (nw < 0)
64    {
65        LSQ_INFO("error writing to outgoing QPACK decoder stream: %s",
66                                                        strerror(errno));
67        return -1;
68    }
69    LSQ_DEBUG("wrote %zd bytes to outgoing QPACK decoder stream", nw);
70
71    if ((size_t) nw == sz)
72        return 0;
73
74    buf = buf + nw;
75    sz -= (size_t) nw;
76    goto write_to_frab;
77}
78
79
80static int
81qdh_write_type (struct qpack_dec_hdl *qdh)
82{
83    int s;
84
85#ifndef NDEBUG
86    const char *env = getenv("LSQUIC_RND_VARINT_LEN");
87    if (env && atoi(env))
88    {
89        s = rand() & 3;
90        LSQ_DEBUG("writing %d-byte stream type", 1 << s);
91    }
92    else
93#endif
94        s = 0;
95
96    switch (s)
97    {
98    case 0:
99        return qdh_write_decoder(qdh,
100                                (unsigned char []) { HQUST_QPACK_DEC }, 1);
101    case 1:
102        return qdh_write_decoder(qdh,
103                            (unsigned char []) { 0x40, HQUST_QPACK_DEC }, 2);
104    case 2:
105        return qdh_write_decoder(qdh,
106                (unsigned char []) { 0x80, 0x00, 0x00, HQUST_QPACK_DEC }, 4);
107    default:
108        return qdh_write_decoder(qdh,
109                (unsigned char []) { 0xC0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
110                                                        HQUST_QPACK_DEC }, 8);
111    }
112}
113
114
115static void
116qdh_begin_out (struct qpack_dec_hdl *qdh)
117{
118    if (0 != qdh_write_type(qdh))
119    {
120        LSQ_WARN("%s: could not write to decoder", __func__);
121        qdh->qdh_conn->cn_if->ci_internal_error(qdh->qdh_conn,
122                                        "cannot write to decoder stream");
123    }
124}
125
126
127int
128lsquic_qdh_init (struct qpack_dec_hdl *qdh, struct lsquic_conn *conn,
129                    int is_server, const struct lsquic_engine_public *enpub,
130                    unsigned dyn_table_size, unsigned max_risked_streams)
131{
132    qdh->qdh_conn = conn;
133    lsquic_frab_list_init(&qdh->qdh_fral, 0x400, NULL, NULL, NULL);
134    lsqpack_dec_init(&qdh->qdh_decoder, (void *) conn, dyn_table_size,
135                        max_risked_streams, qdh_hblock_unblocked);
136    qdh->qdh_flags |= QDH_INITIALIZED;
137    qdh->qdh_enpub = enpub;
138    if (qdh->qdh_enpub->enp_hsi_if == lsquic_http1x_if)
139    {
140        qdh->qdh_h1x_ctor_ctx = (struct http1x_ctor_ctx) {
141            .conn           = conn,
142            .max_headers_sz = MAX_HTTP1X_HEADERS_SIZE,
143            .is_server      = is_server,
144        };
145        qdh->qdh_hsi_ctx = &qdh->qdh_h1x_ctor_ctx;
146    }
147    else
148        qdh->qdh_hsi_ctx = qdh->qdh_enpub->enp_hsi_ctx;
149    if (qdh->qdh_dec_sm_out)
150        qdh_begin_out(qdh);
151    if (qdh->qdh_enc_sm_in)
152        lsquic_stream_wantread(qdh->qdh_enc_sm_in, 1);
153    LSQ_DEBUG("initialized");
154    return 0;
155}
156
157
158void
159lsquic_qdh_cleanup (struct qpack_dec_hdl *qdh)
160{
161    if (qdh->qdh_flags & QDH_INITIALIZED)
162    {
163        LSQ_DEBUG("cleanup");
164        lsqpack_dec_cleanup(&qdh->qdh_decoder);
165        lsquic_frab_list_cleanup(&qdh->qdh_fral);
166        qdh->qdh_flags &= ~QDH_INITIALIZED;
167    }
168}
169
170static lsquic_stream_ctx_t *
171qdh_out_on_new (void *stream_if_ctx, struct lsquic_stream *stream)
172{
173    struct qpack_dec_hdl *const qdh = stream_if_ctx;
174    qdh->qdh_dec_sm_out = stream;
175    if (qdh->qdh_flags & QDH_INITIALIZED)
176        qdh_begin_out(qdh);
177    LSQ_DEBUG("initialized outgoing decoder stream");
178    return (void *) qdh;
179}
180
181
182static void
183qdh_out_on_write (struct lsquic_stream *stream, lsquic_stream_ctx_t *ctx)
184{
185    struct qpack_dec_hdl *const qdh = (void *) ctx;
186    struct lsquic_reader reader;
187    ssize_t nw;
188    unsigned char buf[LSQPACK_LONGEST_ICI];
189
190    if (lsqpack_dec_ici_pending(&qdh->qdh_decoder))
191    {
192        nw = lsqpack_dec_write_ici(&qdh->qdh_decoder, buf, sizeof(buf));
193        if (nw > 0)
194        {
195            if (0 == qdh_write_decoder(qdh, buf, nw))
196                LSQ_DEBUG("wrote %zd-byte TSS instruction", nw);
197            else
198                goto err;
199        }
200        else if (nw < 0)
201        {
202            LSQ_WARN("could not generate TSS instruction");
203            goto err;
204        }
205    }
206
207    if (lsquic_frab_list_empty(&qdh->qdh_fral))
208    {
209        LSQ_DEBUG("%s: nothing to write", __func__);
210        lsquic_stream_wantwrite(stream, 0);
211        return;
212    }
213
214    reader = (struct lsquic_reader) {
215        .lsqr_read  = lsquic_frab_list_read,
216        .lsqr_size  = lsquic_frab_list_size,
217        .lsqr_ctx   = &qdh->qdh_fral,
218    };
219
220    nw = lsquic_stream_writef(stream, &reader);
221    if (nw >= 0)
222    {
223        LSQ_DEBUG("wrote %zd bytes to stream", nw);
224        (void) lsquic_stream_flush(stream);
225        if (lsquic_frab_list_empty(&qdh->qdh_fral))
226        {
227            lsquic_stream_wantwrite(stream, 0);
228            if (qdh->qdh_on_dec_sent_func)
229            {
230                LSQ_DEBUG("buffered data written: call callback");
231                qdh->qdh_on_dec_sent_func(qdh->qdh_on_dec_sent_ctx);
232                qdh->qdh_on_dec_sent_func = NULL;
233                qdh->qdh_on_dec_sent_ctx = NULL;
234            }
235        }
236    }
237    else
238    {
239        LSQ_WARN("cannot write to stream: %s", strerror(errno));
240  err:
241        lsquic_stream_wantwrite(stream, 0);
242        qdh->qdh_conn->cn_if->ci_internal_error(qdh->qdh_conn,
243                                        "cannot write to stream");
244    }
245}
246
247
248static void
249qdh_out_on_close (struct lsquic_stream *stream, lsquic_stream_ctx_t *ctx)
250{
251    struct qpack_dec_hdl *const qdh = (void *) ctx;
252    qdh->qdh_dec_sm_out = NULL;
253    LSQ_DEBUG("closed outgoing decoder stream");
254}
255
256
257static void
258qdh_out_on_read (struct lsquic_stream *stream, lsquic_stream_ctx_t *ctx)
259{
260    assert(0);
261}
262
263
264static const struct lsquic_stream_if qdh_dec_sm_out_if =
265{
266    .on_new_stream  = qdh_out_on_new,
267    .on_read        = qdh_out_on_read,
268    .on_write       = qdh_out_on_write,
269    .on_close       = qdh_out_on_close,
270};
271const struct lsquic_stream_if *const lsquic_qdh_dec_sm_out_if =
272                                                    &qdh_dec_sm_out_if;
273
274
275static lsquic_stream_ctx_t *
276qdh_in_on_new (void *stream_if_ctx, struct lsquic_stream *stream)
277{
278    struct qpack_dec_hdl *const qdh = stream_if_ctx;
279    qdh->qdh_enc_sm_in = stream;
280    if (qdh->qdh_flags & QDH_INITIALIZED)
281        lsquic_stream_wantread(qdh->qdh_enc_sm_in, 1);
282    LSQ_DEBUG("initialized incoming encoder stream");
283    return (void *) qdh;
284}
285
286
287static size_t
288qdh_read_encoder_stream (void *ctx, const unsigned char *buf, size_t sz,
289                                                                    int fin)
290{
291    struct qpack_dec_hdl *const qdh = (void *) ctx;
292    const struct lsqpack_dec_err *qerr;
293    int s;
294
295    if (fin)
296    {
297        LSQ_INFO("encoder stream is closed");
298        qdh->qdh_conn->cn_if->ci_abort_error(qdh->qdh_conn, 1,
299            HEC_CLOSED_CRITICAL_STREAM, "Peer closed QPACK encoder stream");
300        goto end;
301    }
302
303    s = lsqpack_dec_enc_in(&qdh->qdh_decoder, buf, sz);
304    if (s != 0)
305    {
306        LSQ_INFO("error reading encoder stream");
307        qerr = lsqpack_dec_get_err_info(&qdh->qdh_decoder);
308        qdh->qdh_conn->cn_if->ci_abort_error(qdh->qdh_conn, 1,
309            HEC_QPACK_DECODER_STREAM_ERROR, "Error interpreting QPACK encoder "
310            "stream; offset %"PRIu64", line %d", qerr->off, qerr->line);
311        goto end;
312    }
313    if (qdh->qdh_dec_sm_out
314                    && lsqpack_dec_ici_pending(&qdh->qdh_decoder))
315        lsquic_stream_wantwrite(qdh->qdh_dec_sm_out, 1);
316
317    LSQ_DEBUG("successfully fed %zu bytes to QPACK decoder", sz);
318
319  end:
320    return sz;
321}
322
323
324static void
325qdh_in_on_read (struct lsquic_stream *stream, lsquic_stream_ctx_t *ctx)
326{
327    struct qpack_dec_hdl *const qdh = (void *) ctx;
328    ssize_t nread;
329
330    nread = lsquic_stream_readf(stream, qdh_read_encoder_stream, qdh);
331    if (nread <= 0)
332    {
333        if (nread < 0)
334        {
335            LSQ_WARN("cannot read from encoder stream: %s", strerror(errno));
336            qdh->qdh_conn->cn_if->ci_internal_error(qdh->qdh_conn,
337                                        "cannot read from encoder stream");
338        }
339        else
340        {
341            LSQ_INFO("encoder stream closed by peer: abort connection");
342            qdh->qdh_conn->cn_if->ci_abort_error(qdh->qdh_conn, 1,
343                HEC_CLOSED_CRITICAL_STREAM, "encoder stream closed");
344        }
345        lsquic_stream_wantread(stream, 0);
346    }
347}
348
349
350static void
351qdh_in_on_close (struct lsquic_stream *stream, lsquic_stream_ctx_t *ctx)
352{
353    struct qpack_dec_hdl *const qdh = (void *) ctx;
354    LSQ_DEBUG("closed incoming encoder stream");
355    qdh->qdh_enc_sm_in = NULL;
356}
357
358
359static void
360qdh_in_on_write (struct lsquic_stream *stream, lsquic_stream_ctx_t *ctx)
361{
362    assert(0);
363}
364
365
366static const struct lsquic_stream_if qdh_enc_sm_in_if =
367{
368    .on_new_stream  = qdh_in_on_new,
369    .on_read        = qdh_in_on_read,
370    .on_write       = qdh_in_on_write,
371    .on_close       = qdh_in_on_close,
372};
373const struct lsquic_stream_if *const lsquic_qdh_enc_sm_in_if =
374                                                    &qdh_enc_sm_in_if;
375
376
377static void
378qdh_hblock_unblocked (void *stream_p)
379{
380    struct lsquic_stream *const stream = stream_p;
381    struct qpack_dec_hdl *const qdh = lsquic_stream_get_qdh(stream);
382
383    LSQ_DEBUG("header block for stream %"PRIu64" unblocked", stream->id);
384    lsquic_stream_qdec_unblocked(stream);
385}
386
387
388struct cont_len
389{
390    unsigned long long      value;
391    int                     has;    /* 1: set, 0: not set, -1: invalid */
392};
393
394
395static void
396process_content_length (const struct qpack_dec_hdl *qdh /* for logging */,
397            struct cont_len *cl, const char *val /* not NUL-terminated */,
398                                                                unsigned len)
399{
400    char *endcl, cont_len_buf[30];
401
402    if (0 == cl->has)
403    {
404        if (len >= sizeof(cont_len_buf))
405        {
406            LSQ_DEBUG("content-length has invalid value `%.*s'",
407                                                            (int) len, val);
408            cl->has = -1;
409            return;
410        }
411        memcpy(cont_len_buf, val, len);
412        cont_len_buf[len] = '\0';
413        cl->value = strtoull(cont_len_buf, &endcl, 10);
414        if (*endcl == '\0' && !(ULLONG_MAX == cl->value && ERANGE == errno))
415        {
416            cl->has = 1;
417            LSQ_DEBUG("content length is %llu", cl->value);
418        }
419        else
420        {
421            cl->has = -1;
422            LSQ_DEBUG("content-length has invalid value `%.*s'",
423                (int) len, val);
424        }
425    }
426    else if (cl->has > 0)
427    {
428        LSQ_DEBUG("header set has two content-length: ambiguous, "
429            "turn off checking");
430        cl->has = -1;
431    }
432}
433
434
435static int
436is_content_length (const struct lsqpack_header *header)
437{
438    return ((header->qh_flags & QH_ID_SET) && header->qh_static_id == 4)
439        || (header->qh_name_len == 14 && header->qh_name[0] == 'c'
440                    && 0 == memcmp(header->qh_name + 1, "ontent-length", 13))
441        ;
442}
443
444
445static int
446qdh_supply_hset_to_stream (struct qpack_dec_hdl *qdh,
447            struct lsquic_stream *stream, struct lsqpack_header_list *qlist)
448{
449    const struct lsquic_hset_if *const hset_if = qdh->qdh_enpub->enp_hsi_if;
450    const unsigned hpack_static_table_size = 61;
451    struct uncompressed_headers *uh = NULL;
452    const struct lsqpack_header *header;
453    enum lsquic_header_status st;
454    int push_promise;
455    unsigned i;
456    void *hset;
457    struct cont_len cl;
458
459    push_promise = lsquic_stream_header_is_pp(stream);
460    hset = hset_if->hsi_create_header_set(qdh->qdh_hsi_ctx, push_promise);
461    if (!hset)
462    {
463        LSQ_INFO("call to hsi_create_header_set failed");
464        return -1;
465    }
466
467    LSQ_DEBUG("got header set for stream %"PRIu64, stream->id);
468
469    cl.has = 0;
470    for (i = 0; i < qlist->qhl_count; ++i)
471    {
472        header = qlist->qhl_headers[i];
473        LSQ_DEBUG("%.*s: %.*s", header->qh_name_len, header->qh_name,
474                                        header->qh_value_len, header->qh_value);
475        st = hset_if->hsi_process_header(hset,
476                    header->qh_flags & QH_ID_SET ?
477                        hpack_static_table_size + 1 + header->qh_static_id : 0,
478                    header->qh_name, header->qh_name_len,
479                    header->qh_value, header->qh_value_len);
480        if (st != LSQUIC_HDR_OK)
481        {
482            LSQ_INFO("header process returned non-OK code %u", (unsigned) st);
483            goto err;
484        }
485        if (is_content_length(header))
486            process_content_length(qdh, &cl, header->qh_value,
487                                                        header->qh_value_len);
488    }
489
490    lsqpack_dec_destroy_header_list(qlist);
491    qlist = NULL;
492    st = hset_if->hsi_process_header(hset, 0, 0, 0, 0, 0);
493    if (st != LSQUIC_HDR_OK)
494        goto err;
495
496    uh = calloc(1, sizeof(*uh));
497    if (!uh)
498        goto err;
499    uh->uh_stream_id = stream->id;
500    uh->uh_oth_stream_id = 0;
501    uh->uh_weight = 0;
502    uh->uh_exclusive = -1;
503    if (hset_if == lsquic_http1x_if)
504        uh->uh_flags    |= UH_H1H;
505    uh->uh_hset = hset;
506    if (0 != lsquic_stream_uh_in(stream, uh))
507        goto err;
508    LSQ_DEBUG("converted qlist to hset and gave it to stream %"PRIu64,
509                                                                stream->id);
510    if (cl.has > 0)
511        (void) lsquic_stream_verify_len(stream, cl.value);
512    return 0;
513
514  err:
515    if (qlist)
516        lsqpack_dec_destroy_header_list(qlist);
517    hset_if->hsi_discard_header_set(hset);
518    free(uh);
519    return -1;
520}
521
522
523static int
524qdh_process_qlist (struct qpack_dec_hdl *qdh,
525            struct lsquic_stream *stream, struct lsqpack_header_list *qlist)
526{
527    if (!lsquic_stream_header_is_trailer(stream))
528        return qdh_supply_hset_to_stream(qdh, stream, qlist);
529    else
530    {
531        LSQ_DEBUG("discard trailer header set");
532        lsqpack_dec_destroy_header_list(qlist);
533        return 0;
534    }
535}
536
537
538static enum lsqpack_read_header_status
539qdh_header_read_results (struct qpack_dec_hdl *qdh,
540        struct lsquic_stream *stream, enum lsqpack_read_header_status rhs,
541        struct lsqpack_header_list *qlist, const unsigned char *dec_buf,
542        size_t dec_buf_sz)
543{
544    const struct lsqpack_dec_err *qerr;
545
546    if (rhs == LQRHS_DONE)
547    {
548        if (qlist)
549        {
550            if (0 != qdh_process_qlist(qdh, stream, qlist))
551                return LQRHS_ERROR;
552            if (qdh->qdh_dec_sm_out)
553            {
554                if (dec_buf_sz
555                    && 0 != qdh_write_decoder(qdh, dec_buf, dec_buf_sz))
556                {
557                    return LQRHS_ERROR;
558                }
559                if (dec_buf_sz || lsqpack_dec_ici_pending(&qdh->qdh_decoder))
560                    lsquic_stream_wantwrite(qdh->qdh_dec_sm_out, 1);
561            }
562        }
563        else
564        {
565            assert(0);  /* XXX TODO What do we do here? */
566            return LQRHS_ERROR;
567        }
568    }
569    else if (rhs == LQRHS_ERROR)
570    {
571        qerr = lsqpack_dec_get_err_info(&qdh->qdh_decoder);
572        qdh->qdh_conn->cn_if->ci_abort_error(qdh->qdh_conn, 1,
573            HEC_QPACK_DECOMPRESSION_FAILED, "QPACK decompression error; "
574            "stream %"PRIu64", offset %"PRIu64", line %d", qerr->stream_id,
575            qerr->off, qerr->line);
576    }
577
578    return rhs;
579}
580
581
582enum lsqpack_read_header_status
583lsquic_qdh_header_in_begin (struct qpack_dec_hdl *qdh,
584                        struct lsquic_stream *stream, uint64_t header_size,
585                        const unsigned char **buf, size_t bufsz)
586{
587    enum lsqpack_read_header_status rhs;
588    struct lsqpack_header_list *qlist;
589    size_t dec_buf_sz;
590    unsigned char dec_buf[LSQPACK_LONGEST_HEADER_ACK];
591
592    if (qdh->qdh_flags & QDH_INITIALIZED)
593    {
594        dec_buf_sz = sizeof(dec_buf);
595        rhs = lsqpack_dec_header_in(&qdh->qdh_decoder, stream, stream->id,
596                        header_size, buf, bufsz, &qlist, dec_buf, &dec_buf_sz);
597        return qdh_header_read_results(qdh, stream, rhs, qlist, dec_buf,
598                                                                dec_buf_sz);
599    }
600    else
601    {
602        LSQ_WARN("not initialized: cannot process header block");
603        return LQRHS_ERROR;
604    }
605
606}
607
608
609enum lsqpack_read_header_status
610lsquic_qdh_header_in_continue (struct qpack_dec_hdl *qdh,
611        struct lsquic_stream *stream, const unsigned char **buf, size_t bufsz)
612{
613    enum lsqpack_read_header_status rhs;
614    struct lsqpack_header_list *qlist;
615    size_t dec_buf_sz;
616    unsigned char dec_buf[LSQPACK_LONGEST_HEADER_ACK];
617
618    if (qdh->qdh_flags & QDH_INITIALIZED)
619    {
620        dec_buf_sz = sizeof(dec_buf);
621        rhs = lsqpack_dec_header_read(&qdh->qdh_decoder, stream,
622                                    buf, bufsz, &qlist, dec_buf, &dec_buf_sz);
623        return qdh_header_read_results(qdh, stream, rhs, qlist, dec_buf,
624                                                                dec_buf_sz);
625    }
626    else
627    {
628        LSQ_WARN("not initialized: cannot process header block");
629        return LQRHS_ERROR;
630    }
631}
632
633
634void
635lsquic_qdh_unref_stream (struct qpack_dec_hdl *qdh,
636                                                struct lsquic_stream *stream)
637{
638    if (0 == lsqpack_dec_unref_stream(&qdh->qdh_decoder, stream))
639        LSQ_DEBUG("unreffed stream %"PRIu64, stream->id);
640    else
641        LSQ_WARN("cannot unref stream %"PRIu64, stream->id);
642}
643
644
645void
646lsquic_qdh_cancel_stream (struct qpack_dec_hdl *qdh,
647                                                struct lsquic_stream *stream)
648{
649    ssize_t nw;
650    unsigned char buf[LSQPACK_LONGEST_CANCEL];
651
652    nw = lsqpack_dec_cancel_stream(&qdh->qdh_decoder, stream, buf, sizeof(buf));
653    if (nw > 0)
654    {
655        if (0 == qdh_write_decoder(qdh, buf, nw))
656            LSQ_DEBUG("cancelled stream %"PRIu64" and wrote %zd-byte Cancel "
657                "Stream instruction to the decoder stream", stream->id, nw);
658    }
659    else if (nw == 0)
660        LSQ_WARN("cannot cancel stream %"PRIu64" -- not found", stream->id);
661    else
662    {
663        LSQ_WARN("cannot cancel stream %"PRIu64" -- not enough buffer space "
664            "to encode Cancel Stream instructin", stream->id);
665        lsquic_qdh_unref_stream(qdh, stream);
666    }
667}
668
669
670int
671lsquic_qdh_arm_if_unsent (struct qpack_dec_hdl *qdh, void (*func)(void *),
672                                                                    void *ctx)
673{
674    size_t bytes;
675
676    /* Use size of a single frab list buffer as an arbitrary threshold */
677    bytes = lsquic_frab_list_size(&qdh->qdh_fral);
678    if (bytes <= qdh->qdh_fral.fl_buf_size)
679        return 0;
680    else
681    {
682        LSQ_DEBUG("have %zu bytes of unsent QPACK decoder stream data: set "
683            "up callback", bytes);
684        qdh->qdh_on_dec_sent_func = func;
685        qdh->qdh_on_dec_sent_ctx  = ctx;
686        return 1;
687    }
688}
689