Coverage Report

Created: 2026-09-14 07:06

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/curl/lib/cf-setup.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 "urldata.h"
27
#include "cfilters.h"
28
#include "cf-haproxy.h"
29
#include "cf-ip-happy.h"
30
#include "cf-setup.h"
31
#include "curl_trc.h"
32
#include "connect.h"
33
#include "http_proxy.h"
34
#include "socks.h"
35
#include "vquic/cf-capsule.h"
36
#include "vquic/vquic.h"
37
#include "vtls/vtls.h"
38
39
40
typedef enum {
41
  CF_SETUP_INIT,
42
  CF_SETUP_CNNCT_EYEBALLS,
43
  CF_SETUP_CNNCT_SOCKS,
44
  CF_SETUP_CNNCT_HTTP_PROXY,
45
  CF_SETUP_CNNCT_HAPROXY,
46
  CF_SETUP_CNNCT_SSL,
47
  CF_SETUP_DONE
48
} cf_setup_state;
49
50
struct cf_setup_ctx {
51
  cf_setup_state state;
52
  int ssl_mode;
53
  uint8_t transport;
54
  uint8_t retry_count;
55
};
56
57
#ifndef CURL_DISABLE_PROXY
58
59
static CURLcode cf_setup_add_haproxy(struct Curl_cfilter *cf,
60
                                     struct Curl_easy *data)
61
5.94k
{
62
5.94k
  struct cf_setup_ctx *ctx = cf->ctx;
63
5.94k
  CURLcode result = CURLE_OK;
64
65
5.94k
  if(ctx->state < CF_SETUP_CNNCT_HAPROXY) {
66
5.90k
    if(data->set.haproxyprotocol) {
67
40
      if(ctx->transport == TRNSPRT_QUIC) {
68
0
        failf(data, "haproxy protocol does not support QUIC");
69
0
        return CURLE_UNSUPPORTED_PROTOCOL;
70
0
      }
71
40
      result = Curl_cf_haproxy_insert_after(cf, data);
72
40
      if(result) {
73
0
        CURL_TRC_CF(data, cf, "adding HAPROXY filter failed -> %d",
74
0
                    (int)result);
75
0
        return result;
76
0
      }
77
40
      CURL_TRC_CF(data, cf, "added HAPROXY filter");
78
40
    }
79
5.90k
    ctx->state = CF_SETUP_CNNCT_HAPROXY;
80
5.90k
  }
81
5.94k
  return result;
82
5.94k
}
83
84
static CURLcode cf_setup_add_socks(struct Curl_cfilter *cf,
85
                                   struct Curl_easy *data)
86
7.47k
{
87
7.47k
  struct cf_setup_ctx *ctx = cf->ctx;
88
7.47k
  CURLcode result = CURLE_OK;
89
7.47k
  if(ctx->state < CF_SETUP_CNNCT_SOCKS && cf->conn->socks_proxy.peer) {
90
    /* Add a SOCKS proxy to go through `first_peer` to `second_peer`*/
91
108
    struct Curl_peer *second_peer;
92
93
108
    if(cf->conn->http_proxy.peer)
94
27
      second_peer = cf->conn->http_proxy.peer;
95
81
    else
96
81
      second_peer = Curl_conn_get_destination(cf->conn, cf->sockindex);
97
108
    if(!second_peer)
98
0
      return CURLE_FAILED_INIT;
99
100
108
    result = Curl_cf_socks_proxy_insert_after(
101
108
      cf, data, second_peer, cf->conn->ip_version,
102
108
      cf->conn->socks_proxy.proxytype,
103
108
      cf->conn->socks_proxy.creds);
104
108
    if(result) {
105
0
      CURL_TRC_CF(data, cf, "adding SOCKS filter failed -> %d", (int)result);
106
0
      return result;
107
0
    }
108
109
108
    CURL_TRC_CF(data, cf, "added SOCKS filter to %s:%u",
110
108
                second_peer->hostname, second_peer->port);
111
108
    ctx->state = CF_SETUP_CNNCT_SOCKS;
112
108
  }
113
7.47k
  return result;
114
7.47k
}
115
116
#ifndef CURL_DISABLE_HTTP
117
static CURLcode cf_setup_add_http_proxy(struct Curl_cfilter *cf,
118
                                        struct Curl_easy *data)
