Coverage Report

Created: 2026-10-15 06:20

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/curl/lib/dynhds.c
Line
Count
Source
1
/***************************************************************************
2
 *                                  _   _ ____  _
3
 *  Project                     ___| | | |  _ \| |
4
 *                             / __| | | | |_) | |
5
 *                            | (__| |_| |  _ <| |___
6
 *                             \___|\___/|_| \_\_____|
7
 *
8
 * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
9
 *
10
 * This software is licensed as described in the file COPYING, which
11
 * you should have received as part of this distribution. The terms
12
 * are also available at https://curl.se/docs/copyright.html.
13
 *
14
 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15
 * copies of the Software, and permit persons to whom the Software is
16
 * furnished to do so, under the terms of the COPYING file.
17
 *
18
 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19
 * KIND, either express or implied.
20
 *
21
 * SPDX-License-Identifier: curl
22
 *
23
 ***************************************************************************/
24
#include "curl_setup.h"
25
26
#include "dynhds.h"
27
#include "strcase.h"
28
29
static struct dynhds_entry *entry_new(const char *name, size_t namelen,
30
                                      const char *value, size_t valuelen,
31
                                      int opts)
32
161k
{
33
161k
  struct dynhds_entry *e;
34
161k
  char *p;
35
36
  /* namelen + valuelen <= SIZE_MAX has already been checked by caller */
37
161k
  if((SIZE_MAX - namelen - valuelen) < (sizeof(*e) + 2))
38
0
    return NULL;
39
161k
  e = curlx_calloc(1, sizeof(*e) + namelen + valuelen + 2);
40
161k
  if(!e)
41
0
    return NULL;
42
161k
  e->name = p = (char *)e + sizeof(*e);
43
161k
  memcpy(p, name, namelen);
44
161k
  e->namelen = namelen;
45
161k
  e->value = p += namelen + 1; /* leave a \0 at the end of name */
46
161k
  if(valuelen) {
47
149k
    memcpy(p, value, valuelen);
48
149k
    e->valuelen = valuelen;
49
149k
  }
50
161k
  if(opts & DYNHDS_OPT_LOWERCASE)
51
84.8k
    Curl_strntolower(e->name, e->name, e->namelen);
52
161k
  return e;
53
161k
}
54
55
static void entry_free(struct dynhds_entry *e)
56
161k
{
57
161k
  curlx_free(e);
58
161k
}
59
60
void Curl_dynhds_init(struct dynhds *dynhds, size_t max_entries,
61
                      size_t max_strs_size)
62
22.9k
{
63
22.9k
  DEBUGASSERT(dynhds);
64
22.9k
  DEBUGASSERT(max_strs_size);
65
22.9k
  dynhds->hds = NULL;
66
22.9k
  dynhds->hds_len = dynhds->hds_allc = dynhds->strs_len = 0;
67
22.9k
  dynhds->max_entries = max_entries;
68
22.9k
  dynhds->max_strs_size = max_strs_size;
69
22.9k
  dynhds->opts = 0;
70
22.9k
}
71
72
void Curl_dynhds_free(struct dynhds *dynhds)
73
22.9k
{
74
22.9k
  DEBUGASSERT(dynhds);
75
22.9k
  if(dynhds->hds && dynhds->hds_len) {
76
11.3k
    size_t i;
77
11.3k
    DEBUGASSERT(dynhds->hds);
78
173k
    for(i = 0; i < dynhds->hds_len; ++i) {
79
161k
      entry_free(dynhds->hds[i]);
80
161k
    }
81
11.3k
  }
82
22.9k
  curlx_safefree(dynhds->hds);
83
22.9k
  dynhds->hds_len = dynhds->hds_allc = dynhds->strs_len = 0;
84
22.9k
}
85
86
void Curl_dynhds_reset(struct dynhds *dynhds)
87
5.24k
{
88
5.24k
  DEBUGASSERT(dynhds);
89
5.24k
  if(dynhds->hds_len) {
90
0
    size_t i;
91
0
    DEBUGASSERT(dynhds->hds);
92
0
    for(i = 0; i < dynhds->hds_len; ++i) {
93
0
      entry_free(dynhds->hds[i]);
94
0
      dynhds->hds[i] = NULL;
95
0
    }
96
0
  }
97
5.24k
  dynhds->hds_len = dynhds->strs_len = 0;
98
5.24k
}
99
100
size_t Curl_dynhds_count(struct dynhds *dynhds)
101
76.6k
{
102
76.6k
  return dynhds->hds_len;
103
76.6k
}
104
105
void Curl_dynhds_set_opts(struct dynhds *dynhds, int opts)
106
5.24k
{
107
5.24k
  dynhds->opts = opts;
108
5.24k
}
109
110
struct dynhds_entry *Curl_dynhds_getn(struct dynhds *dynhds, size_t n)
111
71.2k
{
112
71.2k
  DEBUGASSERT(dynhds);
113
71.2k
  return (n < dynhds->hds_len) ? dynhds->hds[n] : NULL;
114
71.2k
}
115
116
struct dynhds_entry *Curl_dynhds_get(struct dynhds *dynhds, const char *name,
117
                                     size_t namelen)
