Line | Count | Source |
1 | | #ifndef HEADER_CURL_CONNECT_H |
2 | | #define HEADER_CURL_CONNECT_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" |
27 | | |
28 | | #include "vdns/hostip.h" |
29 | | #include "curlx/timeval.h" |
30 | | |
31 | | struct Curl_peer; |
32 | | struct Curl_str; |
33 | | |
34 | | enum alpnid Curl_alpn2alpnid(const unsigned char *name, size_t len); |
35 | | |
36 | | /* generic function that returns how much time there is left to run, according |
37 | | to the timeouts set */ |
38 | | timediff_t Curl_timeleft_ms(struct Curl_easy *data); |
39 | | timediff_t Curl_timeleft_now_ms(struct Curl_easy *data, |
40 | | const struct curltime *pnow); |
41 | | |
42 | 35.9k | #define DEFAULT_CONNECT_TIMEOUT 300000 /* milliseconds == five minutes */ |
43 | | |
44 | | /* |
45 | | * Used to extract socket and connectdata struct for the most recent |
46 | | * transfer on the given Curl_easy. |
47 | | * |
48 | | * The returned socket will be CURL_SOCKET_BAD in case of failure! |
49 | | */ |
50 | | curl_socket_t Curl_getconnectinfo(struct Curl_easy *data, |
51 | | struct connectdata **connp); |
52 | | |
53 | | /* |
54 | | * Curl_conncontrol() manipulates the `conn->bits.close` bit on |
55 | | * a connection: |
56 | | * - CONNCTRL_CONN_KEEP: clear the bit |
57 | | * - CONNCTRL_CONN_CLOSE: set the bit |
58 | | * - CONNCTRL_STREAM_CLOSE: set the bit when the connection is not |
59 | | * multiplexed |
60 | | * The call does *NOT* cause any immediate connection close. |
61 | | */ |
62 | 0 | #define CONNCTRL_CONN_KEEP 0 |
63 | 8.26k | #define CONNCTRL_CONN_CLOSE 1 |
64 | 676 | #define CONNCTRL_STREAM_CLOSE 2 |
65 | | |
66 | | void Curl_conncontrol(struct connectdata *conn, int ctrl); |
67 | | |
68 | 338 | #define streamclose(x) Curl_conncontrol((x), CONNCTRL_STREAM_CLOSE) |
69 | 4.13k | #define connclose(x) Curl_conncontrol((x), CONNCTRL_CONN_CLOSE) |
70 | 0 | #define connkeep(x) Curl_conncontrol((x), CONNCTRL_CONN_KEEP) |
71 | | |
72 | | /** |
73 | | * Setup the cfilters at `sockindex` in connection `conn`. |
74 | | * If no filter chain is installed yet, inspects the configuration |
75 | | * in `data` and `conn` to install a suitable filter chain. |
76 | | */ |
77 | | CURLcode Curl_conn_setup(struct Curl_easy *data, |
78 | | struct connectdata *conn, |
79 | | int8_t sockindex, |
80 | | int ssl_mode); |
81 | | |
82 | | /** |
83 | | * Bring the filter chain at `sockindex` for connection `data->conn` into |
84 | | * connected state. Which will set `*done` to TRUE. |
85 | | * This can be called on an already connected chain with no side effects. |
86 | | * When not `blocking`, calls may return without error and `*done != TRUE`, |
87 | | * while the individual filters negotiated the connection. |
88 | | */ |
89 | | CURLcode Curl_conn_connect(struct Curl_easy *data, int8_t sockindex, |
90 | | bool blocking, bool *done); |
91 | | |
92 | | /* Set conn to allow multiplexing. */ |
93 | | void Curl_conn_set_multiplex(struct connectdata *conn); |
94 | | |
95 | | /* Get the origin peer at sockindex. */ |
96 | | struct Curl_peer *Curl_conn_get_origin(struct connectdata *conn, |
97 | | int8_t sockindex); |
98 | | |
99 | | /* Get the peer the connection actually connects to at sockindex. |
100 | | * Often the same as "origin", but can be redirected via "connect-to" |
101 | | * or "alt-svc". May tunnel through proxies. */ |
102 | | struct Curl_peer *Curl_conn_get_destination(struct connectdata *conn, |
103 | | int8_t sockindex); |
104 | | |
105 | | /* Get the peer curl connects its socket to. |
106 | | * Can be origin, "connect-to" or the first proxy. */ |
107 | | struct Curl_peer *Curl_conn_get_first_peer(struct connectdata *conn, |
108 | | int8_t sockindex); |
109 | | |
110 | | #endif /* HEADER_CURL_CONNECT_H */ |