119
7.36k
{
120
7.36k
  struct cf_setup_ctx *ctx = cf->ctx;
121
7.36k
  CURLcode result = CURLE_OK;
122
123
7.36k
  if(ctx->state < CF_SETUP_CNNCT_HTTP_PROXY &&
124
7.26k
     cf->conn->http_proxy.peer && !cf->conn->bits.origin_is_proxy) {
125
1.41k
    struct Curl_peer *peer = cf->conn->http_proxy.peer;
126
1.41k
    struct Curl_peer *tunnel_peer =
127
1.41k
      Curl_conn_get_destination(cf->conn, cf->sockindex);
128
129
1.41k
#ifdef USE_SSL
130
1.41k
    if(CURL_PROXY_IS_HTTPS(cf->conn->http_proxy.proxytype) &&
131
0
       !Curl_conn_is_ssl(cf->conn, cf->sockindex)) {
132
0
      result = Curl_cf_ssl_proxy_insert_after(
133
0
        cf, data, cf->conn->http_proxy.peer);
134
0
      if(result) {
135
0
        CURL_TRC_CF(data, cf, "adding SSL filter for HTTP proxy failed -> %d",
136
0
                    (int)result);
137
0
        return result;
138
0
      }
139
0
      CURL_TRC_CF(data, cf, "added SSL filter for HTTP proxy");
140
0
    }
141
1.41k
#endif /* USE_SSL */
142
143
1.41k
    result = Curl_cf_http_proxy_insert_after(
144
1.41k
      cf, data, peer, tunnel_peer,
145
1.41k
      ctx->transport, cf->conn->http_proxy.proxytype);
146
1.41k
    if(result) {
147
0
      CURL_TRC_CF(data, cf, "adding HTTP proxy tunnel filter failed -> %d",
148
0
                  (int)result);
149
0
      return result;
150
0
    }
151
1.41k
    CURL_TRC_CF(data, cf, "added HTTP proxy tunnel filter");
152
1.41k
    ctx->state = CF_SETUP_CNNCT_HTTP_PROXY;
153
1.41k
  }
154
7.36k
  return result;
155
7.36k
}
156
#endif /* !CURL_DISABLE_HTTP */
157
#endif /* CURL_DISABLE_PROXY */
158
159
/* Get the origin curl connects its socket to.
160
 * Can be origin or the first proxy. */
161
static struct Curl_peer *conn_get_first_origin(struct connectdata *conn,
162
                                             int8_t sockindex)
163
7.44k
{
164
7.44k
#ifndef CURL_DISABLE_PROXY
165
7.44k
  if(conn->socks_proxy.peer)
166
111
    return conn->socks_proxy.peer;
167
7.33k
  if(conn->http_proxy.peer)
168
1.43k
    return conn->http_proxy.peer;
169
5.89k
#endif
170
5.89k
  return (sockindex == SECONDARYSOCKET) ? conn->origin2 : conn->origin;
171
7.33k
}
172
173
static CURLcode cf_setup_add_ip_happy(struct Curl_cfilter *cf,
174
                                      struct Curl_easy *data)