118
5.18k
{
119
5.18k
  size_t i;
120
7.40k
  for(i = 0; i < dynhds->hds_len; ++i) {
121
7.33k
    if(dynhds->hds[i]->namelen == namelen &&
122
5.53k
       curl_strnequal(dynhds->hds[i]->name, name, namelen)) {
123
5.10k
      return dynhds->hds[i];
124
5.10k
    }
125
7.33k
  }
126
73
  return NULL;
127
5.18k
}
128
129
struct dynhds_entry *Curl_dynhds_cget(struct dynhds *dynhds, const char *name)
130
0
{
131
0
  return Curl_dynhds_get(dynhds, name, strlen(name));
132
0
}
133
134
CURLcode Curl_dynhds_add(struct dynhds *dynhds,
135
                         const char *name, size_t namelen,
136
                         const char *value, size_t valuelen)
137
161k
{
138
161k
  struct dynhds_entry *entry = NULL;
139
161k
  CURLcode result = CURLE_OUT_OF_MEMORY;
140
141
  /* Accept NULL value with length 0, name must have length */
142
161k
  if(!dynhds || !name || !namelen || (!value && valuelen)) {
143
0
    DEBUGASSERT(0);
144
0
    return CURLE_BAD_FUNCTION_ARGUMENT;
145
0
  }
146
  /* Does the new header fit into the limits? */
147
161k
  if((dynhds->max_entries && (dynhds->hds_len >= dynhds->max_entries)) ||
148
161k
     (dynhds->max_strs_size - dynhds->strs_len < namelen) ||
149
161k
     (dynhds->max_strs_size - dynhds->strs_len - namelen < valuelen))
150
0
    return CURLE_OUT_OF_MEMORY;
151
152
161k
  entry = entry_new(name, namelen, value, valuelen, dynhds->opts);
153
161k
  if(!entry)
154
0
    goto out;
155
156
161k
  if(dynhds->hds_len + 1 >= dynhds->hds_allc) {
157
15.0k
    size_t nallc = dynhds->hds_allc ? dynhds->hds_allc * 2 : 16;
158
15.0k
    struct dynhds_entry **nhds;
159
160
15.0k
    if(dynhds->max_entries && nallc > dynhds->max_entries)
161
0
      nallc = dynhds->max_entries;
162
163
15.0k
    nhds = curlx_calloc(nallc, sizeof(struct dynhds_entry *));
164
15.0k
    if(!nhds)
165
0
      goto out;
166
15.0k
    if(dynhds->hds) {
167
3.66k
      memcpy(nhds, dynhds->hds,
168
3.66k
             dynhds->hds_len * sizeof(struct dynhds_entry *));
169
3.66k
      curlx_safefree(dynhds->hds);
170
3.66k
    }
171
15.0k
    dynhds->hds = nhds;
172
15.0k
    dynhds->hds_allc = nallc;
173
15.0k
  }
174
161k
  dynhds->hds[dynhds->hds_len++] = entry;
175
161k
  entry = NULL;
176
161k
  dynhds->strs_len += namelen + valuelen;
177
161k
  result = CURLE_OK;
178
179
161k
out:
180
161k
  if(entry)
181
0
    entry_free(entry);
182
161k
  return result;
183
161k
}
184
185
CURLcode Curl_dynhds_cadd(struct dynhds *dynhds,
186
                          const char *name, const char *value)
187
1.80k
{
188
1.80k
  if(!name)
189
0
    return CURLE_BAD_FUNCTION_ARGUMENT;
190
1.80k
  return Curl_dynhds_add(dynhds, name, strlen(name),
191
1.80k
                         value, value ? strlen(value) : 0);
192
1.80k
}
193
194
CURLcode Curl_dynhds_h1_add_line(struct dynhds *dynhds,
195
                                 const char *line, size_t line_len)
