xref: /curl/src/tool_cfgable.h (revision b77d627d)
1 #ifndef HEADER_CURL_TOOL_CFGABLE_H
2 #define HEADER_CURL_TOOL_CFGABLE_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 "tool_setup.h"
27 #include "tool_sdecls.h"
28 #include "tool_urlglob.h"
29 #include "var.h"
30 
31 struct GlobalConfig;
32 
33 struct State {
34   struct getout *urlnode;
35   struct URLGlob *inglob;
36   struct URLGlob *urls;
37   char *outfiles;
38   char *httpgetfields;
39   char *uploadfile;
40   curl_off_t infilenum; /* number of files to upload */
41   curl_off_t up;        /* upload file counter within a single upload glob */
42   curl_off_t urlnum;    /* how many iterations this single URL has with ranges
43                            etc */
44   curl_off_t li;
45 };
46 
47 struct OperationConfig {
48   bool remote_time;
49   char *useragent;
50   struct curl_slist *cookies;  /* cookies to serialize into a single line */
51   char *cookiejar;          /* write to this file */
52   struct curl_slist *cookiefiles;  /* file(s) to load cookies from */
53   char *altsvc;             /* alt-svc cache file name */
54   char *hsts;               /* HSTS cache file name */
55   bool cookiesession;       /* new session? */
56   bool encoding;            /* Accept-Encoding please */
57   bool tr_encoding;         /* Transfer-Encoding please */
58   unsigned long authtype;   /* auth bitmask */
59   bool use_resume;
60   bool resume_from_current;
61   bool disable_epsv;
62   bool disable_eprt;
63   bool ftp_pret;
64   char *proto_str;
65   bool proto_present;
66   char *proto_redir_str;
67   bool proto_redir_present;
68   char *proto_default;
69   curl_off_t resume_from;
70   char *postfields;
71   struct curlx_dynbuf postdata;
72   char *referer;
73   char *query;
74   long timeout_ms;
75   long connecttimeout_ms;
76   long maxredirs;
77   curl_off_t max_filesize;
78   char *output_dir;
79   char *headerfile;
80   char *ftpport;
81   char *iface;
82   long localport;
83   long localportrange;
84   unsigned short porttouse;
85   char *range;
86   long low_speed_limit;
87   long low_speed_time;
88   long ip_tos;         /* IP Type of Service */
89   long vlan_priority;  /* VLAN priority */
90   char *dns_servers;   /* dot notation: 1.1.1.1;2.2.2.2 */
91   char *dns_interface; /* interface name */
92   char *dns_ipv4_addr; /* dot notation */
93   char *dns_ipv6_addr; /* dot notation */
94   char *userpwd;
95   char *login_options;
96   char *tls_username;
97   char *tls_password;
98   char *tls_authtype;
99   char *proxy_tls_username;
100   char *proxy_tls_password;
101   char *proxy_tls_authtype;
102   char *proxyuserpwd;
103   char *proxy;
104   int proxyver;             /* set to CURLPROXY_HTTP* define */
105   char *noproxy;
106   char *mail_from;
107   struct curl_slist *mail_rcpt;
108   char *mail_auth;
109   bool mail_rcpt_allowfails; /* --mail-rcpt-allowfails */
110   char *sasl_authzid;       /* Authorization identity (identity to use) */
111   bool sasl_ir;             /* Enable/disable SASL initial response */
112   bool proxytunnel;
113   bool ftp_append;          /* APPE on ftp */
114   bool use_ascii;           /* select ascii or text transfer */
115   bool autoreferer;         /* automatically set referer */
116   bool failonerror;         /* fail on (HTTP) errors */
117   bool failwithbody;        /* fail on (HTTP) errors but still store body */
118   bool show_headers;        /* show headers to data output */
119   bool no_body;             /* don't get the body */
120   bool dirlistonly;         /* only get the FTP dir list */
121   bool followlocation;      /* follow http redirects */
122   bool unrestricted_auth;   /* Continue to send authentication (user+password)
123                                when following redirects, even when hostname
124                                changed */
125   bool netrc_opt;
126   bool netrc;
127   char *netrc_file;
128   struct getout *url_list;  /* point to the first node */
129   struct getout *url_last;  /* point to the last/current node */
130   struct getout *url_get;   /* point to the node to fill in URL */
131   struct getout *url_out;   /* point to the node to fill in outfile */
132   struct getout *url_ul;    /* point to the node to fill in upload */
133   char *ipfs_gateway;
134   char *doh_url;
135   char *cipher_list;
136   char *proxy_cipher_list;
137   char *cipher13_list;
138   char *proxy_cipher13_list;
139   char *cert;
140   char *proxy_cert;
141   char *cert_type;
142   char *proxy_cert_type;
143   char *cacert;
144   char *proxy_cacert;
145   char *capath;
146   char *proxy_capath;
147   char *crlfile;
148   char *proxy_crlfile;
149   char *pinnedpubkey;
150   char *proxy_pinnedpubkey;
151   char *key;
152   char *proxy_key;
153   char *key_type;
154   char *proxy_key_type;
155   char *key_passwd;
156   char *proxy_key_passwd;
157   char *pubkey;
158   char *hostpubmd5;
159   char *hostpubsha256;
160   char *engine;
161   char *etag_save_file;
162   char *etag_compare_file;
163   bool crlf;
164   char *customrequest;
165   char *ssl_ec_curves;
166   char *krblevel;
167   char *request_target;
168   long httpversion;
169   bool http09_allowed;
170   bool nobuffer;
171   bool readbusy;            /* set when reading input returns EAGAIN */
172   bool globoff;
173   bool use_httpget;
174   bool insecure_ok;         /* set TRUE to allow insecure SSL connects */
175   bool doh_insecure_ok;     /* set TRUE to allow insecure SSL connects
176                                for DoH */
177   bool proxy_insecure_ok;   /* set TRUE to allow insecure SSL connects
178                                for proxy */
179   bool terminal_binary_ok;
180   bool verifystatus;
181   bool doh_verifystatus;
182   bool create_dirs;
183   bool ftp_create_dirs;
184   bool ftp_skip_ip;
185   bool proxynegotiate;
186   bool proxyntlm;
187   bool proxydigest;
188   bool proxybasic;
189   bool proxyanyauth;
190   bool jsoned; /* added json content-type */
191   char *writeout;           /* %-styled format string to output */
192   struct curl_slist *quote;
193   struct curl_slist *postquote;
194   struct curl_slist *prequote;
195   long ssl_version;
196   long ssl_version_max;
197   long proxy_ssl_version;
198   long ip_version;
199   long create_file_mode; /* CURLOPT_NEW_FILE_PERMS */
200   curl_TimeCond timecond;
201   curl_off_t condtime;
202   struct curl_slist *headers;
203   struct curl_slist *proxyheaders;
204   struct tool_mime *mimeroot;
205   struct tool_mime *mimecurrent;
206   curl_mime *mimepost;
207   struct curl_slist *telnet_options;
208   struct curl_slist *resolve;
209   struct curl_slist *connect_to;
210   HttpReq httpreq;
211 
212   /* for bandwidth limiting features: */
213   curl_off_t sendpersecond; /* send to peer */
214   curl_off_t recvpersecond; /* receive from peer */
215 
216   bool ftp_ssl;
217   bool ftp_ssl_reqd;
218   bool ftp_ssl_control;
219   bool ftp_ssl_ccc;
220   int ftp_ssl_ccc_mode;
221   char *preproxy;
222   bool socks5_gssapi_nec;   /* The NEC reference server does not protect the
223                                encryption type exchange */
224   unsigned long socks5_auth;/* auth bitmask for socks5 proxies */
225   char *proxy_service_name; /* set authentication service name for HTTP and
226                                SOCKS5 proxies */
227   char *service_name;       /* set authentication service name for DIGEST-MD5,
228                                Kerberos 5 and SPNEGO */
229 
230   bool tcp_nodelay;
231   bool tcp_fastopen;
232   long req_retry;           /* number of retries */
233   bool retry_all_errors;    /* retry on any error */
234   bool retry_connrefused;   /* set connection refused as a transient error */
235   long retry_delay;         /* delay between retries (in seconds) */
236   long retry_maxtime;       /* maximum time to keep retrying */
237 
238   char *ftp_account;        /* for ACCT */
239   char *ftp_alternative_to_user;  /* send command if USER/PASS fails */
240   int ftp_filemethod;
241   long mime_options;        /* Mime option flags. */
242   long tftp_blksize;        /* TFTP BLKSIZE option */
243   bool tftp_no_options;     /* do not send TFTP options requests */
244   bool ignorecl;            /* --ignore-content-length */
245   bool disable_sessionid;
246 
247   bool raw;
248   bool post301;
249   bool post302;
250   bool post303;
251   bool nokeepalive;         /* for keepalive needs */
252   long alivetime;           /* keepalive-time */
253   long alivecnt;            /* keepalive-cnt */
254   bool content_disposition; /* use Content-disposition filename */
255 
256   int default_node_flags;   /* default flags to search for each 'node', which
257                                is basically each given URL to transfer */
258 
259   bool xattr;               /* store metadata in extended attributes */
260   long gssapi_delegation;
261   bool ssl_allow_beast;     /* allow this SSL vulnerability */
262   bool proxy_ssl_allow_beast; /* allow this SSL vulnerability for proxy */
263   bool ssl_no_revoke;       /* disable SSL certificate revocation checks */
264   bool ssl_revoke_best_effort; /* ignore SSL revocation offline/missing
265                                   revocation list errors */
266 
267   bool native_ca_store;        /* use the native OS CA store */
268   bool proxy_native_ca_store;  /* use the native OS CA store for proxy */
269   bool ssl_auto_client_cert;   /* automatically locate and use a client
270                                   certificate for authentication (Schannel) */
271   bool proxy_ssl_auto_client_cert; /* proxy version of ssl_auto_client_cert */
272   char *oauth_bearer;             /* OAuth 2.0 bearer token */
273   bool noalpn;                    /* enable/disable TLS ALPN extension */
274   char *unix_socket_path;         /* path to Unix domain socket */
275   bool abstract_unix_socket;      /* path to an abstract Unix domain socket */
276   bool falsestart;
277   bool path_as_is;
278   long expect100timeout_ms;
279   bool suppress_connect_headers;  /* suppress proxy CONNECT response headers
280                                      from user callbacks */
281   bool synthetic_error;           /* if TRUE, this is tool-internal error */
282   bool ssh_compression;           /* enable/disable SSH compression */
283   long happy_eyeballs_timeout_ms; /* happy eyeballs timeout in milliseconds.
284                                      0 is valid. default: CURL_HET_DEFAULT. */
285   bool haproxy_protocol;          /* whether to send HAProxy protocol v1 */
286   char *haproxy_clientip;         /* client IP for HAProxy protocol */
287   bool disallow_username_in_url;  /* disallow usernames in URLs */
288   char *aws_sigv4;
289   enum {
290     CLOBBER_DEFAULT, /* Provides compatibility with previous versions of curl,
291                         by using the default behavior for -o, -O, and -J.
292                         If those options would have overwritten files, like
293                         -o and -O would, then overwrite them. In the case of
294                         -J, this will not overwrite any files. */
295     CLOBBER_NEVER, /* If the file exists, always fail */
296     CLOBBER_ALWAYS /* If the file exists, always overwrite it */
297   } file_clobber_mode;
298   bool mptcp;                     /* enable MPTCP support */
299   struct GlobalConfig *global;
300   struct OperationConfig *prev;
301   struct OperationConfig *next;   /* Always last in the struct */
302   struct State state;             /* for create_transfer() */
303   bool rm_partial;                /* on error, remove partially written output
304                                      files */
305 #ifdef USE_ECH
306   char *ech;                      /* Config set by --ech keywords */
307   char *ech_config;               /* Config set by "--ech esl:" option */
308   char *ech_public;               /* Config set by "--ech pn:" option */
309 #endif
310 
311 };
312 
313 struct GlobalConfig {
314   bool showerror;                 /* show errors when silent */
315   bool silent;                    /* don't show messages, --silent given */
316   bool noprogress;                /* don't show progress bar */
317   bool isatty;                    /* Updated internally if output is a tty */
318   char *trace_dump;               /* file to dump the network trace to */
319   FILE *trace_stream;
320   bool trace_fopened;
321   trace tracetype;
322   bool tracetime;                 /* include timestamp? */
323   bool traceids;                  /* include xfer-/conn-id? */
324   int progressmode;               /* CURL_PROGRESS_BAR / CURL_PROGRESS_STATS */
325   char *libcurl;                  /* Output libcurl code to this file name */
326   bool fail_early;                /* exit on first transfer error */
327   bool styled_output;             /* enable fancy output style detection */
328   long ms_per_transfer;           /* start next transfer after (at least) this
329                                      many milliseconds */
330 #ifdef DEBUGBUILD
331   bool test_event_based;
332 #endif
333   bool parallel;
334   unsigned short parallel_max; /* MAX_PARALLEL is the maximum */
335   bool parallel_connect;
336   char *help_category;            /* The help category, if set */
337   struct var *variables;
338   struct OperationConfig *first;
339   struct OperationConfig *current;
340   struct OperationConfig *last;   /* Always last in the struct */
341 };
342 
343 void config_init(struct OperationConfig *config);
344 void config_free(struct OperationConfig *config);
345 
346 #endif /* HEADER_CURL_TOOL_CFGABLE_H */
347