175
14.9k
{
176
14.9k
  struct cf_setup_ctx *ctx = cf->ctx;
177
14.9k
  CURLcode result = CURLE_OK;
178
179
14.9k
  if(ctx->state < CF_SETUP_CNNCT_EYEBALLS) {
180
    /* What is the first hop we directly connect to and what transport
181
     * do we use for it? Only on the first hop we can do Happy Eyeballs.
182
     * first_origin and first_peer differ on --connect-to. */
183
7.44k
    struct Curl_peer *first_origin =
184
7.44k
      conn_get_first_origin(cf->conn, cf->sockindex);
185
7.44k
    struct Curl_peer *first_peer =
186
7.44k
      Curl_conn_get_first_peer(cf->conn, cf->sockindex);
187
7.44k
    struct Curl_peer *tunnel_peer = NULL;
188
7.44k
    uint8_t first_transport = ctx->transport;
189
190
7.44k
    if(!first_peer)
191
0
      return CURLE_FAILED_INIT;
192
193
7.44k
#if !defined(CURL_DISABLE_PROXY) && !defined(CURL_DISABLE_HTTP)
194
7.44k
    if(cf->conn->http_proxy.peer && !cf->conn->bits.origin_is_proxy) {
195
1.46k
      first_transport =
196
1.46k
        Curl_http_proxy_transport(cf->conn->http_proxy.proxytype);
197
1.46k
      tunnel_peer = Curl_conn_get_destination(cf->conn, cf->sockindex);
198
1.46k
      if((first_transport == TRNSPRT_QUIC) && cf->conn->socks_proxy.peer) {
199
0
        failf(data, "HTTP/3 proxy not possible via SOCKS");
200
0
        return CURLE_UNSUPPORTED_PROTOCOL;
201
0
      }
202
1.46k
    }
203
7.44k
#endif /* !CURL_DISABLE_PROXY && !CURL_DISABLE_HTTP */
204
205
7.44k
    result = Curl_cf_ip_happy_insert_after(cf, data, first_origin, first_peer,
206
7.44k
                                           first_transport,
207
7.44k
                                           tunnel_peer, ctx->transport);
208
7.44k
    if(result) {
209
0
      CURL_TRC_CF(data, cf, "adding happy eyeballs failed -> %d", (int)result);
210
0
      return result;
211
0
    }
212
213
7.44k
    if(tunnel_peer && (first_transport == TRNSPRT_QUIC)) {
214
0
      CURL_TRC_CF(data, cf, "happy eyeballing to HTTP/3 proxy %s:%u",
215
0
                  first_peer->hostname, first_peer->port);
216
0
      ctx->state = CF_SETUP_CNNCT_HTTP_PROXY;
217
0
    }
218
7.44k
    else {
219
7.44k
      CURL_TRC_CF(data, cf, "happy eyeballing to %s %s:%u",
220
7.44k
                  tunnel_peer ? "proxy" : "origin",
221
7.44k
                  first_peer->hostname, first_peer->port);
222
7.44k
      ctx->state = CF_SETUP_CNNCT_EYEBALLS;
223
7.44k
    }
224
7.44k
  }
225
14.9k
  return result;
226
14.9k
}
227
228
static CURLcode cf_setup_add_origin_filters(struct Curl_cfilter *cf,
229
                                            struct Curl_easy *data)
230
5.90k
{
231
5.90k
  struct cf_setup_ctx *ctx = cf->ctx;
232
5.90k
  CURLcode result = CURLE_OK;
233
234
5.90k
  (void)data; /* not used in all builds */
235
5.90k
  if(ctx->state < CF_SETUP_CNNCT_SSL) {
236
#if !defined(CURL_DISABLE_HTTP) && defined(USE_HTTP3) && \
237
    !defined(CURL_DISABLE_PROXY)
238
239
    /* Wanting QUIC with an HTTP tunneling filter, we now need to add
240
     * the QUIC filter on top. Without tunneling, this has already
241
     * happened in the Happy Eyeball filter. */
242
    if(ctx->transport == TRNSPRT_QUIC &&
243
       cf->conn->http_proxy.peer && !cf->conn->bits.origin_is_proxy) {
244
      struct Curl_peer *origin = Curl_conn_get_origin(cf->conn, cf->sockindex);
245
      struct Curl_peer *peer =
246
        Curl_conn_get_destination(cf->conn, cf->sockindex);
247
248
      result = Curl_cf_capsule_insert_after(cf, data);
249
      if(result) {
250
        CURL_TRC_CF(data, cf, "adding capsule filter failed -> %d",
251
                    (int)result);
252
        return result;
253
      }
254
      result = Curl_cf_quic_insert_after(cf, data, origin, peer);
255
      if(result) {
256
        CURL_TRC_CF(data, cf, "adding QUIC filter failed -> %d", (int)result);
257
        return result;
258
      }
259
      CURL_TRC_CF(data, cf, "added QUIC filter for origin");
260
    }
261
    else
262
#endif /* !CURL_DISABLE_HTTP && USE_HTTP3 && CURL_DISABLE_PROXY */
263
5.90k
#ifdef USE_SSL
264
5.90k
    if((ctx->ssl_mode == CURL_CF_SSL_ENABLE ||
265
5.90k
        (ctx->ssl_mode != CURL_CF_SSL_DISABLE &&
266
5.90k
         cf->conn->scheme->flags & PROTOPT_SSL)) && /* we want SSL */
267
3.34k
       !Curl_conn_is_ssl(cf->conn, cf->sockindex)) { /* it is missing */
268
269
3.34k
#ifndef CURL_DISABLE_PROXY
270
3.34k
      if(cf->conn->bits.origin_is_proxy) {
271
0
        result = Curl_cf_ssl_proxy_insert_after(cf, data, cf->conn->origin);
272
0
      }
273
3.34k
      else
274
3.34k
#endif
275
3.34k
      {
276
        /* FTP is a bitch. Wherever we really connect to on the DATA
277
         * (secondary) connection, many servers require TLS sessions reuse
278
         * to prove they are talking to the same client.
279
         * For the TLS session lookup to work, we need to instantiate
280
         * the SSL filter with the same peers as FIRSTSOCKET. See #22225
281
         * Meaning: cf->sockindex does not matter here. */
282
3.34k
        result = Curl_cf_ssl_insert_after(cf, data,
283
3.34k
          Curl_conn_get_origin(cf->conn, FIRSTSOCKET),
284
3.34k
          Curl_conn_get_destination(cf->conn, FIRSTSOCKET));
285
3.34k
      }
286
3.34k
      if(result) {
287
23
        CURL_TRC_CF(data, cf, "adding SSL filter for origin failed -> %d",
288
23
                    (int)result);
289
23
        return result;
290
23
      }
291
3.32k
      CURL_TRC_CF(data, cf, "added SSL filter for origin");
292
3.32k
    }
293
5.88k
#endif /* USE_SSL */
294
5.88k
    ctx->state = CF_SETUP_CNNCT_SSL;
295
5.88k
  }
296
5.88k
  return result;
297
5.90k
}
298
299
static CURLcode cf_setup_connect_steps(struct Curl_cfilter *cf,
300
                                       struct Curl_easy *data,
301
                                       bool *done)