196
71.3k
{
197
71.3k
  const char *p;
198
71.3k
  const char *name;
199
71.3k
  size_t namelen;
200
71.3k
  const char *value;
201
71.3k
  size_t valuelen, i;
202
203
71.3k
  if(!line || !line_len)
204
0
    return CURLE_OK;
205
206
71.3k
  p = memchr(line, ':', line_len);
207
71.3k
  if(!p || p == line)
208
17
    return CURLE_BAD_FUNCTION_ARGUMENT;
209
71.3k
  name = line;
210
71.3k
  namelen = p - line;
211
71.3k
  p++; /* move past the colon */
212
98.0k
  for(i = namelen + 1; i < line_len; ++i, ++p) {
213
92.2k
    if(!ISBLANK(*p))
214
65.5k
      break;
215
92.2k
  }
216
71.3k
  value = p;
217
71.3k
  valuelen = line_len - i;
218
219
71.3k
  p = memchr(value, '\r', valuelen);
220
71.3k
  if(!p)
221
70.1k
    p = memchr(value, '\n', valuelen);
222
71.3k
  if(p)
223
1.21k
    valuelen = (size_t)(p - value);
224
225
71.3k
  return Curl_dynhds_add(dynhds, name, namelen, value, valuelen);
226
71.3k
}
227
228
CURLcode Curl_dynhds_h1_cadd_line(struct dynhds *dynhds, const char *line)
229
112
{
230
112
  return Curl_dynhds_h1_add_line(dynhds, line, line ? strlen(line) : 0);
231
112
}
232
233
#ifdef UNITTESTS
234
/* @unittest 2602 */
235
236
/**
237
 * Return TRUE iff one or more headers with the given name exist.
238
 */
239
UNITTEST bool dynhds_contains(struct dynhds *dynhds,
240
                              const char *name, size_t namelen);
241
UNITTEST bool dynhds_contains(struct dynhds *dynhds,
242
                              const char *name, size_t namelen)
243
0
{
244
0
  return !!Curl_dynhds_get(dynhds, name, namelen);
245
0
}
246
247
/* @unittest 2602 */
248
UNITTEST bool dynhds_ccontains(struct dynhds *dynhds, const char *name);
249
UNITTEST bool dynhds_ccontains(struct dynhds *dynhds, const char *name)
250
0
{
251
0
  return dynhds_contains(dynhds, name, strlen(name));
252
0
}
253
254
/**
255
 * Return how often the given name appears in `dynhds`.
256
 * Names are case-insensitive.
257
 *
258
 * @unittest 2602
259
 */
260
UNITTEST size_t dynhds_count_name(struct dynhds *dynhds,
261
                                  const char *name, size_t namelen);
262
UNITTEST size_t dynhds_count_name(struct dynhds *dynhds,
263
                                  const char *name, size_t namelen)
264
0
{
265
0
  size_t n = 0;
266
0
  if(dynhds->hds_len) {
267
0
    size_t i;
268
0
    for(i = 0; i < dynhds->hds_len; ++i) {
269
0
      if((namelen == dynhds->hds[i]->namelen) &&
270
0
         curl_strnequal(name, dynhds->hds[i]->name, namelen))
271
0
        ++n;
272
0
    }
273
0
  }
274
0
  return n;
275
0
}
276
277
/**
278
 * Return how often the given null-terminated name appears in `dynhds`.
279
 * Names are case-insensitive.
280
 *
281
 * @unittest 2602
282
 */
283
UNITTEST size_t dynhds_ccount_name(struct dynhds *dynhds,
284
                                        const char *name);
285
UNITTEST size_t dynhds_ccount_name(struct dynhds *dynhds,
286
                                        const char *name)
287
0
{
288
0
  return dynhds_count_name(dynhds, name, strlen(name));
289
0
}
290
291
/**
292
 * Remove all entries with the given name.
293
 * Returns number of entries removed.
294
 *
295
 * @unittest 2602
296
 */
297
UNITTEST size_t dynhds_remove(struct dynhds *dynhds,
298
                              const char *name, size_t namelen);
299
UNITTEST size_t dynhds_remove(struct dynhds *dynhds,
300
                              const char *name, size_t namelen)
