master
1#ifndef HEADER_CURL_VTLS_INT_H
2#define HEADER_CURL_VTLS_INT_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#ifdef USE_SSL
30#include "cfilters.h"
31#include "select.h"
32#include "urldata.h"
33#include "vtls/vtls.h"
35struct Curl_ssl;
36struct ssl_connect_data;
37struct Curl_ssl_session;
39/* see https://www.iana.org/assignments/tls-extensiontype-values/ */
40#define ALPN_HTTP_1_0_LENGTH 8
41#define ALPN_HTTP_1_0 "http/1.0"
42#define ALPN_HTTP_1_1_LENGTH 8
43#define ALPN_HTTP_1_1 "http/1.1"
44#define ALPN_H2_LENGTH 2
45#define ALPN_H2 "h2"
46#define ALPN_H3_LENGTH 2
47#define ALPN_H3 "h3"
49/* conservative sizes on the ALPN entries and count we are handling,
50 * we can increase these if we ever feel the need or have to accommodate
51 * ALPN strings from the "outside". */
52#define ALPN_NAME_MAX 10
53#define ALPN_ENTRIES_MAX 3
54#define ALPN_PROTO_BUF_MAX (ALPN_ENTRIES_MAX * (ALPN_NAME_MAX + 1))
56struct alpn_spec {
57 char entries[ALPN_ENTRIES_MAX][ALPN_NAME_MAX];
58 size_t count; /* number of entries */
59};
61struct alpn_proto_buf {
62 unsigned char data[ALPN_PROTO_BUF_MAX];
63 int len;
64};
66CURLcode Curl_alpn_to_proto_buf(struct alpn_proto_buf *buf,
67 const struct alpn_spec *spec);
68CURLcode Curl_alpn_to_proto_str(struct alpn_proto_buf *buf,
69 const struct alpn_spec *spec);
70void Curl_alpn_restrict_to(struct alpn_spec *spec, const char *proto);
71void Curl_alpn_copy(struct alpn_spec *dest, const struct alpn_spec *src);
73CURLcode Curl_alpn_set_negotiated(struct Curl_cfilter *cf,
74 struct Curl_easy *data,
75 struct ssl_connect_data *connssl,
76 const unsigned char *proto,
77 size_t proto_len);
79bool Curl_alpn_contains_proto(const struct alpn_spec *spec, const char *proto);
81/* enum for the nonblocking SSL connection state machine */
82typedef enum {
83 ssl_connect_1,
84 ssl_connect_2,
85 ssl_connect_3,
86 ssl_connect_done
87} ssl_connect_state;
89typedef enum {
90 ssl_connection_none,
91 ssl_connection_deferred,
92 ssl_connection_negotiating,
93 ssl_connection_complete
94} ssl_connection_state;
96typedef enum {
97 ssl_earlydata_none,
98 ssl_earlydata_await,
99 ssl_earlydata_sending,
100 ssl_earlydata_sent,
101 ssl_earlydata_accepted,
102 ssl_earlydata_rejected
103} ssl_earlydata_state;
105#define CURL_SSL_IO_NEED_NONE 0
106#define CURL_SSL_IO_NEED_RECV (1 << 0)
107#define CURL_SSL_IO_NEED_SEND (1 << 1)
109/* Max earlydata payload we want to send */
110#define CURL_SSL_EARLY_MAX (64 * 1024)
112/* Information in each SSL cfilter context: cf->ctx */
113struct ssl_connect_data {
114 const struct Curl_ssl *ssl_impl; /* TLS backend for this filter */
115 struct ssl_peer peer; /* peer the filter talks to */
116 const struct alpn_spec *alpn; /* ALPN to use or NULL for none */
117 void *backend; /* vtls backend specific props */
118 struct cf_call_data call_data; /* data handle used in current call */
119 struct Curl_ssl_session *session; /* TLS session in use or NULL */
120 struct curltime handshake_done; /* time when handshake finished */
121 struct {
122 char *alpn; /* ALPN value or NULL */
123 } negotiated;
124 struct bufq earlydata; /* earlydata to be send to peer */
125 size_t earlydata_max; /* max earlydata allowed by peer */
126 size_t earlydata_skip; /* sending bytes to skip when earlydata
127 * is accepted by peer */
128 ssl_connection_state state;
129 ssl_connect_state connecting_state;
130 ssl_earlydata_state earlydata_state;
131 int io_need; /* TLS signals special SEND/RECV needs */
132 BIT(peer_closed); /* peer has closed connection */
133 BIT(prefs_checked); /* SSL preferences have been checked */
134 BIT(input_pending); /* data for SSL_read() may be available */
135 BIT(stats_reported); /* connect times have been reported */
136};
138/* Definitions for SSL Implementations */
140struct Curl_ssl {
141 /*
142 * This *must* be the first entry to allow returning the list of available
143 * backends in curl_global_sslset().
144 */
145 curl_ssl_backend info;
146 unsigned int supports; /* bitfield, see above */
147 size_t sizeof_ssl_backend_data;
149 int (*init)(void);
150 void (*cleanup)(void);
152 size_t (*version)(char *buffer, size_t size);
153 CURLcode (*shut_down)(struct Curl_cfilter *cf, struct Curl_easy *data,
154 bool send_shutdown, bool *done);
156 /* data_pending() shall return TRUE when it wants to get called again to
157 drain internal buffers and deliver data instead of waiting for the socket
158 to get readable */
159 bool (*data_pending)(struct Curl_cfilter *cf, const struct Curl_easy *data);
161 /* return 0 if a find random is filled in */
162 CURLcode (*random)(struct Curl_easy *data, unsigned char *entropy,
163 size_t length);
164 bool (*cert_status_request)(void);
166 CURLcode (*do_connect)(struct Curl_cfilter *cf, struct Curl_easy *data,
167 bool *done);
169 /* During handshake/shutdown, adjust the pollset to include the socket
170 * for POLLOUT or POLLIN as needed. Mandatory. */
171 CURLcode (*adjust_pollset)(struct Curl_cfilter *cf, struct Curl_easy *data,
172 struct easy_pollset *ps);
173 void *(*get_internals)(struct ssl_connect_data *connssl, CURLINFO info);
174 void (*close)(struct Curl_cfilter *cf, struct Curl_easy *data);
175 void (*close_all)(struct Curl_easy *data);
177 struct curl_slist *(*engines_list)(struct Curl_easy *data);
179 CURLcode (*sha256sum)(const unsigned char *input, size_t inputlen,
180 unsigned char *sha256sum, size_t sha256sumlen);
181 CURLcode (*recv_plain)(struct Curl_cfilter *cf, struct Curl_easy *data,
182 char *buf, size_t len, size_t *pnread);
183 CURLcode (*send_plain)(struct Curl_cfilter *cf, struct Curl_easy *data,
184 const void *mem, size_t len, size_t *pnwritten);
186 CURLcode (*get_channel_binding)(struct Curl_easy *data, int8_t sockindex,
187 struct dynbuf *binding);
188};
190extern const struct Curl_ssl *Curl_ssl;
192CURLcode Curl_ssl_adjust_pollset(struct Curl_cfilter *cf,
193 struct Curl_easy *data,
194 struct easy_pollset *ps);
196/**
197 * Get the SSL filter below the given one or NULL if there is none.
198 */
199bool Curl_ssl_cf_is_proxy(struct Curl_cfilter *cf);
201CURLcode Curl_on_session_reuse(struct Curl_cfilter *cf,
202 struct Curl_easy *data,
203 struct alpn_spec *alpns,
204 struct Curl_ssl_session *scs,
205 bool *do_early_data, bool early_data_allowed);
207/* Retrieve the SSL session held at the filter of type `cft` at
208 * data's connection at `sockindex` or NULL if not found/available. */
209struct Curl_ssl_session *Curl_ssl_get_cf_session(struct Curl_easy *data,
210 const struct Curl_cftype *cft,
211 int8_t sockindex);
213#endif /* USE_SSL */
215#endif /* HEADER_CURL_VTLS_INT_H */
217#ifdef USE_SSL
218/* Restore the default SSL filter call_data accessor for unity builds. */
219#undef CF_CTX_CALL_DATA
220#define CF_CTX_CALL_DATA(cf) ((struct ssl_connect_data *)(cf)->ctx)->call_data
221#endif
Diagnostics4 git calls · 26 ms
CallStatusSizeTime026 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=21 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
fetch2002.9 KiB · hit21 ms
git.upload-pack fetch http.response.status_code=200 git.response.bytes=2968 git.response.cache=HIT git.response.duration_ms=21 git.fetch.wants=7e6fbdf96634c97b5745451fc70b8a1c48df1996 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=2968 git.pkt.payload.max=2947 git.sideband.band1.bytes=2946 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
- a5e37de80a8b9318
- Request
- 9e3277c8…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format