302
7.71k
{
303
7.71k
  struct cf_setup_ctx *ctx = cf->ctx;
304
7.71k
  CURLcode result = CURLE_OK;
305
306
7.71k
  if(cf->connected) {
307
0
    *done = TRUE;
308
0
    return CURLE_OK;
309
0
  }
310
311
  /* connect current sub-chain */
312
20.0k
connect_sub_chain:
313
20.0k
  VERBOSE(Curl_conn_trc_filters(data, cf->sockindex, "cf_setup_connect"));
314
315
20.0k
  if(cf->next && !cf->next->connected) {
316
12.6k
    result = Curl_conn_cf_connect(cf->next, data, done);
317
12.6k
    if(result || !*done)
318
5.12k
      return result;
319
12.6k
  }
320
321
14.9k
  result = cf_setup_add_ip_happy(cf, data);
322
14.9k
  if(result)
323
0
    return result;
324
14.9k
  if(!cf->next || !cf->next->connected)
325
7.44k
    goto connect_sub_chain;
326
327
7.47k
#ifndef CURL_DISABLE_PROXY
328
7.47k
  result = cf_setup_add_socks(cf, data);
329
7.47k
  if(result)
330
0
    return result;
331
7.47k
  if(!cf->next || !cf->next->connected)
332
108
    goto connect_sub_chain;
333
334
7.36k
#ifndef CURL_DISABLE_HTTP
335
7.36k
  result = cf_setup_add_http_proxy(cf, data);
336
7.36k
  if(result)
337
0
    return result;
338
7.36k
  if(!cf->next || !cf->next->connected)
339
1.41k
    goto connect_sub_chain;
340
5.94k
#endif /* !CURL_DISABLE_HTTP */
341
342
5.94k
  result = cf_setup_add_haproxy(cf, data);
343
5.94k
  if(result)
344
0
    return result;
345
5.94k
  if(!cf->next || !cf->next->connected)
346
40
    goto connect_sub_chain;
347
5.90k
#endif /* !CURL_DISABLE_PROXY */
348
349
5.90k
  result = cf_setup_add_origin_filters(cf, data);
350
5.90k
  if(result)
351
23
    return result;
352
5.88k
  if(!cf->next || !cf->next->connected)
353
3.32k
    goto connect_sub_chain;
354
355
2.56k
  ctx->state = CF_SETUP_DONE;
356
2.56k
  cf->connected = TRUE;
357
2.56k
  *done = TRUE;
358
2.56k
  return CURLE_OK;
359
5.88k
}
360
361
static CURLcode cf_setup_connect(struct Curl_cfilter *cf,
362
                                 struct Curl_easy *data,
363
                                 bool *done)