301
0
{
302
0
  size_t n = 0;
303
0
  if(dynhds->hds_len) {
304
0
    size_t i, len;
305
0
    for(i = 0; i < dynhds->hds_len; ++i) {
306
0
      if((namelen == dynhds->hds[i]->namelen) &&
307
0
         curl_strnequal(name, dynhds->hds[i]->name, namelen)) {
308
0
        ++n;
309
0
        --dynhds->hds_len;
310
0
        dynhds->strs_len -= (dynhds->hds[i]->namelen +
311
0
                             dynhds->hds[i]->valuelen);
312
0
        entry_free(dynhds->hds[i]);
313
0
        len = dynhds->hds_len - i; /* remaining entries */
314
0
        if(len) {
315
0
          memmove(&dynhds->hds[i], &dynhds->hds[i + 1],
316
0
                  len * sizeof(dynhds->hds[i]));
317
0
        }
318
0
        --i; /* do this index again */
319
0
      }
320
0
    }
321
0
  }
322
0
  return n;
323
0
}
324
325
/**
326
 * Set the give header name and value, replacing any entries with
327
 * the same name. The header is added at the end of all (remaining)
328
 * entries.
329
 *
330
 * @unittest 2602
331
 */
332
UNITTEST CURLcode dynhds_set(struct dynhds *dynhds,
333
                             const char *name, size_t namelen,
334
                             const char *value, size_t valuelen);
335
UNITTEST CURLcode dynhds_set(struct dynhds *dynhds,
336
                             const char *name, size_t namelen,
337
                             const char *value, size_t valuelen)
338
0
{
339
0
  dynhds_remove(dynhds, name, namelen);
340
0
  return Curl_dynhds_add(dynhds, name, namelen, value, valuelen);
341
0
}
342
343
/* @unittest 2602 */
344
UNITTEST size_t dynhds_cremove(struct dynhds *dynhds, const char *name);
345
UNITTEST size_t dynhds_cremove(struct dynhds *dynhds, const char *name)
346
0
{
347
0
  return dynhds_remove(dynhds, name, strlen(name));
348
0
}
349
350
#endif /* UNITTESTS */
351
352
CURLcode Curl_dynhds_h1_dprint(struct dynhds *dynhds, struct dynbuf *dbuf)
353
874
{
354
874
  CURLcode result = CURLE_OK;
355
874
  size_t i;
356
357
874
  if(!dynhds->hds_len)
358
0
    return result;
359
360
6.29k
  for(i = 0; i < dynhds->hds_len; ++i) {
361
5.42k
    result = curlx_dyn_addn(dbuf, dynhds->hds[i]->name,
362
5.42k
                            dynhds->hds[i]->namelen);
363
5.42k
    if(!result)
364
5.42k
      result = curlx_dyn_addn(dbuf, STRCONST(": "));
365
5.42k
    if(!result)
366
5.42k
      result = curlx_dyn_addn(dbuf, dynhds->hds[i]->value,
367
5.42k
                              dynhds->hds[i]->valuelen);
368
5.42k
    if(!result)
369
5.42k
      result = curlx_dyn_addn(dbuf, STRCONST("\r\n"));
370
5.42k
    if(result)
371
0
      break;
372
5.42k
  }
373
374
874
  return result;
375
874
}
376
377
#ifdef USE_NGHTTP2
378
379
nghttp2_nv *Curl_dynhds_to_nva(struct dynhds *dynhds, size_t *pcount)
380
5.24k
{
381
5.24k
  nghttp2_nv *nva = curlx_calloc(1, sizeof(nghttp2_nv) * dynhds->hds_len);
382
5.24k
  size_t i;
383
384
5.24k
  *pcount = 0;
385
5.24k
  if(!nva)
386
0
    return NULL;
387
388
90.1k
  for(i = 0; i < dynhds->hds_len; ++i) {
389
84.8k
    struct dynhds_entry *e = dynhds->hds[i];
390
84.8k
    DEBUGASSERT(e);
391
84.8k
    nva[i].name = (unsigned char *)e->name;
392
84.8k
    nva[i].namelen = e->namelen;
393
84.8k
    nva[i].value = (unsigned char *)e->value;
394
84.8k
    nva[i].valuelen = e->valuelen;
395
84.8k
    nva[i].flags = NGHTTP2_NV_FLAG_NONE;
396
84.8k
  }
397
5.24k
  *pcount = dynhds->hds_len;
398
5.24k
  return nva;
399
5.24k
}
400
401
#endif /* USE_NGHTTP2 */