master
1#ifndef HEADER_CURL_DYNHDS_H
2#define HEADER_CURL_DYNHDS_H
3/***************************************************************************
4 * _ _ ____ _
5 * Project ___| | | | _ \| |
6 * / __| | | | |_) | |
7 * | (__| |_| | _ <| |___
8 * \___|\___/|_| \_\_____|
9 *
10 * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
11 *
12 * This software is licensed as described in the file COPYING, which
13 * you should have received as part of this distribution. The terms
14 * are also available at https://curl.se/docs/copyright.html.
15 *
16 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
17 * copies of the Software, and permit persons to whom the Software is
18 * furnished to do so, under the terms of the COPYING file.
19 *
20 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
21 * KIND, either express or implied.
22 *
23 * SPDX-License-Identifier: curl
24 *
25 ***************************************************************************/
26#include "curl_setup.h"
28#include "curlx/dynbuf.h"
30struct dynbuf;
32/**
33 * A single header entry.
34 * `name` and `value` are non-NULL and always null-terminated.
35 */
36struct dynhds_entry {
37 char *name;
38 char *value;
39 size_t namelen;
40 size_t valuelen;
41};
43struct dynhds {
44 struct dynhds_entry **hds;
45 size_t hds_len; /* number of entries in hds */
46 size_t hds_allc; /* size of hds allocation */
47 size_t max_entries; /* size limit number of entries */
48 size_t strs_len; /* length of all strings */
49 size_t max_strs_size; /* max length of all strings */
50 int opts;
51};
53#define DYNHDS_OPT_NONE 0
54#define DYNHDS_OPT_LOWERCASE (1 << 0)
56/**
57 * Init for use on first time or after a reset.
58 * Allow `max_entries` headers to be added, 0 for unlimited.
59 * Allow size of all name and values added to not exceed `max_strs_size``
60 */
61void Curl_dynhds_init(struct dynhds *dynhds, size_t max_entries,
62 size_t max_strs_size);
63/**
64 * Frees all data held in `dynhds`, but not the struct itself.
65 */
66void Curl_dynhds_free(struct dynhds *dynhds);
68/**
69 * Reset `dyndns` to the initial init state. May keep allocations
70 * around.
71 */
72void Curl_dynhds_reset(struct dynhds *dynhds);
74/**
75 * Return the number of header entries.
76 */
77size_t Curl_dynhds_count(struct dynhds *dynhds);
79/**
80 * Set the options to use, replacing any existing ones.
81 * This will not have an effect on already existing headers.
82 */
83void Curl_dynhds_set_opts(struct dynhds *dynhds, int opts);
85/**
86 * Return the n-th header entry or NULL if it does not exist.
87 */
88struct dynhds_entry *Curl_dynhds_getn(struct dynhds *dynhds, size_t n);
90/**
91 * Return the 1st header entry of the name or NULL if none exists.
92 */
93struct dynhds_entry *Curl_dynhds_get(struct dynhds *dynhds,
94 const char *name, size_t namelen);
95struct dynhds_entry *Curl_dynhds_cget(struct dynhds *dynhds, const char *name);
97CURLcode Curl_dynhds_cset(struct dynhds *dynhds,
98 const char *name, const char *value);
100/**
101 * Add a header, name + value, to `dynhds` at the end. Does *not*
102 * check for duplicate names.
103 */
104CURLcode Curl_dynhds_add(struct dynhds *dynhds,
105 const char *name, size_t namelen,
106 const char *value, size_t valuelen);
108/**
109 * Add a header, c-string name + value, to `dynhds` at the end.
110 */
111CURLcode Curl_dynhds_cadd(struct dynhds *dynhds,
112 const char *name, const char *value);
114/**
115 * Add a single header from an HTTP/1.1 formatted line at the end. Line may
116 * contain a delimiting CRLF or LF. Any characters after that will be ignored.
117 */
118CURLcode Curl_dynhds_h1_cadd_line(struct dynhds *dynhds, const char *line);
120/**
121 * Add a single header from an HTTP/1.1 formatted line at the end. Line may
122 * contain a delimiting CRLF or LF. Any characters after that will be ignored.
123 */
124CURLcode Curl_dynhds_h1_add_line(struct dynhds *dynhds,
125 const char *line, size_t line_len);
127/**
128 * Add the headers to the given `dynbuf` in HTTP/1.1 format with
129 * CR+LF line endings. Does NOT output a last empty line.
130 */
131CURLcode Curl_dynhds_h1_dprint(struct dynhds *dynhds, struct dynbuf *dbuf);
133#ifdef USE_NGHTTP2
135#include <nghttp2/nghttp2.h>
137nghttp2_nv *Curl_dynhds_to_nva(struct dynhds *dynhds, size_t *pcount);
139#endif /* USE_NGHTTP2 */
141#endif /* HEADER_CURL_DYNHDS_H */
Diagnostics4 git calls · 24 ms
CallStatusSizeTime024 ms
discover200152 B3 ms
git.upload-pack discover http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=2 git.response.bytes=152 git.server.agent=gitty/1.0 git.server.object_format=sha1 git.server.caps=agent ls-refs fetch object-format git.server.fetch=shallow filter sideband-all git.protocol.version=2 git.pkt.frames=8 git.pkt.data=6 git.pkt.flush=2 git.pkt.delim=0 git.pkt.bytes=152 git.pkt.payload.max=34
ls-refs200149 B · hit3 ms
git.upload-pack ls-refs http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=3 git.response.bytes=149 git.response.cache=HIT git.response.duration_ms=3 git.protocol.version=2 git.pkt.frames=3 git.pkt.data=2 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=149 git.pkt.payload.max=78 git.ls_refs.count=2 git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit2 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=19 git.response.bytes=293470 git.response.cache=HIT git.response.duration_ms=2 git.fetch.filter=blob:none git.fetch.filter.requested=tree:0 git.fetch.filter.fallback=blob:none git.fetch.filter.learned=false git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d git.fetch.haves.count=0 git.fetch.deepen=10 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=10 git.pkt.data=8 git.pkt.flush=1 git.pkt.delim=1 git.pkt.bytes=293470 git.pkt.payload.max=65516 git.sideband.band1.bytes=293354 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=87 git.pack.bytes=293354 git.pack.ofs_delta=0 git.pack.ref_delta=1 git.pack.chain.max=1 git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0 git.pack.full=86Open pack map
fetch2001.6 KiB · hit19 ms
git.upload-pack fetch http.response.status_code=200 git.response.bytes=1647 git.response.cache=HIT git.response.duration_ms=19 git.fetch.wants=d5337eb35354e6f790bfce907061681e88d35c93 git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=3 git.pkt.data=2 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=1647 git.pkt.payload.max=1626 git.sideband.band1.bytes=1625 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0
Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.
- Remote
- https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
- Ref
- refs/heads/master
- Commit
- 31c911efe5652725e930f4d2e60c9060e5f6646d
- cf-ray
- a5e1b8aedaa25b65
- Request
- 02026be5…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format