364
7.71k
{
365
7.71k
  struct cf_setup_ctx *ctx = cf->ctx;
366
7.71k
  CURLcode result;
367
368
  /* In some situations, a server/proxy may close the connection and
369
   * we need to connect again (HTTP/1.x proxy auth, for example).
370
   * We used to close the filters and reuse them for another attempt,
371
   * however that complicates filter code and it is simpler to tear them
372
   * all down and start over. */
373
7.71k
retry:
374
7.71k
  result = cf_setup_connect_steps(cf, data, done);
375
376
7.71k
  if(result == CURLE_AGAIN) {
377
0
    ++ctx->retry_count;
378
0
    if(ctx->retry_count > 5) /* arbitrary limit, better just timeout? */
379
0
      return CURLE_COULDNT_CONNECT;
380
381
0
    CURL_TRC_CF(data, cf, "retrying connect, %d. time", ctx->retry_count);
382
0
    Curl_conn_cf_discard_chain(&cf->next, data);
383
0
    ctx->state = CF_SETUP_INIT;
384
0
    goto retry;
385
0
  }
386
7.71k
  return result;
387
7.71k
}
388
389
static void cf_setup_destroy(struct Curl_cfilter *cf, struct Curl_easy *data)
390
7.47k
{
391
7.47k
  struct cf_setup_ctx *ctx = cf->ctx;
392
393
7.47k
  CURL_TRC_CF(data, cf, "destroy");
394
7.47k
  curlx_safefree(ctx);
395
7.47k
}
396
397
struct Curl_cftype Curl_cft_setup = {
398
  "SETUP",
399
  CF_TYPE_SETUP,
400
  CURL_LOG_LVL_NONE,
401
  cf_setup_destroy,
402
  cf_setup_connect,
403
  Curl_cf_def_shutdown,
404
  Curl_cf_def_adjust_pollset,
405
  Curl_cf_def_data_pending,
406
  Curl_cf_def_send,
407
  Curl_cf_def_recv,
408
  Curl_cf_def_cntrl,
409
  Curl_cf_def_conn_is_alive,
410
  Curl_cf_def_conn_keep_alive,
411
  Curl_cf_def_query,
412
};
413
414
static CURLcode cf_setup_create(struct Curl_cfilter **pcf,
415
                                struct Curl_easy *data,
416
                                uint8_t transport,
417
                                int ssl_mode)
418
7.47k
{
419
7.47k
  struct Curl_cfilter *cf = NULL;
420
7.47k
  struct cf_setup_ctx *ctx;
421
7.47k
  CURLcode result = CURLE_OK;
422
423
7.47k
  (void)data;
424
7.47k
  ctx = curlx_calloc(1, sizeof(*ctx));
425
7.47k
  if(!ctx) {
426
0
    result = CURLE_OUT_OF_MEMORY;
427
0
    goto out;
428
0
  }
429
7.47k
  ctx->state = CF_SETUP_INIT;
430
7.47k
  ctx->ssl_mode = ssl_mode;
431
7.47k
  ctx->transport = transport;
432
433
7.47k
  result = Curl_cf_create(&cf, &Curl_cft_setup, ctx);
434
7.47k
  if(result)
435
0
    goto out;
436
7.47k
  ctx = NULL;
437
438
7.47k
out:
439
7.47k
  *pcf = result ? NULL : cf;
440
7.47k
  if(ctx) {
441
0
    curlx_free(ctx);
442
0
  }
443
7.47k
  return result;
444
7.47k
}
445
446
CURLcode Curl_cf_setup_add(struct Curl_easy *data,
447
                           struct connectdata *conn,
448
                           int8_t sockindex,
449
                           uint8_t transport,
450
                           int ssl_mode)
451
7.47k
{
452
7.47k
  struct Curl_cfilter *cf;
453
7.47k
  CURLcode result = CURLE_OK;
454
455
7.47k
  DEBUGASSERT(data);
456
7.47k
  result = cf_setup_create(&cf, data, transport, ssl_mode);
457
7.47k
  if(result)
458
0
    goto out;
459
7.47k
  Curl_conn_cf_add(data, conn, sockindex, cf);
460
7.47k
out:
461
7.47k
  return result;
462
7.47k
}
463
464
CURLcode Curl_cf_setup_insert_after(struct Curl_cfilter *cf_at,
465
                                    struct Curl_easy *data,
466
                                    uint8_t transport,
467
                                    int ssl_mode)
468
0
{
469
0
  struct Curl_cfilter *cf;
470
0
  CURLcode result;
471
472
0
  DEBUGASSERT(data);
473
0
  result = cf_setup_create(&cf, data, transport, ssl_mode);
474
0
  if(result)
475
0
    goto out;
476
0
  Curl_conn_cf_insert_after(cf_at, cf);
477
0
out:
478
0
  return result;
479
0
}