Lines Matching +full:curl +full:- +full:for +full:- +full:win
18 " curl - transfer a URL\n" in hugehelp()
21 " curl [options / URLs]\n" in hugehelp()
24 " curl is a tool for transferring data from or to a server. It supports\n" in hugehelp()
32 " curl offers a busload of useful tricks like proxy support, user authen-\n" in hugehelp()
33 " tication, FTP upload, HTTP post, SSL connections, cookies, file trans-\n" in hugehelp()
39 " curl is powered by libcurl for all transfer-related features. See\n" in hugehelp()
40 " libcurl(3) for details.\n" in hugehelp()
43 " The URL syntax is protocol-dependent. You find a detailed description\n" in hugehelp()
55 " \"ftp://ftp.example.com/file[1-100].txt\"\n" in hugehelp()
57 " \"ftp://ftp.example.com/file[001-100].txt\" (with leading zeros)\n" in hugehelp()
59 " \"ftp://ftp.example.com/file[a-z].txt\"\n" in hugehelp()
64 " \"http://example.com/archive[1996-1999]/vol[1-4]/part{a,b,c}.html\"\n" in hugehelp()
73 " You can specify a step counter for the ranges to get every Nth number\n" in hugehelp()
76 " \"http://example.com/file[1-100:10].txt\"\n" in hugehelp()
78 " \"http://example.com/file[a-z:2].txt\"\n" in hugehelp()
84 " shell from interfering with it. This also goes for other characters\n" in hugehelp()
85 " treated special, like for example '&', '?' and '*'.\n" in hugehelp()
92 " If you specify URL without protocol:// prefix, curl will attempt to\n" in hugehelp()
96 " try other protocols based on often-used host name prefixes. For exam-\n" in hugehelp()
97 " ple, for host names starting with \"ftp.\" curl will assume you want to\n" in hugehelp()
100 " curl will do its best to use what you pass to it as a URL. It is not\n" in hugehelp()
106 " curl will attempt to re-use connections for multiple file transfers, so\n" in hugehelp()
107 " that getting many files from the same server will not do multiple con-\n" in hugehelp()
110 " separate curl invocations.\n" in hugehelp()
113 " If not told otherwise, curl writes the received data to stdout. It can\n" in hugehelp()
117 " -o, --output or -O, --remote-name options. If curl is given multiple\n" in hugehelp()
118 " URLs to transfer on the command line, it similarly needs multiple op-\n" in hugehelp()
119 " tions for where to save them.\n" in hugehelp()
121 " curl does not parse or otherwise \"understand\" the content it gets or\n" in hugehelp()
128 " curl supports numerous protocols, or put in URL terms: schemes. Your\n" in hugehelp()
133 " FILE Read or write local files. curl does not support accessing\n" in hugehelp()
134 " file:// URL remotely, but when running on Microsoft Windows us-\n" in hugehelp()
137 " FTP(S) curl supports the File Transfer Protocol with a lot of tweaks\n" in hugehelp()
146 " curl supports HTTP with numerous options and variations. It can\n" in hugehelp()
147 " speak HTTP version 0.9, 1.0, 1.1, 2 and 3 depending on build op-\n" in hugehelp()
151 " Using the mail reading protocol, curl can \"download\" emails for\n" in hugehelp()
157 " curl can do directory lookups for you, with or without TLS.\n" in hugehelp()
159 " MQTT curl supports MQTT version 3. Downloading over MQTT equals \"sub-\n" in hugehelp()
171 " streaming media and curl can download it.\n" in hugehelp()
173 " RTSP curl supports RTSP 1.0 downloads.\n" in hugehelp()
175 " SCP curl supports SSH version 2 scp transfers.\n" in hugehelp()
177 " SFTP curl supports SFTP (draft 5) done over SSH version 2.\n" in hugehelp()
179 " SMB(S) curl supports SMB version 1 for upload and download.\n" in hugehelp()
187 " TELNET Telling curl to fetch a telnet URL starts an interactive session\n" in hugehelp()
191 " TFTP curl can do TFTP downloads and uploads.\n" in hugehelp()
194 " curl normally displays a progress meter during operations, indicating\n" in hugehelp()
200 " For example 1k is 1024 bytes. 1M is 1048576 bytes.\n" in hugehelp()
202 " curl displays this data to the terminal by default, so if you invoke\n" in hugehelp()
203 " curl to do an operation and it is about to write data to the terminal,\n" in hugehelp()
209 " If you want a progress meter for HTTP POST or PUT requests, you need to\n" in hugehelp()
210 " redirect the response output to a file, using shell redirect (>), -o,\n" in hugehelp()
211 " --output or similar.\n" in hugehelp()
216 " If you prefer a progress \"bar\" instead of the regular meter, -#,\n" in hugehelp()
219 " --progress-bar is your friend. You can also disable the progress meter\n" in hugehelp()
220 " completely with the -s, --silent option.\n" in hugehelp()
226 " The short \"single-dash\" form of the options, -d for example, may be\n" in hugehelp()
228 " is a recommended separator. The long \"double-dash\" form, -d, --data for\n" in hugehelp()
234 " used immediately next to each other, like for example you can specify\n" in hugehelp()
235 " all the options -O, -L and -v at once as -OLv.\n" in hugehelp()
237 " In general, all boolean options are enabled with --option and yet again\n" in hugehelp()
238 " disabled with --no-option. That is, you use the exact same option name\n" in hugehelp()
241 " but prefix it with \"no-\". However, in this list we mostly only list and\n" in hugehelp()
242 " show the --option version of them.\n" in hugehelp()
244 " --abstract-unix-socket <path>\n" in hugehelp()
246 " of using the network. Note: netstat shows the path of an ab-\n" in hugehelp()
253 " curl --abstract-unix-socket socketpath https://example.com\n" in hugehelp()
257 " --alt-svc <file name>\n" in hugehelp()
258 " (HTTPS) This option enables the alt-svc parser in curl. If the\n" in hugehelp()
259 " file name points to an existing alt-svc cache file, that will be\n" in hugehelp()
266 " make curl just handle the cache in memory.\n" in hugehelp()
268 " If this option is used several times, curl will load contents\n" in hugehelp()
269 " from all the files but the last one will be used for saving.\n" in hugehelp()
272 " curl --alt-svc svc.txt https://example.com\n" in hugehelp()
276 " --anyauth\n" in hugehelp()
279 " (HTTP) Tells curl to figure out authentication method by itself,\n" in hugehelp()
281 " This is done by first doing a request and checking the response-\n" in hugehelp()
282 " headers, thus possibly inducing an extra network round-trip.\n" in hugehelp()
284 " method, which you can do with --basic, --digest, --ntlm, and\n" in hugehelp()
287 " --negotiate.\n" in hugehelp()
289 " Using --anyauth is not recommended if you do uploads from stdin,\n" in hugehelp()
294 " Used together with -u, --user.\n" in hugehelp()
297 " curl --anyauth --user me:pwd https://example.com\n" in hugehelp()
301 " See also --proxy-anyauth, --basic and --digest.\n" in hugehelp()
303 " -a, --append\n" in hugehelp()
304 " (FTP SFTP) When used in an upload, this makes curl append to the\n" in hugehelp()
310 " curl --upload-file local --append ftp://example.com/\n" in hugehelp()
314 " --aws-sigv4 <provider1[:provider2[:region[:service]]]>\n" in hugehelp()
321 " of a resources collection (region-code) when the region name is\n" in hugehelp()
326 " The service argument is a string that points to a function pro-\n" in hugehelp()
327 " vided by a cloud (service-code) when the service name is omitted\n" in hugehelp()
331 " curl --aws-sigv4 \"aws:amz:east-2:es\" --user \"key:secret\" https://example.com\n" in hugehelp()
335 " --basic\n" in hugehelp()
336 " (HTTP) Tells curl to use HTTP Basic authentication with the re-\n" in hugehelp()
339 " mote host. This is the default and this option is usually point-\n" in hugehelp()
341 " sets a different authentication method (such as --ntlm, --di-\n" in hugehelp()
342 " gest, or --negotiate).\n" in hugehelp()
344 " Used together with -u, --user.\n" in hugehelp()
347 " curl -u name:password --basic https://example.com\n" in hugehelp()
349 " See also --proxy-basic.\n" in hugehelp()
351 " --cacert <file>\n" in hugehelp()
354 " (TLS) Tells curl to use the specified certificate file to verify\n" in hugehelp()
356 " certificate(s) must be in PEM format. Normally curl is built to\n" in hugehelp()
357 " use a default file for this, so this option is typically used to\n" in hugehelp()
360 " curl recognizes the environment variable named 'CURL_CA_BUNDLE'\n" in hugehelp()
366 " The windows version of curl will automatically look for a CA\n" in hugehelp()
367 " certs file named 'curl-ca-bundle.crt', either in the same direc-\n" in hugehelp()
368 " tory as curl.exe, or in the Current Working Directory, or in any\n" in hugehelp()
371 " If curl is built against the NSS SSL library, the NSS PEM\n" in hugehelp()
374 " PKCS#11 module (libnsspem.so) needs to be available for this op-\n" in hugehelp()
377 " (iOS and macOS only) If curl is built against Secure Transport,\n" in hugehelp()
378 " then this option is supported for backward compatibility with\n" in hugehelp()
380 " not set, then curl will use the certificates in the system and\n" in hugehelp()
386 " (Schannel only) This option is supported for Schannel in Windows\n" in hugehelp()
388 " for backward compatibility with other SSL engines; instead it is\n" in hugehelp()
389 " recommended to use Windows' store of root certificates (the de-\n" in hugehelp()
390 " fault for Schannel).\n" in hugehelp()
397 " curl --cacert CA-file.txt https://example.com\n" in hugehelp()
399 " --capath <dir>\n" in hugehelp()
400 " (TLS) Tells curl to use the specified certificate directory to\n" in hugehelp()
405 " be in PEM format, and if curl is built against OpenSSL, the di-\n" in hugehelp()
406 " rectory must have been processed using the c_rehash utility sup-\n" in hugehelp()
407 " plied with OpenSSL. Using --capath can allow OpenSSL-powered\n" in hugehelp()
408 " curl to make SSL-connections much more efficiently than using\n" in hugehelp()
409 " --cacert if the --cacert file contains many CA certificates.\n" in hugehelp()
417 " curl --capath /local/directory https://example.com\n" in hugehelp()
419 " --cert-status\n" in hugehelp()
420 " (TLS) Tells curl to verify the status of the server certificate\n" in hugehelp()
427 " expired) response, if the response suggests that the server cer-\n" in hugehelp()
435 " curl --cert-status https://example.com\n" in hugehelp()
439 " --cert-type <type>\n" in hugehelp()
442 " (TLS) Tells curl what type the provided client certificate is\n" in hugehelp()
443 " using. PEM, DER, ENG and P12 are recognized types. If not spec-\n" in hugehelp()
449 " curl --cert-type PEM --cert file https://example.com\n" in hugehelp()
451 " See also -E, --cert, --key and --key-type.\n" in hugehelp()
453 " -E, --cert <certificate[:password]>\n" in hugehelp()
456 " (TLS) Tells curl to use the specified client certificate file\n" in hugehelp()
457 " when getting a file with HTTPS, FTPS or another SSL-based proto-\n" in hugehelp()
459 " Transport, or PEM format if using any other engine. If the op-\n" in hugehelp()
460 " tional password is not specified, it will be queried for on the\n" in hugehelp()
465 " See -E, --cert and --key to specify them independently.\n" in hugehelp()
467 " If curl is built against the NSS SSL library then this option\n" in hugehelp()
468 " can tell curl the nickname of the certificate to use within the\n" in hugehelp()
470 " default /etc/pki/nssdb). If the NSS PEM PKCS#11 module (lib-\n" in hugehelp()
477 " that it is not recognized as password delimiter. If the nick-\n" in hugehelp()
483 " If curl is built against OpenSSL library, and the engine pkcs11\n" in hugehelp()
484 " is available, then a PKCS#11 URI (RFC 7512) can be used to spec-\n" in hugehelp()
485 " ify a certificate located in a PKCS#11 device. A string begin-\n" in hugehelp()
487 " PKCS#11 URI is provided, then the --engine option will be set as\n" in hugehelp()
490 " \"pkcs11\" if none was provided and the --cert-type option will be\n" in hugehelp()
493 " (iOS and macOS only) If curl is built against Secure Transport,\n" in hugehelp()
494 " then the certificate string can either be the name of a certifi-\n" in hugehelp()
496 " a PKCS#12-encoded certificate and private key. If you want to\n" in hugehelp()
503 " expression to a certificate store. (Loading PFX is not sup-\n" in hugehelp()
508 " in the system certificates store, for example, \"Curren-\n" in hugehelp()
510 " is usually a SHA-1 hex string which you can see in certificate\n" in hugehelp()
520 " curl --cert certfile --key keyfile https://example.com\n" in hugehelp()
522 " See also --cert-type, --key and --key-type.\n" in hugehelp()
524 " --ciphers <list of ciphers>\n" in hugehelp()
531 " https://curl.se/docs/ssl-ciphers.html\n" in hugehelp()
536 " curl --ciphers ECDHE-ECDSA-AES256-CCM8 https://example.com\n" in hugehelp()
538 " --compressed-ssh\n" in hugehelp()
539 " (SCP SFTP) Enables built-in SSH compression. This is a request,\n" in hugehelp()
543 " curl --compressed-ssh sftp://example.com/\n" in hugehelp()
549 " --compressed\n" in hugehelp()
551 " curl supports, and automatically decompress the content. Headers\n" in hugehelp()
554 " If this option is used and the server sends an unsupported en-\n" in hugehelp()
555 " coding, curl will report an error. This is a request, not an or-\n" in hugehelp()
561 " curl --compressed https://example.com\n" in hugehelp()
563 " -K, --config <file>\n" in hugehelp()
564 " Specify a text file to read curl arguments from. The command\n" in hugehelp()
575 " with one or two dashes, there can be no colon or equals charac-\n" in hugehelp()
583 " \\t, \\n, \\r and \\v. A backslash preceding any other letter is ig-\n" in hugehelp()
593 " Specify the filename to -K, --config as '-' to make curl read\n" in hugehelp()
597 " need to specify it using the --url option, and not by simply\n" in hugehelp()
601 " url = \"https://curl.se/docs/\"\n" in hugehelp()
603 " When curl is invoked, it (unless -q, --disable is used) checks\n" in hugehelp()
606 " for a default config file and uses it if found, even when this\n" in hugehelp()
607 " option is used. The default config file is checked for in the\n" in hugehelp()
617 " 4) Non-windows: use getpwuid to find the home directory\n" in hugehelp()
626 " checks for one in the same dir the curl executable is placed. On\n" in hugehelp()
627 " Unix-like systems, it will simply try to load .curlrc from the\n" in hugehelp()
630 " # --- Example file ---\n" in hugehelp()
636 " user-agent = \"superagent/1.0\"\n" in hugehelp()
640 " -O\n" in hugehelp()
642 " # --- End of example file ---\n" in hugehelp()
648 " curl --config file.txt https://example.com\n" in hugehelp()
652 " --connect-timeout <fractional seconds>\n" in hugehelp()
653 " Maximum time in seconds that you allow curl's connection to\n" in hugehelp()
654 " take. This only limits the connection phase, so if curl con-\n" in hugehelp()
655 " nects within the given period it will continue - if not it will\n" in hugehelp()
662 " curl --connect-timeout 20 https://example.com\n" in hugehelp()
663 " curl --connect-timeout 3.14 https://example.com\n" in hugehelp()
665 " See also -m, --max-time.\n" in hugehelp()
667 " --connect-to <HOST1:PORT1:HOST2:PORT2>\n" in hugehelp()
669 " For a request to the given HOST1:PORT1 pair, connect to\n" in hugehelp()
671 " at a specific server, e.g. at a specific cluster node in a clus-\n" in hugehelp()
674 " ter of servers. This option is only used to establish the net-\n" in hugehelp()
676 " used for TLS/SSL (e.g. SNI, certificate verification) or for the\n" in hugehelp()
686 " numerical such as \"127.0.0.1\" or the full host name such as \"ex-\n" in hugehelp()
692 " curl --connect-to example.com:443:example.net:8443 https://example.com\n" in hugehelp()
696 " See also --resolve and -H, --header. Added in 7.49.0.\n" in hugehelp()
698 " -C, --continue-at <offset>\n" in hugehelp()
703 " FTP server command SIZE will not be used by curl.\n" in hugehelp()
707 " Use \"-C -\" to tell curl to automatically find out where/how to\n" in hugehelp()
714 " curl -C - https://example.com\n" in hugehelp()
715 " curl -C 400 https://example.com\n" in hugehelp()
717 " See also -r, --range.\n" in hugehelp()
719 " -c, --cookie-jar <filename>\n" in hugehelp()
722 " (HTTP) Specify to which file you want curl to write all cookies\n" in hugehelp()
723 " after a completed operation. Curl writes all cookies from its\n" in hugehelp()
724 " in-memory cookie storage to the given file at the end of opera-\n" in hugehelp()
727 " you set the file name to a single dash, \"-\", the cookies will be\n" in hugehelp()
733 " makes curl record and use cookies. Another way to activate it is\n" in hugehelp()
734 " to use the -b, --cookie option.\n" in hugehelp()
737 " curl operation will not fail or even report an error clearly.\n" in hugehelp()
738 " Using -v, --verbose will get a warning displayed, but that is\n" in hugehelp()
748 " curl -c store-here.txt https://example.com\n" in hugehelp()
749 " curl -c store-here.txt -b read-these https://example.com\n" in hugehelp()
751 " -b, --cookie <data|filename>\n" in hugehelp()
756 " \"Set-Cookie:\" line. The data should be in the format\n" in hugehelp()
761 " also activates the cookie engine which will make curl record in-\n" in hugehelp()
764 " coming cookies, which may be handy if you are using this in com-\n" in hugehelp()
765 " bination with the -L, --location option or do multiple URL\n" in hugehelp()
766 " transfers on the same invoke. If the file name is exactly a mi-\n" in hugehelp()
767 " nus (\"-\"), curl will instead read the contents from stdin.\n" in hugehelp()
770 " HTTP headers (Set-Cookie style) or the Netscape/Mozilla cookie\n" in hugehelp()
775 " The file specified with -b, --cookie is only used as input. No\n" in hugehelp()
777 " -c, --cookie-jar option.\n" in hugehelp()
779 " If you use the Set-Cookie file format and do not specify a do-\n" in hugehelp()
781 " match. To address this, set a domain in Set-Cookie line (doing\n" in hugehelp()
784 " that will include sub-domains) or preferably: use the Netscape\n" in hugehelp()
789 " Users often want to both read cookies from a file and write up-\n" in hugehelp()
790 " dated cookies back to a file, so using both -b, --cookie and -c,\n" in hugehelp()
791 " --cookie-jar in the same command line is common.\n" in hugehelp()
794 " curl -b cookiefile https://example.com\n" in hugehelp()
797 " curl -b cookiefile -c cookiefile https://example.com\n" in hugehelp()
799 " --create-dirs\n" in hugehelp()
800 " When used in conjunction with the -o, --output option, curl will\n" in hugehelp()
802 " option creates the directories mentioned with the -o, --output\n" in hugehelp()
803 " option, nothing else. If the --output file name uses no direc-\n" in hugehelp()
804 " tory, or if the directories it mentions already exist, no direc-\n" in hugehelp()
810 " To create remote directories when using FTP or SFTP, try --ftp-\n" in hugehelp()
811 " create-dirs.\n" in hugehelp()
814 " curl --create-dirs --output local/dir/file https://example.com\n" in hugehelp()
816 " --create-file-mode <mode>\n" in hugehelp()
817 " (SFTP SCP FILE) When curl is used to create files remotely using\n" in hugehelp()
829 " curl --create-file-mode 0777 -T localfile sftp://example.com/new\n" in hugehelp()
831 " See also --ftp-create-dirs. Added in 7.75.0.\n" in hugehelp()
835 " --crlf (FTP SMTP) Convert LF to CRLF in upload. Useful for MVS\n" in hugehelp()
841 " curl --crlf -T file ftp://example.com/\n" in hugehelp()
843 " --crlfile <file>\n" in hugehelp()
844 " (TLS) Provide a file using PEM format with a Certificate Revoca-\n" in hugehelp()
845 " tion List that may specify peer certificates that are to be con-\n" in hugehelp()
853 " curl --crlfile rejects.txt https://example.com\n" in hugehelp()
855 " --curves <algorithm list>\n" in hugehelp()
856 " (TLS) Tells curl to request specific curves to use during SSL\n" in hugehelp()
857 " session establishment according to RFC 8422, 5.1. Multiple al-\n" in hugehelp()
861 " \"X25519:P-521\"). The parameter is available identically in the\n" in hugehelp()
864 " --curves allows a OpenSSL powered curl to make SSL-connections\n" in hugehelp()
874 " curl --curves X25519 https://example.com\n" in hugehelp()
878 " --data-ascii <data>\n" in hugehelp()
879 " (HTTP) This is just an alias for -d, --data.\n" in hugehelp()
882 " curl --data-ascii @file https://example.com\n" in hugehelp()
884 " --data-binary <data>\n" in hugehelp()
885 " (HTTP) This posts data exactly as specified with no extra pro-\n" in hugehelp()
891 " filename. Data is posted in a similar manner as -d, --data\n" in hugehelp()
895 " Like -d, --data the default content-type sent to the server is\n" in hugehelp()
896 " application/x-www-form-urlencoded. If you want the data to be\n" in hugehelp()
897 " treated as arbitrary binary data by the server then set the con-\n" in hugehelp()
900 " tent-type to octet-stream: -H \"Content-Type: application/octet-\n" in hugehelp()
904 " first will append data as described in -d, --data.\n" in hugehelp()
907 " curl --data-binary @filename https://example.com\n" in hugehelp()
909 " --data-raw <data>\n" in hugehelp()
910 " (HTTP) This posts data similarly to -d, --data but without the\n" in hugehelp()
916 " curl --data-raw \"hello\" https://example.com\n" in hugehelp()
917 " curl --data-raw \"@at@at@\" https://example.com\n" in hugehelp()
919 " See also -d, --data. Added in 7.43.0.\n" in hugehelp()
921 " --data-urlencode <data>\n" in hugehelp()
922 " (HTTP) This posts data, similar to the other -d, --data options\n" in hugehelp()
923 " with the exception that this performs URL-encoding.\n" in hugehelp()
925 " To be CGI-compliant, the <data> part should begin with a name\n" in hugehelp()
929 " part can be passed to curl using one of the following syntaxes:\n" in hugehelp()
932 " This will make curl URL-encode the content and pass that\n" in hugehelp()
940 " This will make curl URL-encode the content and pass that\n" in hugehelp()
944 " This will make curl URL-encode the content part and pass\n" in hugehelp()
945 " that on. Note that the name part is expected to be URL-\n" in hugehelp()
949 " This will make curl load data from the given file (in-\n" in hugehelp()
952 " cluding any newlines), URL-encode that data and pass it\n" in hugehelp()
956 " This will make curl load data from the given file (in-\n" in hugehelp()
957 " cluding any newlines), URL-encode that data and pass it\n" in hugehelp()
958 " on in the POST. The name part gets an equal sign ap-\n" in hugehelp()
959 " pended, resulting in name=urlencoded-file-content. Note\n" in hugehelp()
962 " that the name is expected to be URL-encoded already.\n" in hugehelp()
965 " curl --data-urlencode name=val https://example.com\n" in hugehelp()
966 " curl --data-urlencode =encodethis https://example.com\n" in hugehelp()
967 " curl --data-urlencode name@file https://example.com\n" in hugehelp()
968 " curl --data-urlencode @fileonly https://example.com\n" in hugehelp()
970 " See also -d, --data and --data-raw.\n" in hugehelp()
972 " -d, --data <data>\n" in hugehelp()
978 " cause curl to pass the data to the server using the content-type\n" in hugehelp()
979 " application/x-www-form-urlencoded. Compare to -F, --form.\n" in hugehelp()
981 " --data-raw is almost the same but does not have a special inter-\n" in hugehelp()
985 " should instead use the --data-binary option. To URL-encode the\n" in hugehelp()
986 " value of a form field you may use --data-urlencode.\n" in hugehelp()
988 " If any of these options is used more than once on the same com-\n" in hugehelp()
990 " with a separating &-symbol. Thus, using '-d name=daniel -d\n" in hugehelp()
997 " file name to read the data from, or - if you want curl to read\n" in hugehelp()
999 " would thus be done with -d, --data @foobar. When -d, --data is\n" in hugehelp()
1000 " told to read from a file like that, carriage returns and new-\n" in hugehelp()
1004 " to have a special interpretation use --data-raw instead.\n" in hugehelp()
1007 " curl -d \"name=curl\" https://example.com\n" in hugehelp()
1008 " curl -d \"name=curl\" -d \"tool=cmdline\" https://example.com\n" in hugehelp()
1009 " curl -d @filename https://example.com\n" in hugehelp()
1011 " See also --data-binary, --data-urlencode and --data-raw. This\n" in hugehelp()
1014 " option overrides -F, --form and -I, --head and -T, --upload-\n" in hugehelp()
1017 " --delegation <LEVEL>\n" in hugehelp()
1023 " policy Delegates if and only if the OK-AS-DELEGATE flag is set\n" in hugehelp()
1034 " curl --delegation \"none\" https://example.com\n" in hugehelp()
1036 " --digest\n" in hugehelp()
1037 " (HTTP) Enables HTTP Digest authentication. This is an authenti-\n" in hugehelp()
1042 " -u, --user option to set user name and password.\n" in hugehelp()
1048 " curl -u name:password --digest https://example.com\n" in hugehelp()
1050 " See also -u, --user, --proxy-digest and --anyauth. This option\n" in hugehelp()
1051 " overrides --basic and --ntlm and --negotiate.\n" in hugehelp()
1053 " --disable-eprt\n" in hugehelp()
1054 " (FTP) Tell curl to disable the use of the EPRT and LPRT commands\n" in hugehelp()
1057 " when doing active FTP transfers. Curl will normally always first\n" in hugehelp()
1059 " option, it will use PORT right away. EPRT and LPRT are exten-\n" in hugehelp()
1066 " --eprt can be used to explicitly enable EPRT again and --no-eprt\n" in hugehelp()
1067 " is an alias for --disable-eprt.\n" in hugehelp()
1073 " switch to passive mode you need to not use -P, --ftp-port or\n" in hugehelp()
1074 " force it with --ftp-pasv.\n" in hugehelp()
1079 " curl --disable-eprt ftp://example.com/\n" in hugehelp()
1081 " --disable-epsv\n" in hugehelp()
1082 " (FTP) Tell curl to disable the use of the EPSV command when do-\n" in hugehelp()
1083 " ing passive FTP transfers. Curl will normally always first at-\n" in hugehelp()
1087 " --epsv can be used to explicitly enable EPSV again and --no-epsv\n" in hugehelp()
1088 " is an alias for --disable-epsv.\n" in hugehelp()
1096 " switch to active mode you need to use -P, --ftp-port.\n" in hugehelp()
1099 " curl --disable-epsv ftp://example.com/\n" in hugehelp()
1101 " -q, --disable\n" in hugehelp()
1105 " config file will not be read and used. See the -K, --config for\n" in hugehelp()
1109 " curl -q https://example.com\n" in hugehelp()
1111 " --disallow-username-in-url\n" in hugehelp()
1112 " (HTTP) This tells curl to exit if passed a url containing a\n" in hugehelp()
1114 " provided at run-time or similar.\n" in hugehelp()
1119 " curl --disallow-username-in-url https://example.com\n" in hugehelp()
1121 " See also --proto. Added in 7.61.0.\n" in hugehelp()
1123 " --dns-interface <interface>\n" in hugehelp()
1124 " (DNS) Tell curl to send outgoing DNS requests through <inter-\n" in hugehelp()
1125 " face>. This option is a counterpart to --interface (which does\n" in hugehelp()
1132 " curl --dns-interface eth0 https://example.com\n" in hugehelp()
1134 " See also --dns-ipv4-addr and --dns-ipv6-addr. --dns-interface\n" in hugehelp()
1135 " requires that the underlying libcurl was built to support c-\n" in hugehelp()
1138 " --dns-ipv4-addr <address>\n" in hugehelp()
1139 " (DNS) Tell curl to bind to <ip-address> when making IPv4 DNS re-\n" in hugehelp()
1148 " curl --dns-ipv4-addr 10.1.2.3 https://example.com\n" in hugehelp()
1150 " See also --dns-interface and --dns-ipv6-addr. --dns-ipv4-addr\n" in hugehelp()
1151 " requires that the underlying libcurl was built to support c-\n" in hugehelp()
1154 " --dns-ipv6-addr <address>\n" in hugehelp()
1157 " (DNS) Tell curl to bind to <ip-address> when making IPv6 DNS re-\n" in hugehelp()
1164 " curl --dns-ipv6-addr 2a04:4e42::561 https://example.com\n" in hugehelp()
1166 " See also --dns-interface and --dns-ipv4-addr. --dns-ipv6-addr\n" in hugehelp()
1169 " requires that the underlying libcurl was built to support c-\n" in hugehelp()
1172 " --dns-servers <addresses>\n" in hugehelp()
1173 " Set the list of DNS servers to be used instead of the system de-\n" in hugehelp()
1174 " fault. The list of IP addresses should be separated with com-\n" in hugehelp()
1175 " mas. Port numbers may also optionally be given as :<port-number>\n" in hugehelp()
1183 " curl --dns-servers 192.168.0.1,192.168.0.2 https://example.com\n" in hugehelp()
1185 " --dns-servers requires that the underlying libcurl was built to\n" in hugehelp()
1186 " support c-ares. Added in 7.33.0.\n" in hugehelp()
1188 " --doh-cert-status\n" in hugehelp()
1189 " (all) Same as --cert-status but used for DoH (DNS-over-HTTPS).\n" in hugehelp()
1194 " curl --doh-cert-status --doh-url https://doh.example https://example.com\n" in hugehelp()
1198 " --doh-insecure\n" in hugehelp()
1199 " (all) Same as -k, --insecure but used for DoH (DNS-over-HTTPS).\n" in hugehelp()
1202 " curl --doh-insecure --doh-url https://doh.example https://example.com\n" in hugehelp()
1206 " --doh-url <URL>\n" in hugehelp()
1207 " (all) Specifies which DNS-over-HTTPS (DoH) server to use to re-\n" in hugehelp()
1213 " Some SSL options that you set for your transfer will apply to\n" in hugehelp()
1216 " controlled separately via --doh-insecure and --doh-cert-status.\n" in hugehelp()
1223 " curl --doh-url https://doh.example https://example.com\n" in hugehelp()
1227 " -D, --dump-header <filename>\n" in hugehelp()
1240 " curl --dump-header store.txt https://example.com\n" in hugehelp()
1242 " See also -o, --output.\n" in hugehelp()
1244 " --egd-file <file>\n" in hugehelp()
1248 " socket. The socket is used to seed the random engine for SSL\n" in hugehelp()
1252 " curl --egd-file /random/here https://example.com\n" in hugehelp()
1254 " See also --random-file.\n" in hugehelp()
1256 " --engine <name>\n" in hugehelp()
1257 " (TLS) Select the OpenSSL crypto engine to use for cipher opera-\n" in hugehelp()
1258 " tions. Use --engine list to print a list of build-time supported\n" in hugehelp()
1262 " may be available at run-time.\n" in hugehelp()
1265 " curl --engine flavor https://example.com\n" in hugehelp()
1267 " --etag-compare <file>\n" in hugehelp()
1268 " (HTTP) This option makes a conditional HTTP request for the spe-\n" in hugehelp()
1269 " cific ETag read from the given file by sending a custom If-None-\n" in hugehelp()
1272 " For correct results, make sure that the specified file contains\n" in hugehelp()
1278 " Use the option --etag-save to first save the ETag from a re-\n" in hugehelp()
1283 " curl --etag-compare etag.txt https://example.com\n" in hugehelp()
1287 " --etag-save <file>\n" in hugehelp()
1291 " ETag is a caching related header, usually returned in a re-\n" in hugehelp()
1297 " curl --etag-save storetag.txt https://example.com\n" in hugehelp()
1301 " --expect100-timeout <seconds>\n" in hugehelp()
1302 " (HTTP) Maximum time in seconds that you allow curl to wait for a\n" in hugehelp()
1305 " 100-continue response when curl emits an Expects: 100-continue\n" in hugehelp()
1306 " header in its request. By default curl will wait one second.\n" in hugehelp()
1307 " This option accepts decimal values! When curl stops waiting, it\n" in hugehelp()
1311 " curl --expect100-timeout 2.5 -T file https://example.com\n" in hugehelp()
1313 " See also --connect-timeout. Added in 7.47.0.\n" in hugehelp()
1315 " --fail-early\n" in hugehelp()
1320 " When curl is used to do multiple transfers on the command line,\n" in hugehelp()
1321 " it will attempt to operate on each given URL, one by one. By de-\n" in hugehelp()
1323 " the last URL's success will determine the error code curl re-\n" in hugehelp()
1324 " turns. So early failures will be \"hidden\" by subsequent success-\n" in hugehelp()
1329 " Using this option, curl will instead return an error on the\n" in hugehelp()
1331 " that are given on the command line. This way, no transfer fail-\n" in hugehelp()
1334 " This option is global and does not need to be specified for each\n" in hugehelp()
1335 " use of -:, --next.\n" in hugehelp()
1337 " This option does not imply -f, --fail, which causes transfers to\n" in hugehelp()
1341 " two options, however note -f, --fail is not global and is there-\n" in hugehelp()
1342 " fore contained by -:, --next.\n" in hugehelp()
1345 " curl --fail-early https://example.com https://two.example\n" in hugehelp()
1348 " --fail-with-body\n" in hugehelp()
1355 " still allow curl to output and save that content but also to re-\n" in hugehelp()
1358 " This is an alternative option to -f, --fail which makes curl\n" in hugehelp()
1361 " fail for the same circumstances but without saving the content.\n" in hugehelp()
1364 " curl --fail-with-body https://example.com\n" in hugehelp()
1366 " See also -f, --fail. Added in 7.76.0.\n" in hugehelp()
1368 " -f, --fail\n" in hugehelp()
1375 " also describes why and more). This flag will prevent curl from\n" in hugehelp()
1378 " This method is not fail-safe and there are occasions where non-\n" in hugehelp()
1379 " successful response codes will slip through, especially when au-\n" in hugehelp()
1385 " curl --fail https://example.com\n" in hugehelp()
1387 " See also --fail-with-body.\n" in hugehelp()
1389 " --false-start\n" in hugehelp()
1390 " (TLS) Tells curl to use false start during the TLS handshake.\n" in hugehelp()
1391 " False start is a mode where a TLS client will start sending ap-\n" in hugehelp()
1397 " This is currently only implemented in the NSS and Secure Trans-\n" in hugehelp()
1401 " curl --false-start https://example.com\n" in hugehelp()
1405 " --form-string <name=string>\n" in hugehelp()
1406 " (HTTP SMTP IMAP) Similar to -F, --form except that the value\n" in hugehelp()
1407 " string for the named parameter is used literally. Leading '@'\n" in hugehelp()
1411 " special meaning. Use this in preference to -F, --form if there's\n" in hugehelp()
1413 " the '@' or '<' features of -F, --form.\n" in hugehelp()
1416 " curl --form-string \"data\" https://example.com\n" in hugehelp()
1418 " See also -F, --form.\n" in hugehelp()
1420 " -F, --form <name=content>\n" in hugehelp()
1423 " (HTTP SMTP IMAP) For HTTP protocol family, this lets curl emu-\n" in hugehelp()
1424 " late a filled-in form in which a user has pressed the submit\n" in hugehelp()
1425 " button. This causes curl to POST data using the Content-Type\n" in hugehelp()
1426 " multipart/form-data according to RFC 2388.\n" in hugehelp()
1428 " For SMTP and IMAP protocols, this is the means to compose a mul-\n" in hugehelp()
1433 " This enables uploading of binary files etc. To force the 'con-\n" in hugehelp()
1438 " the < makes a text field and just get the contents for that text\n" in hugehelp()
1443 " Tell curl to read content from stdin instead of a file by using\n" in hugehelp()
1444 " - as filename. This goes for both @ and < constructs. When stdin\n" in hugehelp()
1445 " is used, the contents is buffered in memory first by curl to de-\n" in hugehelp()
1447 " data from a named non-regular file (such as a named pipe or sim-\n" in hugehelp()
1450 " ilar) is unfortunately not subject to buffering and will be ef-\n" in hugehelp()
1451 " fectively read at transmission time; since the full size is un-\n" in hugehelp()
1456 " name of the form-field to which the file portrait.jpg will be\n" in hugehelp()
1461 " curl -F profile=@portrait.jpg https://example.com/upload.cgi\n" in hugehelp()
1466 " curl -F name=John -F shoesize=11 https://example.com/\n" in hugehelp()
1469 " as a plain text field, but get the contents for it from a local\n" in hugehelp()
1472 " curl -F \"story=<hugefile.txt\" https://example.com/\n" in hugehelp()
1476 " You can also tell curl what Content-Type to use by using\n" in hugehelp()
1479 " curl -F \"web=@index.html;type=text/html\" example.com\n" in hugehelp()
1483 " curl -F \"name=daniel;type=text/foo\" example.com\n" in hugehelp()
1488 " curl -F \"file=@localfile;filename=nameinpost\" example.com\n" in hugehelp()
1492 " If filename/path contains ',' or ';', it must be quoted by dou-\n" in hugehelp()
1493 " ble-quotes like:\n" in hugehelp()
1495 " curl -F \"file=@\\\"local,file\\\";filename=\\\"name;in;post\\\"\" exam-\n" in hugehelp()
1500 " curl -F 'file=@\"local,file\";filename=\"name;in;post\"' exam-\n" in hugehelp()
1503 " Note that if a filename/path is quoted by double-quotes, any\n" in hugehelp()
1504 " double-quote or backslash within the filename must be escaped by\n" in hugehelp()
1509 " Quoting must also be applied to non-file data if it contains\n" in hugehelp()
1512 " curl -F 'colors=\"red; green; blue\";type=text/x-myapp' exam-\n" in hugehelp()
1518 " curl -F \"submit=OK;headers=\\\"X-submit-type: OK\\\"\" example.com\n" in hugehelp()
1524 " curl -F \"submit=OK;headers=@headerfile\" example.com\n" in hugehelp()
1530 " the continuation line with a space; embedded carriage-returns\n" in hugehelp()
1537 " X-header-1: this is a header\n" in hugehelp()
1540 " X-header-2: this is\n" in hugehelp()
1543 " To support sending multipart mail messages, the syntax is ex-\n" in hugehelp()
1547 " - name can be omitted: the equal sign is the first character of\n" in hugehelp()
1549 " - if data starts with '(', this signals to start a new multi-\n" in hugehelp()
1551 " - a multipart can be terminated with a '=)' argument.\n" in hugehelp()
1553 " Example: the following command sends an SMTP mime e-mail con-\n" in hugehelp()
1559 " curl -F '=(;type=multipart/alternative' \\\n" in hugehelp()
1560 " -F '=plain text message' \\\n" in hugehelp()
1561 " -F '= <body>HTML message</body>;type=text/html' \\\n" in hugehelp()
1562 " -F '=)' -F '=@textfile.txt' ... smtp://example.com\n" in hugehelp()
1564 " Data can be encoded for transfer using encoder=. Available en-\n" in hugehelp()
1568 " corresponding Content-Transfer-Encoding header, 7bit that only\n" in hugehelp()
1569 " rejects 8-bit characters with a transfer error, quoted-printable\n" in hugehelp()
1573 " Example: send multipart mail with a quoted-printable text mes-\n" in hugehelp()
1576 " curl -F '=text message;encoder=quoted-printable' \\\n" in hugehelp()
1579 " -F '=@localfile;encoder=base64' ... smtp://example.com\n" in hugehelp()
1586 " curl --form \"name=curl\" --form \"file=@loadthis\" https://example.com\n" in hugehelp()
1588 " This option overrides -d, --data and -I, --head and -T, --up-\n" in hugehelp()
1589 " load-file.\n" in hugehelp()
1591 " --ftp-account <data>\n" in hugehelp()
1594 " (FTP) When an FTP server asks for \"account data\" after user name\n" in hugehelp()
1601 " curl --ftp-account \"mr.robot\" ftp://example.com/\n" in hugehelp()
1603 " --ftp-alternative-to-user <command>\n" in hugehelp()
1613 " curl --ftp-alternative-to-user \"U53r\" ftp://example.com\n" in hugehelp()
1615 " --ftp-create-dirs\n" in hugehelp()
1620 " curl is to fail. Using this option, curl will instead attempt to\n" in hugehelp()
1624 " curl --ftp-create-dirs -T file ftp://example.com/remote/path/file\n" in hugehelp()
1626 " See also --create-dirs.\n" in hugehelp()
1628 " --ftp-method <method>\n" in hugehelp()
1629 " (FTP) Control what method curl should use to reach a file on an\n" in hugehelp()
1632 " FTP(S) server. The method argument should be one of the follow-\n" in hugehelp()
1636 " curl does a single CWD operation for each path part in\n" in hugehelp()
1637 " the given URL. For deep hierarchies this means many com-\n" in hugehelp()
1643 " nocwd curl does no CWD at all. curl will do SIZE, RETR, STOR\n" in hugehelp()
1644 " etc and give a full path to the server for all these com-\n" in hugehelp()
1648 " curl does one CWD with the full target directory and then\n" in hugehelp()
1656 " curl --ftp-method multicwd ftp://example.com/dir1/dir2/file\n" in hugehelp()
1657 " curl --ftp-method nocwd ftp://example.com/dir1/dir2/file\n" in hugehelp()
1658 " curl --ftp-method singlecwd ftp://example.com/dir1/dir2/file\n" in hugehelp()
1660 " --ftp-pasv\n" in hugehelp()
1661 " (FTP) Use passive mode for the data connection. Passive is the\n" in hugehelp()
1665 " override a previous -P, --ftp-port option.\n" in hugehelp()
1669 " must then instead enforce the correct -P, --ftp-port again.\n" in hugehelp()
1671 " Passive mode means that curl will try the EPSV command first and\n" in hugehelp()
1672 " then PASV, unless --disable-epsv is used.\n" in hugehelp()
1675 " curl --ftp-pasv ftp://example.com/\n" in hugehelp()
1679 " See also --disable-epsv.\n" in hugehelp()
1680 " -P, --ftp-port <address>\n" in hugehelp()
1681 " (FTP) Reverses the default initiator/listener roles when con-\n" in hugehelp()
1682 " necting with FTP. This option makes curl use active mode. curl\n" in hugehelp()
1685 " IP address and port for it to connect to. <address> should be\n" in hugehelp()
1700 " - make curl pick the same IP address that is already used\n" in hugehelp()
1701 " for the control connection\n" in hugehelp()
1705 " If this option is used several times, the last one will be used. Dis-\n" in hugehelp()
1706 " able the use of PORT with --ftp-pasv. Disable the attempt to use the\n" in hugehelp()
1707 " EPRT command instead of PORT by using --disable-eprt. EPRT is really\n" in hugehelp()
1710 " You can also append \":[start]-[end]\" to the right of the address, to\n" in hugehelp()
1711 " tell curl what TCP port range to use. That means you specify a port\n" in hugehelp()
1719 " curl -P - ftp:/example.com\n" in hugehelp()
1720 " curl -P eth0 ftp:/example.com\n" in hugehelp()
1721 " curl -P 192.168.0.2 ftp:/example.com\n" in hugehelp()
1723 " See also --ftp-pasv and --disable-eprt.\n" in hugehelp()
1725 " --ftp-pret\n" in hugehelp()
1726 " (FTP) Tell curl to send a PRET command before PASV (and EPSV).\n" in hugehelp()
1727 " Certain FTP servers, mainly drftpd, require this non-standard\n" in hugehelp()
1730 " command for directory listings as well as up and downloads in\n" in hugehelp()
1734 " curl --ftp-pret ftp://example.com/\n" in hugehelp()
1736 " --ftp-skip-pasv-ip\n" in hugehelp()
1737 " (FTP) Tell curl to not use the IP address the server suggests in\n" in hugehelp()
1738 " its response to curl's PASV command when curl connects the data\n" in hugehelp()
1739 " connection. Instead curl will re-use the same IP address it al-\n" in hugehelp()
1740 " ready uses for the control connection.\n" in hugehelp()
1744 " Since curl 7.74.0 this option is enabled by default.\n" in hugehelp()
1749 " curl --ftp-skip-pasv-ip ftp://example.com/\n" in hugehelp()
1751 " See also --ftp-pasv.\n" in hugehelp()
1753 " --ftp-ssl-ccc-mode <active/passive>\n" in hugehelp()
1755 " shutdown, but instead wait for the server to do it, and will not\n" in hugehelp()
1759 " the shutdown and waits for a reply from the server.\n" in hugehelp()
1762 " curl --ftp-ssl-ccc-mode active --ftp-ssl-ccc ftps://example.com/\n" in hugehelp()
1764 " See also --ftp-ssl-ccc.\n" in hugehelp()
1766 " --ftp-ssl-ccc\n" in hugehelp()
1768 " layer after authenticating. The rest of the control channel com-\n" in hugehelp()
1771 " munication will be unencrypted. This allows NAT routers to fol-\n" in hugehelp()
1775 " curl --ftp-ssl-ccc ftps://example.com/\n" in hugehelp()
1776 " See also --ssl and --ftp-ssl-ccc-mode.\n" in hugehelp()
1778 " --ftp-ssl-control\n" in hugehelp()
1779 " (FTP) Require SSL/TLS for the FTP login, clear for transfer.\n" in hugehelp()
1780 " Allows secure authentication, but non-encrypted data transfers\n" in hugehelp()
1783 " for efficiency. Fails the transfer if the server does not sup-\n" in hugehelp()
1787 " curl --ftp-ssl-control ftp://example.com\n" in hugehelp()
1789 " -G, --get\n" in hugehelp()
1790 " When used, this option will make all data specified with -d,\n" in hugehelp()
1791 " --data, --data-binary or --data-urlencode to be used in an HTTP\n" in hugehelp()
1796 " If used in combination with -I, --head, the POST data will in-\n" in hugehelp()
1806 " curl --get https://example.com\n" in hugehelp()
1807 " curl --get -d \"tool=curl\" -d \"age=old\" https://example.com\n" in hugehelp()
1808 " curl --get -I -d \"tool=curl\" https://example.com\n" in hugehelp()
1810 " -g, --globoff\n" in hugehelp()
1813 " without having curl itself interpret them. Note that these let-\n" in hugehelp()
1816 " ters are not normal legal URL contents but they should be en-\n" in hugehelp()
1820 " curl -g \"https://example.com/{[]}}}}\"\n" in hugehelp()
1822 " --happy-eyeballs-timeout-ms <milliseconds>\n" in hugehelp()
1824 " IPv4 and IPv6 addresses for dual-stack hosts, giving IPv6 a\n" in hugehelp()
1825 " head-start of the specified number of milliseconds. If the IPv6\n" in hugehelp()
1828 " address cannot be connected to within that time, then a connec-\n" in hugehelp()
1834 " paced 150-250 ms apart to balance human factors against network\n" in hugehelp()
1843 " curl --happy-eyeballs-timeout-ms 500 https://example.com\n" in hugehelp()
1847 " --haproxy-protocol\n" in hugehelp()
1851 " of the connection. This is used by some load balancers and re-\n" in hugehelp()
1857 " curl --haproxy-protocol https://example.com\n" in hugehelp()
1861 " -I, --head\n" in hugehelp()
1862 " (HTTP FTP FILE) Fetch the headers only! HTTP-servers feature the\n" in hugehelp()
1866 " document. When used on an FTP or FILE file, curl displays the\n" in hugehelp()
1870 " curl -I https://example.com\n" in hugehelp()
1871 " -H, --header <header/@file>\n" in hugehelp()
1877 " one of the internal ones curl would use, your externally set\n" in hugehelp()
1879 " to make even trickier stuff than curl would normally do. You\n" in hugehelp()
1880 " should not replace internally set headers without knowing per-\n" in hugehelp()
1885 " colon, as in: -H \"Host:\". If you send the custom header with no-\n" in hugehelp()
1887 " as -H \"X-Custom-Header;\" to send \"X-Custom-Header:\".\n" in hugehelp()
1889 " curl will make sure that each header you add/replace is sent\n" in hugehelp()
1890 " with the proper end-of-line marker, you should thus not add that\n" in hugehelp()
1894 " returns, they will only mess things up for you.\n" in hugehelp()
1897 " adds a header for each line in the input file. Using @- will\n" in hugehelp()
1898 " make curl read the header file from stdin. Added in 7.55.0.\n" in hugehelp()
1900 " You need --proxy-header to send custom headers intended for a\n" in hugehelp()
1905 " Passing on a \"Transfer-Encoding: chunked\" header when doing a\n" in hugehelp()
1906 " HTTP request with a request body, will make curl send the data\n" in hugehelp()
1909 " WARNING: headers set with this option will be set in all re-\n" in hugehelp()
1910 " quests - even after redirects are followed, like when told with\n" in hugehelp()
1911 " -L, --location. This can lead to the header being sent to other\n" in hugehelp()
1921 " curl -H \"X-First-Name: Joe\" https://example.com\n" in hugehelp()
1922 " curl -H \"User-Agent: yes-please/2000\" https://example.com\n" in hugehelp()
1923 " curl -H \"Host:\" https://example.com\n" in hugehelp()
1927 " See also -A, --user-agent and -e, --referer.\n" in hugehelp()
1929 " -h, --help <category>\n" in hugehelp()
1931 " arg was provided, curl will display the most important command\n" in hugehelp()
1932 " line arguments. If the argument \"all\" was provided, curl will\n" in hugehelp()
1934 " provided, curl will display all categories and their meanings.\n" in hugehelp()
1939 " curl --help all\n" in hugehelp()
1941 " --hostpubmd5 <md5>\n" in hugehelp()
1944 " public key, curl will refuse the connection with the host unless\n" in hugehelp()
1948 " curl --hostpubmd5 e5c1c49020640a5ab0f2034854c321a8 sftp://example.com/\n" in hugehelp()
1950 " --hostpubsha256 <sha256>\n" in hugehelp()
1953 " (SFTP SCP) Pass a string containing a Base64-encoded SHA256 hash\n" in hugehelp()
1954 " of the remote host's public key. Curl will refuse the connection\n" in hugehelp()
1958 " curl --hostpubsha256 NDVkMTQxMGQ1ODdmMjQ3MjczYjAyOTY5MmRkMjVmNDQ= sftp://example.co… in hugehelp()
1962 " --hsts <file name>\n" in hugehelp()
1963 " (HTTPS) This option enables HSTS for the transfer. If the file\n" in hugehelp()
1971 " make curl just handle HSTS in memory.\n" in hugehelp()
1973 " If this option is used several times, curl will load contents\n" in hugehelp()
1974 " from all the files but the last one will be used for saving.\n" in hugehelp()
1979 " curl --hsts cache.txt https://example.com\n" in hugehelp()
1983 " --http0.9\n" in hugehelp()
1984 " (HTTP) Tells curl to be fine with HTTP version 0.9 response.\n" in hugehelp()
1987 " can also connect with this to non-HTTP servers and still get a\n" in hugehelp()
1988 " response since curl will simply transparently downgrade - if al-\n" in hugehelp()
1993 " Since curl 7.66.0, HTTP/0.9 is disabled by default.\n" in hugehelp()
1996 " curl --http0.9 https://example.com\n" in hugehelp()
2000 " -0, --http1.0\n" in hugehelp()
2001 " (HTTP) Tells curl to use HTTP version 1.0 instead of using its\n" in hugehelp()
2005 " curl --http1.0 https://example.com\n" in hugehelp()
2007 " This option overrides --http1.1 and --http2.\n" in hugehelp()
2009 " --http1.1\n" in hugehelp()
2012 " (HTTP) Tells curl to use HTTP version 1.1.\n" in hugehelp()
2015 " curl --http1.1 https://example.com\n" in hugehelp()
2017 " This option overrides -0, --http1.0 and --http2. Added in\n" in hugehelp()
2020 " --http2-prior-knowledge\n" in hugehelp()
2021 " (HTTP) Tells curl to issue its non-TLS HTTP requests using\n" in hugehelp()
2030 " curl --http2-prior-knowledge https://example.com\n" in hugehelp()
2032 " --http2-prior-knowledge requires that the underlying libcurl was\n" in hugehelp()
2033 " built to support HTTP/2. This option overrides --http1.1 and -0,\n" in hugehelp()
2036 " --http1.0 and --http2. Added in 7.49.0.\n" in hugehelp()
2038 " --http2\n" in hugehelp()
2039 " (HTTP) Tells curl to use HTTP version 2.\n" in hugehelp()
2041 " For HTTPS, this means curl will attempt to negotiate HTTP/2 in\n" in hugehelp()
2042 " the TLS handshake. curl does this by default.\n" in hugehelp()
2044 " For HTTP, this means curl will attempt to upgrade the request to\n" in hugehelp()
2048 " curl --http2 https://example.com\n" in hugehelp()
2052 " See also --http1.1 and --http3. --http2 requires that the under-\n" in hugehelp()
2054 " --http1.1 and -0, --http1.0 and --http2-prior-knowledge. Added\n" in hugehelp()
2057 " --http3\n" in hugehelp()
2058 " (HTTP) WARNING: this option is experimental. Do not use in pro-\n" in hugehelp()
2061 " Tells curl to use HTTP version 3 directly to the host and port\n" in hugehelp()
2065 " to a host and then get redirected via Alt-Svc, but this option\n" in hugehelp()
2069 " This option will make curl fail if a QUIC connection cannot be\n" in hugehelp()
2076 " curl --http3 https://example.com\n" in hugehelp()
2078 " See also --http1.1 and --http2. --http3 requires that the under-\n" in hugehelp()
2080 " --http1.1 and -0, --http1.0 and --http2 and --http2-prior-knowl-\n" in hugehelp()
2083 " --ignore-content-length\n" in hugehelp()
2084 " (FTP HTTP) For HTTP, Ignore the Content-Length header. This is\n" in hugehelp()
2087 " particularly useful for servers running Apache 1.x, which will\n" in hugehelp()
2088 " report incorrect Content-Length for files larger than 2 giga-\n" in hugehelp()
2091 " For FTP (since 7.46.0), skip the RETR command to figure out the\n" in hugehelp()
2094 " This option does not work for HTTP if libcurl was built to use\n" in hugehelp()
2098 " curl --ignore-content-length https://example.com\n" in hugehelp()
2102 " -i, --include\n" in hugehelp()
2103 " Include the HTTP response headers in the output. The HTTP re-\n" in hugehelp()
2107 " To view the request headers, consider the -v, --verbose option.\n" in hugehelp()
2110 " curl -i https://example.com\n" in hugehelp()
2112 " See also -v, --verbose.\n" in hugehelp()
2114 " -k, --insecure\n" in hugehelp()
2117 " (TLS) By default, every SSL connection curl makes is verified to\n" in hugehelp()
2118 " be secure. This option allows curl to proceed and operate even\n" in hugehelp()
2119 " for server connections otherwise considered insecure.\n" in hugehelp()
2125 " See this online resource for further details:\n" in hugehelp()
2128 " https://curl.se/docs/sslcerts.html\n" in hugehelp()
2133 " curl --insecure https://example.com\n" in hugehelp()
2135 " See also --proxy-insecure and --cacert.\n" in hugehelp()
2137 " --interface <name>\n" in hugehelp()
2144 " curl --interface eth0:1 https://www.example.com/\n" in hugehelp()
2148 " to either have CAP_NET_RAW or to be run as root. More informa-\n" in hugehelp()
2149 " tion about Linux VRF: https://www.kernel.org/doc/Documenta-\n" in hugehelp()
2153 " curl --interface eth0 https://example.com\n" in hugehelp()
2157 " See also --dns-interface.\n" in hugehelp()
2159 " -4, --ipv4\n" in hugehelp()
2160 " This option tells curl to resolve names to IPv4 addresses only,\n" in hugehelp()
2161 " and not for example try IPv6.\n" in hugehelp()
2164 " curl --ipv4 https://example.com\n" in hugehelp()
2166 " See also --http1.1 and --http2. This option overrides -6,\n" in hugehelp()
2167 " --ipv6.\n" in hugehelp()
2169 " -6, --ipv6\n" in hugehelp()
2170 " This option tells curl to resolve names to IPv6 addresses only,\n" in hugehelp()
2171 " and not for example try IPv4.\n" in hugehelp()
2176 " curl --ipv6 https://example.com\n" in hugehelp()
2178 " See also --http1.1 and --http2. This option overrides -4,\n" in hugehelp()
2179 " --ipv4.\n" in hugehelp()
2181 " -j, --junk-session-cookies\n" in hugehelp()
2182 " (HTTP) When curl is told to read cookies from a given file, this\n" in hugehelp()
2183 " option will make it discard all \"session cookies\". This will ba-\n" in hugehelp()
2191 " curl --junk-session-cookies -b cookies.txt https://example.com\n" in hugehelp()
2193 " See also -b, --cookie and -c, --cookie-jar.\n" in hugehelp()
2195 " --keepalive-time <seconds>\n" in hugehelp()
2196 " This option sets the time a connection needs to remain idle be-\n" in hugehelp()
2202 " (meaning Linux, recent AIX, HP-UX and more). This option has no\n" in hugehelp()
2203 " effect if --no-keepalive is used.\n" in hugehelp()
2211 " curl --keepalive-time 20 https://example.com\n" in hugehelp()
2213 " --key-type <type>\n" in hugehelp()
2214 " (TLS) Private key file type. Specify which type your --key pro-\n" in hugehelp()
2221 " curl --key-type DER --key here https://example.com\n" in hugehelp()
2223 " --key <key>\n" in hugehelp()
2226 " (TLS SSH) Private key file name. Allows you to provide your pri-\n" in hugehelp()
2227 " vate key in this separate file. For SSH, if not specified, curl\n" in hugehelp()
2231 " If curl is built against OpenSSL library, and the engine pkcs11\n" in hugehelp()
2232 " is available, then a PKCS#11 URI (RFC 7512) can be used to spec-\n" in hugehelp()
2235 " ify a private key located in a PKCS#11 device. A string begin-\n" in hugehelp()
2237 " PKCS#11 URI is provided, then the --engine option will be set as\n" in hugehelp()
2238 " \"pkcs11\" if none was provided and the --key-type option will be\n" in hugehelp()
2246 " curl --cert certificate --key here https://example.com\n" in hugehelp()
2248 " --krb <level>\n" in hugehelp()
2259 " curl --krb clear ftp://example.com/\n" in hugehelp()
2261 " --krb requires that the underlying libcurl was built to support\n" in hugehelp()
2264 " --libcurl <file>\n" in hugehelp()
2265 " Append this option to any ordinary curl command line, and you\n" in hugehelp()
2266 " will get libcurl-using C source code written to the file that\n" in hugehelp()
2267 " does the equivalent of what your command-line operation does!\n" in hugehelp()
2269 " This option is global and does not need to be specified for each\n" in hugehelp()
2272 " use of -:, --next.\n" in hugehelp()
2278 " curl --libcurl client.c https://example.com\n" in hugehelp()
2280 " --limit-rate <speed>\n" in hugehelp()
2281 " Specify the maximum transfer rate you want curl to use - for\n" in hugehelp()
2289 " appended. Appending 'k' or 'K' will count the number as kilo-\n" in hugehelp()
2291 " gigabytes. The suffixes (k, M, G, T, P) are 1024 based. For ex-\n" in hugehelp()
2297 " no more than the set threshold over a period of multiple sec-\n" in hugehelp()
2300 " If you also use the -Y, --speed-limit option, that option will\n" in hugehelp()
2301 " take precedence and might cripple the rate-limiting slightly, to\n" in hugehelp()
2302 " help keeping the speed-limit logic working.\n" in hugehelp()
2309 " curl --limit-rate 100K https://example.com\n" in hugehelp()
2310 " curl --limit-rate 1000 https://example.com\n" in hugehelp()
2311 " curl --limit-rate 10M https://example.com\n" in hugehelp()
2313 " -l, --list-only\n" in hugehelp()
2315 " forces a name-only view. This is especially useful if the user\n" in hugehelp()
2316 " wants to machine-parse the contents of an FTP directory since\n" in hugehelp()
2319 " the normal directory view does not use a standard look or for-\n" in hugehelp()
2324 " NLST; they do not include sub-directories and symbolic links.\n" in hugehelp()
2330 " particularly useful if the user wants to see if a specific mes-\n" in hugehelp()
2331 " sage-id exists on the server and what size it is.\n" in hugehelp()
2333 " Note: When combined with -X, --request, this option can be used\n" in hugehelp()
2335 " unique identifier rather than its message-id to make the re-\n" in hugehelp()
2341 " curl --list-only ftp://example.com/dir/\n" in hugehelp()
2343 " --local-port <num/range>\n" in hugehelp()
2344 " Set a preferred single number or range (FROM-TO) of local port\n" in hugehelp()
2345 " numbers to use for the connection(s). Note that port numbers by\n" in hugehelp()
2346 " nature are a scarce resource that will be busy at times so set-\n" in hugehelp()
2353 " curl --local-port 1000-3000 https://example.com\n" in hugehelp()
2355 " --location-trusted\n" in hugehelp()
2356 " (HTTP) Like -L, --location, but will allow sending the name +\n" in hugehelp()
2365 " curl --location-trusted -u user:password https://example.com\n" in hugehelp()
2367 " See also -u, --user.\n" in hugehelp()
2369 " -L, --location\n" in hugehelp()
2372 " 3XX response code), this option will make curl redo the request\n" in hugehelp()
2373 " on the new place. If used together with -i, --include or -I,\n" in hugehelp()
2376 " --head, headers from all requested pages will be shown. When au-\n" in hugehelp()
2377 " thentication is used, curl only sends its credentials to the\n" in hugehelp()
2378 " initial host. If a redirect takes curl to a different host, it\n" in hugehelp()
2379 " will not be able to intercept the user+password. See also --lo-\n" in hugehelp()
2380 " cation-trusted on how to change this. You can limit the amount\n" in hugehelp()
2381 " of redirects to follow by using the --max-redirs option.\n" in hugehelp()
2385 " When curl follows a redirect and if the request is a POST, it\n" in hugehelp()
2388 " code, curl will re-send the following request using the same un-\n" in hugehelp()
2391 " You can tell curl to not change POST requests to GET after a 30x\n" in hugehelp()
2394 " response by using the dedicated options for that: --post301,\n" in hugehelp()
2395 " --post302 and --post303.\n" in hugehelp()
2397 " The method set with -X, --request overrides the method curl\n" in hugehelp()
2401 " curl -L https://example.com\n" in hugehelp()
2403 " --login-options <options>\n" in hugehelp()
2411 " POP3 and SMTP support login options. For more information about\n" in hugehelp()
2413 " draft-earhart-url-smtp-00.txt\n" in hugehelp()
2420 " curl --login-options 'AUTH=*' imap://example.com\n" in hugehelp()
2424 " --mail-auth <address>\n" in hugehelp()
2430 " curl --mail-auth user@example.come -T mail smtp://example.com/\n" in hugehelp()
2432 " See also --mail-rcpt and --mail-from.\n" in hugehelp()
2436 " --mail-from <address>\n" in hugehelp()
2441 " curl --mail-from user@example.com -T mail smtp://example.com/\n" in hugehelp()
2443 " See also --mail-rcpt and --mail-auth.\n" in hugehelp()
2445 " --mail-rcpt-allowfails\n" in hugehelp()
2446 " (SMTP) When sending data to multiple recipients, by default curl\n" in hugehelp()
2452 " The default behavior can be changed by passing --mail-rcpt-al-\n" in hugehelp()
2453 " lowfails command-line option which will make curl ignore errors\n" in hugehelp()
2457 " specified, curl will still abort the SMTP conversation and re-\n" in hugehelp()
2463 " curl --mail-rcpt-allowfails --mail-rcpt dest@example.com smtp://example.com\n" in hugehelp()
2467 " --mail-rcpt <address>\n" in hugehelp()
2468 " (SMTP) Specify a single e-mail address, user name or mailing\n" in hugehelp()
2474 " When performing an address verification (VRFY command), the re-\n" in hugehelp()
2478 " When performing a mailing list expand (EXPN command), the recip-\n" in hugehelp()
2480 " \"Friends\" or \"London-Office\". (Added in 7.34.0)\n" in hugehelp()
2485 " curl --mail-rcpt user@example.net smtp://example.com\n" in hugehelp()
2487 " -M, --manual\n" in hugehelp()
2491 " curl --manual\n" in hugehelp()
2493 " --max-filesize <bytes>\n" in hugehelp()
2496 " transfer will not start and curl will return with exit code 63.\n" in hugehelp()
2500 " A size modifier may be used. For example, Appending 'k' or 'K'\n" in hugehelp()
2506 " for such files this option has no effect even if the file trans-\n" in hugehelp()
2510 " curl --max-filesize 100K https://example.com\n" in hugehelp()
2512 " See also --limit-rate.\n" in hugehelp()
2514 " --max-redirs <num>\n" in hugehelp()
2515 " (HTTP) Set maximum number of redirections to follow. When -L,\n" in hugehelp()
2516 " --location is used, to prevent curl from following too many\n" in hugehelp()
2518 " this option to -1 to make it unlimited.\n" in hugehelp()
2525 " curl --max-redirs 3 --location https://example.com\n" in hugehelp()
2527 " -m, --max-time <fractional seconds>\n" in hugehelp()
2529 " take. This is useful for preventing your batch jobs from hang-\n" in hugehelp()
2530 " ing for hours due to slow networks or links going down. Since\n" in hugehelp()
2533 " 7.32.0, this option accepts decimal values, but the actual time-\n" in hugehelp()
2540 " curl --max-time 10 https://example.com\n" in hugehelp()
2541 " curl --max-time 2.92 https://example.com\n" in hugehelp()
2543 " See also --connect-timeout.\n" in hugehelp()
2545 " --metalink\n" in hugehelp()
2549 " Metalink support has been disabled in curl since 7.78.0 for se-\n" in hugehelp()
2553 " curl --metalink file https://example.com\n" in hugehelp()
2555 " --negotiate\n" in hugehelp()
2558 " This option requires a library built with GSS-API or SSPI sup-\n" in hugehelp()
2561 " port. Use -V, --version to see if your curl supports GSS-\n" in hugehelp()
2564 " When using this option, you must also provide a fake -u, --user\n" in hugehelp()
2566 " '-u :' is enough as the user name and password from the -u,\n" in hugehelp()
2567 " --user option are not actually used.\n" in hugehelp()
2575 " curl --negotiate -u : https://example.com\n" in hugehelp()
2577 " See also --basic, --ntlm, --anyauth and --proxy-negotiate.\n" in hugehelp()
2579 " --netrc-file <filename>\n" in hugehelp()
2580 " This option is similar to -n, --netrc, except that you provide\n" in hugehelp()
2581 " the path (absolute or relative) to the netrc file that curl\n" in hugehelp()
2585 " If several --netrc-file options are provided, the last one will\n" in hugehelp()
2588 " It will abide by --netrc-optional if specified.\n" in hugehelp()
2591 " curl --netrc-file netrc https://example.com\n" in hugehelp()
2593 " This option overrides -n, --netrc.\n" in hugehelp()
2595 " --netrc-optional\n" in hugehelp()
2596 " Similar to -n, --netrc, but this option makes the .netrc usage\n" in hugehelp()
2597 " optional and not mandatory as the -n, --netrc option does.\n" in hugehelp()
2602 " curl --netrc-optional https://example.com\n" in hugehelp()
2604 " See also --netrc-file. This option overrides -n, --netrc.\n" in hugehelp()
2606 " -n, --netrc\n" in hugehelp()
2607 " Makes curl scan the .netrc (_netrc on Windows) file in the\n" in hugehelp()
2608 " user's home directory for login name and password. This is typi-\n" in hugehelp()
2609 " cally used for FTP on Unix. If used with HTTP, curl will enable\n" in hugehelp()
2610 " user authentication. See netrc(5) and ftp(1) for details on the\n" in hugehelp()
2613 " file format. Curl will not complain if that file does not have\n" in hugehelp()
2614 " the right permissions (it should be neither world- nor group-\n" in hugehelp()
2619 " curl to FTP to the machine host.domain.com with user name 'my-\n" in hugehelp()
2627 " curl --netrc https://example.com\n" in hugehelp()
2629 " -:, --next\n" in hugehelp()
2630 " Tells curl to use a separate operation for the following URL and\n" in hugehelp()
2631 " associated options. This allows you to send several URL re-\n" in hugehelp()
2632 " quests, each with their own specific options, for example, such\n" in hugehelp()
2633 " as different user names or custom requests for each.\n" in hugehelp()
2637 " -:, --next will reset all local options and only global ones\n" in hugehelp()
2639 " the -:, --next instruction. Global options include -v, --ver-\n" in hugehelp()
2640 " bose, --trace, --trace-ascii and --fail-early.\n" in hugehelp()
2642 " For example, you can do both a GET and a POST in a single com-\n" in hugehelp()
2645 " curl www1.example.com --next -d postthis www2.example.com\n" in hugehelp()
2650 " curl https://example.com --next -d postthis www2.example.com\n" in hugehelp()
2651 " curl -I https://example.com --next https://example.net/\n" in hugehelp()
2655 " --no-alpn\n" in hugehelp()
2656 " (HTTPS) Disable the ALPN TLS extension. ALPN is enabled by de-\n" in hugehelp()
2658 " ALPN. ALPN is used by a libcurl that supports HTTP/2 to negoti-\n" in hugehelp()
2664 " curl --no-alpn https://example.com\n" in hugehelp()
2666 " See also --no-npn and --http2. --no-alpn requires that the un-\n" in hugehelp()
2669 " -N, --no-buffer\n" in hugehelp()
2670 " Disables the buffering of the output stream. In normal work sit-\n" in hugehelp()
2671 " uations, curl will use a standard buffered output stream that\n" in hugehelp()
2679 " thus use --buffer to enforce the buffering.\n" in hugehelp()
2682 " curl --no-buffer https://example.com\n" in hugehelp()
2684 " --no-keepalive\n" in hugehelp()
2688 " curl otherwise enables them by default.\n" in hugehelp()
2691 " thus use --keepalive to enforce keepalive.\n" in hugehelp()
2694 " curl --no-keepalive https://example.com\n" in hugehelp()
2696 " --no-npn\n" in hugehelp()
2705 " curl --no-npn https://example.com\n" in hugehelp()
2707 " See also --no-alpn and --http2. --no-npn requires that the un-\n" in hugehelp()
2710 " --no-progress-meter\n" in hugehelp()
2714 " otherwise affecting warning and informational messages like -s,\n" in hugehelp()
2715 " --silent does.\n" in hugehelp()
2718 " thus use --progress-meter to enable the progress meter again.\n" in hugehelp()
2721 " curl --no-progress-meter -o store https://example.com\n" in hugehelp()
2725 " See also -v, --verbose and -s, --silent. Added in 7.67.0.\n" in hugehelp()
2727 " --no-sessionid\n" in hugehelp()
2728 " (TLS) Disable curl's use of SSL session-ID caching. By default\n" in hugehelp()
2730 " should ever get hurt by attempting to reuse SSL session-IDs,\n" in hugehelp()
2732 " require you to disable this in order for you to succeed.\n" in hugehelp()
2737 " thus use --sessionid to enforce session-ID caching.\n" in hugehelp()
2740 " curl --no-sessionid https://example.com\n" in hugehelp()
2742 " --noproxy <no-proxy-list>\n" in hugehelp()
2743 " Comma-separated list of hosts for which not to use a proxy, if\n" in hugehelp()
2748 " Each name in this list is matched as either a domain which con-\n" in hugehelp()
2749 " tains the hostname, or the hostname itself. For example, lo-\n" in hugehelp()
2757 " an environment variable disabling a proxy, you can set the no-\n" in hugehelp()
2761 " curl --noproxy \"www.example\" https://example.com\n" in hugehelp()
2763 " --ntlm-wb\n" in hugehelp()
2764 " (HTTP) Enables NTLM much in the style --ntlm does, but hand over\n" in hugehelp()
2771 " curl --ntlm-wb -u user:password https://example.com\n" in hugehelp()
2773 " See also --ntlm and --proxy-ntlm.\n" in hugehelp()
2775 " --ntlm (HTTP) Enables NTLM authentication. The NTLM authentication\n" in hugehelp()
2777 " It is a proprietary protocol, reverse-engineered by clever peo-\n" in hugehelp()
2778 " ple and implemented in curl based on their efforts. This kind of\n" in hugehelp()
2782 " who uses NTLM to switch to a public and documented authentica-\n" in hugehelp()
2785 " If you want to enable NTLM for your proxy authentication, then\n" in hugehelp()
2786 " use --proxy-ntlm.\n" in hugehelp()
2794 " curl --ntlm -u user:password https://example.com\n" in hugehelp()
2796 " See also --proxy-ntlm. --ntlm requires that the underlying\n" in hugehelp()
2797 " libcurl was built to support TLS. This option overrides --basic\n" in hugehelp()
2798 " and --negotiate and --digest and --anyauth.\n" in hugehelp()
2800 " --oauth2-bearer <token>\n" in hugehelp()
2801 " (IMAP POP3 SMTP HTTP) Specify the Bearer Token for OAUTH 2.0\n" in hugehelp()
2805 " with the user name which can be specified as part of the --url\n" in hugehelp()
2806 " or -u, --user options.\n" in hugehelp()
2814 " curl --oauth2-bearer \"mF_9.B5f-4.1JqM\" https://example.com\n" in hugehelp()
2818 " --output-dir <dir>\n" in hugehelp()
2823 " stored, when -O, --remote-name or -o, --output are used.\n" in hugehelp()
2825 " The given output directory is used for all URLs and output op-\n" in hugehelp()
2826 " tions on the command line, up until the first -:, --next.\n" in hugehelp()
2829 " will fail unless --create-dirs is also used.\n" in hugehelp()
2833 " If this option is used multiple times, the last specified direc-\n" in hugehelp()
2837 " curl --output-dir \"tmp\" -O https://example.com\n" in hugehelp()
2839 " See also -O, --remote-name and -J, --remote-header-name. Added\n" in hugehelp()
2842 " -o, --output <file>\n" in hugehelp()
2848 " variable will be replaced with the current string for the URL\n" in hugehelp()
2851 " curl \"http://{one,two}.example.com\" -o \"file_#1.txt\"\n" in hugehelp()
2855 " curl \"http://{site,host}.host[1-5].com\" -o \"#1_#2\"\n" in hugehelp()
2860 " have. For example, if you specify two URLs on the same command\n" in hugehelp()
2863 " curl -o aa example.com -o bb example.net\n" in hugehelp()
2865 " and the order of the -o options and the URLs does not matter,\n" in hugehelp()
2866 " just that the first -o is for the first URL and so on, so the\n" in hugehelp()
2869 " curl example.com example.net -o aa -o bb\n" in hugehelp()
2873 " See also the --create-dirs option to create the local directo-\n" in hugehelp()
2874 " ries dynamically. Specifying the output as '-' (a single dash)\n" in hugehelp()
2880 " curl example.com -o /dev/null\n" in hugehelp()
2882 " Or for Windows use nul:\n" in hugehelp()
2883 " curl example.com -o nul\n" in hugehelp()
2888 " curl -o file https://example.com\n" in hugehelp()
2889 " curl \"http://{one,two}.example.com\" -o \"file_#1.txt\"\n" in hugehelp()
2890 " curl \"http://{site,host}.host[1-5].com\" -o \"#1_#2\"\n" in hugehelp()
2891 " curl -o file https://example.com -o file2 https://example.net\n" in hugehelp()
2893 " See also -O, --remote-name, --remote-name-all and -J, --remote-\n" in hugehelp()
2894 " header-name.\n" in hugehelp()
2896 " --parallel-immediate\n" in hugehelp()
2897 " When doing parallel transfers, this option will instruct curl\n" in hugehelp()
2900 " that it should rather prefer opening up more connections in par-\n" in hugehelp()
2904 " This option is global and does not need to be specified for each\n" in hugehelp()
2905 " use of -:, --next.\n" in hugehelp()
2908 " curl --parallel-immediate -Z https://example.com -o file1 https://example.com -o fi… in hugehelp()
2912 " See also -Z, --parallel and --parallel-max. Added in 7.68.0.\n" in hugehelp()
2914 " --parallel-max <num>\n" in hugehelp()
2915 " When asked to do parallel transfers, using -Z, --parallel, this\n" in hugehelp()
2916 " option controls the maximum amount of transfers to do simultane-\n" in hugehelp()
2919 " This option is global and does not need to be specified for each\n" in hugehelp()
2920 " use of -:, --next.\n" in hugehelp()
2926 " curl --parallel-max 100 -Z https://example.com ftp://example.com/\n" in hugehelp()
2928 " See also -Z, --parallel. Added in 7.66.0.\n" in hugehelp()
2930 " -Z, --parallel\n" in hugehelp()
2931 " Makes curl perform its transfers in parallel as compared to the\n" in hugehelp()
2934 " This option is global and does not need to be specified for each\n" in hugehelp()
2935 " use of -:, --next.\n" in hugehelp()
2940 " curl --parallel https://example.com -o file1 https://example.com -o file2\n" in hugehelp()
2944 " --pass <phrase>\n" in hugehelp()
2945 " (SSH TLS) Passphrase for the private key.\n" in hugehelp()
2950 " curl --pass secret --key file https://example.com\n" in hugehelp()
2952 " --path-as-is\n" in hugehelp()
2953 " Tell curl to not handle sequences of /../ or /./ in the given\n" in hugehelp()
2956 " URL path. Normally curl will squash or merge them according to\n" in hugehelp()
2960 " curl --path-as-is https://example.com/../../etc/passwd\n" in hugehelp()
2964 " --pinnedpubkey <hashes>\n" in hugehelp()
2965 " (TLS) Tells curl to use the specified public key file (or\n" in hugehelp()
2970 " of base64 encoded sha256 hashes preceded by 'sha256//' and sepa-\n" in hugehelp()
2975 " from this certificate and if it does not exactly match the pub-\n" in hugehelp()
2978 " lic key provided to this option, curl will abort the connection\n" in hugehelp()
3001 " curl --pinnedpubkey keyfile https://example.com\n" in hugehelp()
3002 " curl --pinnedpubkey 'sha256//ce118b51897f4452dc' https://example.com\n" in hugehelp()
3006 " --post301\n" in hugehelp()
3007 " (HTTP) Tells curl to respect RFC 7231/6.4.2 and not convert POST\n" in hugehelp()
3011 " non-RFC behavior is ubiquitous in web browsers, so curl does the\n" in hugehelp()
3014 " This option is meaningful only when using -L, --location.\n" in hugehelp()
3017 " curl --post301 --location -d \"data\" https://example.com\n" in hugehelp()
3019 " See also --post302, --post303 and -L, --location.\n" in hugehelp()
3021 " --post302\n" in hugehelp()
3024 " (HTTP) Tells curl to respect RFC 7231/6.4.3 and not convert POST\n" in hugehelp()
3026 " non-RFC behavior is ubiquitous in web browsers, so curl does the\n" in hugehelp()
3029 " This option is meaningful only when using -L, --location.\n" in hugehelp()
3034 " curl --post302 --location -d \"data\" https://example.com\n" in hugehelp()
3036 " See also --post301, --post303 and -L, --location.\n" in hugehelp()
3038 " --post303\n" in hugehelp()
3039 " (HTTP) Tells curl to violate RFC 7231/6.4.4 and not convert POST\n" in hugehelp()
3041 " server may require a POST to remain a POST after a 303 redirect-\n" in hugehelp()
3042 " ion. This option is meaningful only when using -L, --location.\n" in hugehelp()
3047 " curl --post303 --location -d \"data\" https://example.com\n" in hugehelp()
3049 " See also --post302, --post301 and -L, --location.\n" in hugehelp()
3051 " --preproxy [protocol://]host[:port]\n" in hugehelp()
3053 " HTTPS -x, --proxy. In such a case curl first connects to the\n" in hugehelp()
3059 " The pre proxy string should be specified with a protocol:// pre-\n" in hugehelp()
3062 " SOCKS version to be used. No protocol specified will make curl\n" in hugehelp()
3071 " URL decoded by curl. This allows you to pass in special charac-\n" in hugehelp()
3077 " curl --preproxy socks5://proxy.example -x http://http.example https://example.com\n" in hugehelp()
3081 " -#, --progress-bar\n" in hugehelp()
3084 " Make curl display transfer progress as a simple progress bar in-\n" in hugehelp()
3089 " For transfers without a known size, there will be space ship\n" in hugehelp()
3090 " (-=o=-) that moves back and forth but only while data is being\n" in hugehelp()
3095 " This option is global and does not need to be specified for each\n" in hugehelp()
3096 " use of -:, --next.\n" in hugehelp()
3099 " curl -# -O https://example.com\n" in hugehelp()
3101 " --proto-default <protocol>\n" in hugehelp()
3102 " Tells curl to use protocol for any URL missing a scheme name.\n" in hugehelp()
3104 " An unknown or unsupported protocol causes error CURLE_UNSUP-\n" in hugehelp()
3111 " Without this option set, curl guesses protocol based on the host\n" in hugehelp()
3112 " name, see --url for details.\n" in hugehelp()
3115 " curl --proto-default https ftp.example.com\n" in hugehelp()
3119 " --proto-redir <protocols>\n" in hugehelp()
3120 " Tells curl to limit what protocols it may use on redirect. Pro-\n" in hugehelp()
3123 " tocols denied by --proto are not overridden by this option. See\n" in hugehelp()
3124 " --proto for how protocols are represented.\n" in hugehelp()
3128 " curl --proto-redir -all,http,https http://example.com\n" in hugehelp()
3130 " By default curl will only allow HTTP, HTTPS, FTP and FTPS on re-\n" in hugehelp()
3131 " direct (since 7.65.2). Specifying all or +all enables all proto-\n" in hugehelp()
3132 " cols on redirects, which is not good for security.\n" in hugehelp()
3137 " curl --proto-redir =http,https https://example.com\n" in hugehelp()
3139 " --proto <protocols>\n" in hugehelp()
3140 " Tells curl to limit what protocols it may use for transfers.\n" in hugehelp()
3145 " + Permit this protocol in addition to protocols already permit-\n" in hugehelp()
3150 " - Deny this protocol, removing it from the list of protocols\n" in hugehelp()
3153 " = Permit only this protocol (ignoring the list already permit-\n" in hugehelp()
3154 " ted), though subject to later modification by subsequent en-\n" in hugehelp()
3157 " For example:\n" in hugehelp()
3159 " --proto -ftps uses the default protocols, but disables ftps\n" in hugehelp()
3163 " --proto -all,https,+http\n" in hugehelp()
3166 " --proto =http,https\n" in hugehelp()
3170 " safely rely on being able to disable potentially dangerous pro-\n" in hugehelp()
3171 " tocols, without relying upon support for that protocol being\n" in hugehelp()
3172 " built into curl to avoid an error.\n" in hugehelp()
3181 " curl --proto =http,https,sftp https://example.com\n" in hugehelp()
3183 " See also --proto-redir and --proto-default.\n" in hugehelp()
3185 " --proxy-anyauth\n" in hugehelp()
3186 " Tells curl to pick a suitable authentication method when commu-\n" in hugehelp()
3190 " request/response round-trip.\n" in hugehelp()
3193 " curl --proxy-anyauth --proxy-user user:passwd -x proxy https://example.com\n" in hugehelp()
3195 " See also -x, --proxy, --proxy-basic and --proxy-digest.\n" in hugehelp()
3197 " --proxy-basic\n" in hugehelp()
3198 " Tells curl to use HTTP Basic authentication when communicating\n" in hugehelp()
3199 " with the given proxy. Use --basic for enabling HTTP Basic with a\n" in hugehelp()
3202 " remote host. Basic is the default authentication method curl\n" in hugehelp()
3206 " curl --proxy-basic --proxy-user user:passwd -x proxy https://example.com\n" in hugehelp()
3208 " See also -x, --proxy, --proxy-anyauth and --proxy-digest.\n" in hugehelp()
3210 " --proxy-cacert <file>\n" in hugehelp()
3211 " Same as --cacert but used in HTTPS proxy context.\n" in hugehelp()
3214 " curl --proxy-cacert CA-file.txt -x https://proxy https://example.com\n" in hugehelp()
3218 " See also --proxy-capath, --cacert, --capath and -x, --proxy.\n" in hugehelp()
3221 " --proxy-capath <dir>\n" in hugehelp()
3222 " Same as --capath but used in HTTPS proxy context.\n" in hugehelp()
3225 " curl --proxy-capath /local/directory -x https://proxy https://example.com\n" in hugehelp()
3227 " See also --proxy-cacert, -x, --proxy and --capath. Added in\n" in hugehelp()
3230 " --proxy-cert-type <type>\n" in hugehelp()
3233 " Same as --cert-type but used in HTTPS proxy context.\n" in hugehelp()
3236 " curl --proxy-cert-type PEM --proxy-cert file -x https://proxy https://example.com\n" in hugehelp()
3240 " --proxy-cert <cert[:passwd]>\n" in hugehelp()
3241 " Same as -E, --cert but used in HTTPS proxy context.\n" in hugehelp()
3244 " curl --proxy-cert file -x https://proxy https://example.com\n" in hugehelp()
3248 " --proxy-ciphers <list>\n" in hugehelp()
3251 " Same as --ciphers but used in HTTPS proxy context.\n" in hugehelp()
3254 " curl --proxy-ciphers ECDHE-ECDSA-AES256-CCM8 -x https://proxy https://example.com\n" in hugehelp()
3258 " --proxy-crlfile <file>\n" in hugehelp()
3259 " Same as --crlfile but used in HTTPS proxy context.\n" in hugehelp()
3262 " curl --proxy-crlfile rejects.txt -x https://proxy https://example.com\n" in hugehelp()
3266 " --proxy-digest\n" in hugehelp()
3269 " Tells curl to use HTTP Digest authentication when communicating\n" in hugehelp()
3270 " with the given proxy. Use --digest for enabling HTTP Digest with\n" in hugehelp()
3274 " curl --proxy-digest --proxy-user user:passwd -x proxy https://example.com\n" in hugehelp()
3276 " See also -x, --proxy, --proxy-anyauth and --proxy-basic.\n" in hugehelp()
3278 " --proxy-header <header/@file>\n" in hugehelp()
3283 " the equivalent option to -H, --header but is for proxy communi-\n" in hugehelp()
3288 " curl will make sure that each header you add/replace is sent\n" in hugehelp()
3289 " with the proper end-of-line marker, you should thus not add that\n" in hugehelp()
3293 " returns, they will only mess things up for you.\n" in hugehelp()
3295 " Headers specified with this option will not be included in re-\n" in hugehelp()
3296 " quests that curl knows will not be sent to a proxy.\n" in hugehelp()
3298 " Starting in 7.55.0, this option can take an argument in @file-\n" in hugehelp()
3299 " name style, which then adds a header for each line in the input\n" in hugehelp()
3302 " file. Using @- will make curl read the header file from stdin.\n" in hugehelp()
3308 " curl --proxy-header \"X-First-Name: Joe\" -x http://proxy https://example.com\n" in hugehelp()
3309 " curl --proxy-header \"User-Agent: surprise\" -x http://proxy https://example.com\n" in hugehelp()
3310 " curl --proxy-header \"Host:\" -x http://proxy https://example.com\n" in hugehelp()
3315 " --proxy-insecure\n" in hugehelp()
3316 " Same as -k, --insecure but used in HTTPS proxy context.\n" in hugehelp()
3319 " curl --proxy-insecure -x https://proxy https://example.com\n" in hugehelp()
3323 " --proxy-key-type <type>\n" in hugehelp()
3324 " Same as --key-type but used in HTTPS proxy context.\n" in hugehelp()
3327 " curl --proxy-key-type DER --proxy-key here -x https://proxy https://example.com\n" in hugehelp()
3333 " --proxy-key <key>\n" in hugehelp()
3334 " Same as --key but used in HTTPS proxy context.\n" in hugehelp()
3337 " curl --proxy-key here -x https://proxy https://example.com\n" in hugehelp()
3341 " --proxy-negotiate\n" in hugehelp()
3342 " Tells curl to use HTTP Negotiate (SPNEGO) authentication when\n" in hugehelp()
3343 " communicating with the given proxy. Use --negotiate for enabling\n" in hugehelp()
3349 " curl --proxy-negotiate --proxy-user user:passwd -x proxy https://example.com\n" in hugehelp()
3351 " See also --proxy-anyauth and --proxy-basic.\n" in hugehelp()
3353 " --proxy-ntlm\n" in hugehelp()
3354 " Tells curl to use HTTP NTLM authentication when communicating\n" in hugehelp()
3355 " with the given proxy. Use --ntlm for enabling NTLM with a remote\n" in hugehelp()
3359 " curl --proxy-ntlm --proxy-user user:passwd -x http://proxy https://example.com\n" in hugehelp()
3363 " See also --proxy-negotiate and --proxy-anyauth.\n" in hugehelp()
3365 " --proxy-pass <phrase>\n" in hugehelp()
3366 " Same as --pass but used in HTTPS proxy context.\n" in hugehelp()
3369 " curl --proxy-pass secret --proxy-key here -x https://proxy https://example.com\n" in hugehelp()
3373 " --proxy-pinnedpubkey <hashes>\n" in hugehelp()
3374 " (TLS) Tells curl to use the specified public key file (or\n" in hugehelp()
3379 " of base64 encoded sha256 hashes preceded by 'sha256//' and sepa-\n" in hugehelp()
3384 " from this certificate and if it does not exactly match the pub-\n" in hugehelp()
3387 " lic key provided to this option, curl will abort the connection\n" in hugehelp()
3393 " curl --proxy-pinnedpubkey keyfile https://example.com\n" in hugehelp()
3394 " curl --proxy-pinnedpubkey 'sha256//ce118b51897f4452dc' https://example.com\n" in hugehelp()
3398 " --proxy-service-name <name>\n" in hugehelp()
3401 " This option allows you to change the service name for proxy ne-\n" in hugehelp()
3405 " curl --proxy-service-name \"shrubbery\" -x proxy https://example.com\n" in hugehelp()
3409 " --proxy-ssl-allow-beast\n" in hugehelp()
3410 " Same as --ssl-allow-beast but used in HTTPS proxy context.\n" in hugehelp()
3413 " curl --proxy-ssl-allow-beast -x https://proxy https://example.com\n" in hugehelp()
3419 " --proxy-ssl-auto-client-cert\n" in hugehelp()
3420 " Same as --ssl-auto-client-cert but used in HTTPS proxy context.\n" in hugehelp()
3423 " curl --proxy-ssl-auto-client-cert -x https://proxy https://example.com\n" in hugehelp()
3427 " --proxy-tls13-ciphers <ciphersuite list>\n" in hugehelp()
3435 " https://curl.se/docs/ssl-ciphers.html\n" in hugehelp()
3437 " This option is currently used only when curl is built to use\n" in hugehelp()
3439 " you can try setting TLS 1.3 cipher suites by using the --proxy-\n" in hugehelp()
3447 " curl --proxy-tls13-ciphers TLS_AES_128_GCM_SHA256 -x proxy https://example.com\n" in hugehelp()
3451 " --proxy-tlsauthtype <type>\n" in hugehelp()
3452 " Same as --tlsauthtype but used in HTTPS proxy context.\n" in hugehelp()
3455 " curl --proxy-tlsauthtype SRP -x https://proxy https://example.com\n" in hugehelp()
3461 " --proxy-tlspassword <string>\n" in hugehelp()
3462 " Same as --tlspassword but used in HTTPS proxy context.\n" in hugehelp()
3465 " curl --proxy-tlspassword passwd -x https://proxy https://example.com\n" in hugehelp()
3469 " --proxy-tlsuser <name>\n" in hugehelp()
3470 " Same as --tlsuser but used in HTTPS proxy context.\n" in hugehelp()
3473 " curl --proxy-tlsuser smith -x https://proxy https://example.com\n" in hugehelp()
3477 " --proxy-tlsv1\n" in hugehelp()
3480 " Same as -1, --tlsv1 but used in HTTPS proxy context.\n" in hugehelp()
3483 " curl --proxy-tlsv1 -x https://proxy https://example.com\n" in hugehelp()
3487 " -U, --proxy-user <user:password>\n" in hugehelp()
3488 " Specify the user name and password to use for proxy authentica-\n" in hugehelp()
3491 " If you use a Windows SSPI-enabled curl binary and do either Ne-\n" in hugehelp()
3492 " gotiate or NTLM authentication then you can tell curl to select\n" in hugehelp()
3496 " single colon with this option: \"-U :\".\n" in hugehelp()
3498 " On systems where it works, curl will hide the given option argu-\n" in hugehelp()
3499 " ment from process listings. This is not enough to protect cre-\n" in hugehelp()
3501 " system as they will still be visible for a brief moment before\n" in hugehelp()
3504 " cleared. Such sensitive data should be retrieved from a file in-\n" in hugehelp()
3509 " curl --proxy-user name:pwd -x proxy https://example.com\n" in hugehelp()
3511 " -x, --proxy [protocol://]host[:port]\n" in hugehelp()
3518 " socks4://, socks4a://, socks5:// or socks5h:// to request a spe-\n" in hugehelp()
3522 " 7.52.0 for OpenSSL, GnuTLS and NSS.\n" in hugehelp()
3537 " All operations that are performed over an HTTP proxy will trans-\n" in hugehelp()
3542 " if you can tunnel through the proxy, as one with the -p, --prox-\n" in hugehelp()
3546 " URL decoded by curl. This allows you to pass in special charac-\n" in hugehelp()
3558 " curl --proxy http://proxy.example https://example.com\n" in hugehelp()
3560 " --proxy1.0 <host[:port]>\n" in hugehelp()
3566 " The only difference between this and the HTTP proxy option -x,\n" in hugehelp()
3567 " --proxy, is that attempts to use CONNECT through the proxy will\n" in hugehelp()
3571 " curl --proxy1.0 -x http://proxy https://example.com\n" in hugehelp()
3573 " -p, --proxytunnel\n" in hugehelp()
3574 " When an HTTP proxy is used -x, --proxy, this option will make\n" in hugehelp()
3577 " curl tunnel through the proxy. The tunnel approach is made with\n" in hugehelp()
3578 " the HTTP proxy CONNECT request and requires that the proxy al-\n" in hugehelp()
3579 " lows direct connect to the remote port number curl wants to tun-\n" in hugehelp()
3582 " To suppress proxy CONNECT response headers when curl is set to\n" in hugehelp()
3583 " output headers use --suppress-connect-headers.\n" in hugehelp()
3588 " curl --proxytunnel -x http://proxy https://example.com\n" in hugehelp()
3590 " See also -x, --proxy.\n" in hugehelp()
3592 " --pubkey <key>\n" in hugehelp()
3593 " (SFTP SCP) Public key file name. Allows you to provide your pub-\n" in hugehelp()
3597 " (As of 7.39.0, curl attempts to automatically extract the public\n" in hugehelp()
3598 " key from the private key file, so passing this option is gener-\n" in hugehelp()
3606 " curl --pubkey file.pub sftp://example.com/\n" in hugehelp()
3608 " -Q, --quote <command>\n" in hugehelp()
3615 " prefix them with a dash '-'. To make commands be sent after\n" in hugehelp()
3616 " curl has changed the working directory, just before the transfer\n" in hugehelp()
3617 " command(s), prefix the command with a '+' (this is only sup-\n" in hugehelp()
3618 " ported for FTP). You may specify any number of commands.\n" in hugehelp()
3622 " By default curl will stop at first failure. To make curl con-\n" in hugehelp()
3623 " tinue even if the command fails, prefix the command with an as-\n" in hugehelp()
3624 " terisk (*). Otherwise, if the server returns failure for one of\n" in hugehelp()
3627 " You must send syntactically correct FTP commands as RFC 959 de-\n" in hugehelp()
3635 " SFTP is a binary protocol. Unlike for FTP, curl interprets SFTP\n" in hugehelp()
3637 " names may be quoted shell-style to embed spaces or special char-\n" in hugehelp()
3638 " acters. Following is the list of all supported SFTP quote com-\n" in hugehelp()
3647 " page for date expression details. (Added in 7.73.0)\n" in hugehelp()
3663 " file operand to the user ID specified by the user oper-\n" in hugehelp()
3670 " target_file location pointing to the source_file loca-\n" in hugehelp()
3674 " The mkdir command creates the directory named by the di-\n" in hugehelp()
3683 " page for date expression details. (Added in 7.73.0)\n" in hugehelp()
3685 " pwd The pwd command returns the absolute pathname of the cur-\n" in hugehelp()
3696 " The rm command removes the file specified by the file op-\n" in hugehelp()
3709 " curl --quote \"DELE file\" ftp://example.com/foo\n" in hugehelp()
3711 " --random-file <file>\n" in hugehelp()
3714 " for SSL connections. See also the --egd-file option.\n" in hugehelp()
3719 " curl --random-file rubbish https://example.com\n" in hugehelp()
3721 " -r, --range <range>\n" in hugehelp()
3722 " (HTTP FTP SFTP FILE) Retrieve a byte range (i.e. a partial docu-\n" in hugehelp()
3726 " 0-499 specifies the first 500 bytes\n" in hugehelp()
3728 " 500-999 specifies the second 500 bytes\n" in hugehelp()
3730 " -500 specifies the last 500 bytes\n" in hugehelp()
3734 " 9500- specifies the bytes from offset 9500 and forward\n" in hugehelp()
3736 " 0-0,-1 specifies the first and last byte only(*)(HTTP)\n" in hugehelp()
3738 " 100-199,500-599\n" in hugehelp()
3739 " specifies two separate 100-byte ranges(*) (HTTP)\n" in hugehelp()
3741 " (*) = NOTE that this will cause the server to reply with a mul-\n" in hugehelp()
3742 " tipart response, which will be returned as-is by curl! Parsing\n" in hugehelp()
3748 " Only digit characters (0-9) are valid in the 'start' and 'stop'\n" in hugehelp()
3749 " fields of the 'start-stop' range syntax. If a non-digit charac-\n" in hugehelp()
3750 " ter is given in the range, the server's response will be unspec-\n" in hugehelp()
3759 " FTP and SFTP range downloads only support the simple 'start-\n" in hugehelp()
3766 " curl --range 22-44 https://example.com\n" in hugehelp()
3770 " --raw (HTTP) When used, it disables all internal HTTP decoding of con-\n" in hugehelp()
3771 " tent or transfer encodings and instead makes them passed on un-\n" in hugehelp()
3775 " curl --raw https://example.com\n" in hugehelp()
3777 " -e, --referer <URL>\n" in hugehelp()
3779 " This can also be set with the -H, --header flag of course. When\n" in hugehelp()
3782 " used with -L, --location you can append \";auto\" to the -e,\n" in hugehelp()
3783 " --referer URL to make curl automatically set the previous URL\n" in hugehelp()
3785 " used alone, even if you do not set an initial -e, --referer.\n" in hugehelp()
3790 " curl --referer \"https://fake.example\" https://example.com\n" in hugehelp()
3793 " curl --referer \"https://fake.example;auto\" -L https://example.com\n" in hugehelp()
3794 " curl --referer \";auto\" -L https://example.com\n" in hugehelp()
3796 " See also -A, --user-agent and -H, --header.\n" in hugehelp()
3798 " -J, --remote-header-name\n" in hugehelp()
3799 " (HTTP) This option tells the -O, --remote-name option to use the\n" in hugehelp()
3800 " server-specified Content-Disposition filename instead of ex-\n" in hugehelp()
3810 " There's no attempt to decode %-sequences (yet) in the provided\n" in hugehelp()
3818 " other file that could possibly be loaded automatically by Win-\n" in hugehelp()
3822 " curl -OJ https://example.com/file\n" in hugehelp()
3824 " --remote-name-all\n" in hugehelp()
3825 " This option changes the default action for all given URLs to be\n" in hugehelp()
3828 " dealt with as if -O, --remote-name were used for each one. So if\n" in hugehelp()
3829 " you want to disable that for a specific URL after --remote-name-\n" in hugehelp()
3830 " all has been used, you must use \"-o -\" or --no-remote-name.\n" in hugehelp()
3833 " curl --remote-name-all ftp://example.com/file1 ftp://example.com/file2\n" in hugehelp()
3835 " -O, --remote-name\n" in hugehelp()
3844 " change the current working directory before invoking curl with\n" in hugehelp()
3847 " The remote file name to use for saving is extracted from the\n" in hugehelp()
3852 " file name refer to -J, --remote-header-name which can be used in\n" in hugehelp()
3859 " other URL encoded parts of the name, they will end up as-is as\n" in hugehelp()
3866 " curl -O https://example.com/filename\n" in hugehelp()
3868 " -R, --remote-time\n" in hugehelp()
3869 " When used, this will make curl attempt to figure out the time-\n" in hugehelp()
3870 " stamp of the remote file, and if that is available make the lo-\n" in hugehelp()
3876 " curl --remote-time -o foo https://example.com\n" in hugehelp()
3878 " --request-target <path>\n" in hugehelp()
3879 " (HTTP) Tells curl to use an alternative \"target\" (path) instead\n" in hugehelp()
3888 " curl --request-target \"*\" -X OPTIONS https://example.com\n" in hugehelp()
3892 " -X, --request <command>\n" in hugehelp()
3893 " (HTTP) Specifies a custom request method to use when communicat-\n" in hugehelp()
3898 " GET). Read the HTTP 1.1 specification for details and explana-\n" in hugehelp()
3904 " POST and PUT requests are rather invoked by using dedicated com-\n" in hugehelp()
3909 " This option only changes the actual word used in the HTTP re-\n" in hugehelp()
3910 " quest, it does not alter the way curl behaves. So for example if\n" in hugehelp()
3911 " you want to make a proper HEAD request, using -X HEAD will not\n" in hugehelp()
3912 " suffice. You need to use the -I, --head option.\n" in hugehelp()
3914 " The method string you set with -X, --request will be used for\n" in hugehelp()
3915 " all requests, which if you for example use -L, --location may\n" in hugehelp()
3918 " cause unintended side-effects when curl does not change request\n" in hugehelp()
3919 " method according to the HTTP 30x response codes - and similar.\n" in hugehelp()
3938 " curl -X \"DELETE\" https://example.com\n" in hugehelp()
3939 " curl -X NLST ftp://example.com/\n" in hugehelp()
3941 " --resolve <[+]host:port:addr[,addr]...>\n" in hugehelp()
3942 " Provide a custom address for a specific host and port pair. Us-\n" in hugehelp()
3945 " ing this, you can make the curl requests(s) use a specified ad-\n" in hugehelp()
3948 " the command line. The port number should be the number used for\n" in hugehelp()
3949 " the specific protocol the host will be used for. It means you\n" in hugehelp()
3950 " need several entries if you want to provide address for the same\n" in hugehelp()
3955 " By specifying '*' as host you can tell curl to resolve any host\n" in hugehelp()
3956 " and specific port pair to the specified address. Wildcard is re-\n" in hugehelp()
3957 " solved last so any --resolve with a specific host and port will\n" in hugehelp()
3960 " The provided address set by this option will be used even if -4,\n" in hugehelp()
3961 " --ipv4 or -6, --ipv6 is set to make curl use another IP version.\n" in hugehelp()
3965 " after curl's default timeout (1 minute). Note that this will\n" in hugehelp()
3966 " only make sense for long running parallel transfers with a lot\n" in hugehelp()
3967 " of files. In such cases, if this option is used curl will try to\n" in hugehelp()
3968 " resolve the host as it normally would once the timeout has ex-\n" in hugehelp()
3971 " Support for providing the IP address within [brackets] was added\n" in hugehelp()
3976 " Support for providing multiple IP addresses per entry was added\n" in hugehelp()
3979 " Support for resolving with wildcard was added in 7.64.0.\n" in hugehelp()
3981 " Support for the '+' prefix was was added in 7.75.0.\n" in hugehelp()
3983 " This option can be used many times to add many host names to re-\n" in hugehelp()
3987 " curl --resolve example.com:443:127.0.0.1 https://example.com\n" in hugehelp()
3989 " --retry-all-errors\n" in hugehelp()
3992 " Retry on any error. This option is used together with --retry.\n" in hugehelp()
3995 " option by default (eg in curlrc), there may be unintended conse-\n" in hugehelp()
3997 " with redirected input or output. You'd be much better off han-\n" in hugehelp()
3998 " dling your unique problems in shell script. Please read the ex-\n" in hugehelp()
4003 " WARNING: For server compatibility curl attempts to retry failed\n" in hugehelp()
4005 " but this is not possible with redirected input or output. For\n" in hugehelp()
4015 " By default curl will not error on an HTTP response code that in-\n" in hugehelp()
4016 " dicates an HTTP error, if the transfer was successful. For exam-\n" in hugehelp()
4020 " received then that is not an error. When --retry is used then\n" in hugehelp()
4021 " curl will retry on some HTTP response codes that indicate tran-\n" in hugehelp()
4024 " that indicate HTTP errors (4xx and 5xx) then combine with -f,\n" in hugehelp()
4025 " --fail.\n" in hugehelp()
4028 " curl --retry-all-errors https://example.com\n" in hugehelp()
4034 " --retry-connrefused\n" in hugehelp()
4036 " transient error too for --retry. This option is used together\n" in hugehelp()
4037 " with --retry.\n" in hugehelp()
4040 " curl --retry-connrefused --retry https://example.com\n" in hugehelp()
4044 " --retry-delay <seconds>\n" in hugehelp()
4045 " Make curl sleep this amount of time before each retry when a\n" in hugehelp()
4048 " transfer has failed with a transient error (it changes the de-\n" in hugehelp()
4050 " only interesting if --retry is also used. Setting this delay to\n" in hugehelp()
4051 " zero will make curl use the default backoff time.\n" in hugehelp()
4056 " curl --retry-delay 5 --retry https://example.com\n" in hugehelp()
4060 " --retry-max-time <seconds>\n" in hugehelp()
4061 " The retry timer is reset before the first transfer attempt. Re-\n" in hugehelp()
4062 " tries will be done as usual (see --retry) as long as the timer\n" in hugehelp()
4064 " not reached the limit, the request will be made and while per-\n" in hugehelp()
4068 " limit a single request's maximum time, use -m, --max-time. Set\n" in hugehelp()
4074 " curl --retry-max-time 30 --retry 10 https://example.com\n" in hugehelp()
4076 " --retry <num>\n" in hugehelp()
4077 " If a transient error is returned when curl tries to perform a\n" in hugehelp()
4081 " Setting the number to 0 makes curl do no retries (which is the\n" in hugehelp()
4086 " When curl is about to retry a transfer, it will first wait one\n" in hugehelp()
4087 " second and then for all forthcoming retries it will double the\n" in hugehelp()
4091 " delay between the rest of the retries. By using --retry-delay\n" in hugehelp()
4093 " --retry-max-time to limit the total time allowed for retries.\n" in hugehelp()
4095 " Since curl 7.66.0, curl will comply with the Retry-After: re-\n" in hugehelp()
4104 " curl --retry 7 https://example.com\n" in hugehelp()
4106 " --sasl-authzid <identity>\n" in hugehelp()
4107 " Use this authorisation identity (authzid), during SASL PLAIN au-\n" in hugehelp()
4108 " thentication, in addition to the authentication identity (auth-\n" in hugehelp()
4109 " cid) as specified by -u, --user.\n" in hugehelp()
4111 " If the option is not specified, the server will derive the au-\n" in hugehelp()
4117 " mailbox for example.\n" in hugehelp()
4120 " curl --sasl-authzid zid imap://example.com/\n" in hugehelp()
4124 " --sasl-ir\n" in hugehelp()
4128 " curl --sasl-ir imap://example.com/\n" in hugehelp()
4134 " --service-name <name>\n" in hugehelp()
4135 " This option allows you to change the service name for SPNEGO.\n" in hugehelp()
4137 " Examples: --negotiate --service-name sockd would use\n" in hugehelp()
4138 " sockd/server-name.\n" in hugehelp()
4141 " curl --service-name sockd/server https://example.com\n" in hugehelp()
4144 " -S, --show-error\n" in hugehelp()
4145 " When used with -s, --silent, it makes curl show an error message\n" in hugehelp()
4150 " This option is global and does not need to be specified for each\n" in hugehelp()
4151 " use of -:, --next.\n" in hugehelp()
4154 " curl --show-error --silent https://example.com\n" in hugehelp()
4156 " See also --no-progress-meter.\n" in hugehelp()
4158 " -s, --silent\n" in hugehelp()
4159 " Silent or quiet mode. Do not show progress meter or error mes-\n" in hugehelp()
4160 " sages. Makes Curl mute. It will still output the data you ask\n" in hugehelp()
4163 " for, potentially even to the terminal/stdout unless you redirect\n" in hugehelp()
4166 " Use -S, --show-error in addition to this option to disable\n" in hugehelp()
4170 " curl -s https://example.com\n" in hugehelp()
4172 " See also -v, --verbose, --stderr and --no-progress-meter.\n" in hugehelp()
4174 " --socks4 <host[:port]>\n" in hugehelp()
4175 " Use the specified SOCKS4 proxy. If the port number is not speci-\n" in hugehelp()
4179 " curl resolve the host name and passing the address on to the\n" in hugehelp()
4182 " This option overrides any previous use of -x, --proxy, as they\n" in hugehelp()
4186 " with -x, --proxy using a socks4:// protocol prefix.\n" in hugehelp()
4190 " Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at\n" in hugehelp()
4191 " the same time -x, --proxy is used with an HTTP/HTTPS proxy. In\n" in hugehelp()
4192 " such a case curl first connects to the SOCKS proxy and then con-\n" in hugehelp()
4198 " curl --socks4 hostname:4096 https://example.com\n" in hugehelp()
4200 " --socks4a <host[:port]>\n" in hugehelp()
4203 " Use the specified SOCKS4a proxy. If the port number is not spec-\n" in hugehelp()
4204 " ified, it is assumed at port 1080. This asks the proxy to re-\n" in hugehelp()
4207 " This option overrides any previous use of -x, --proxy, as they\n" in hugehelp()
4211 " with -x, --proxy using a socks4a:// protocol prefix.\n" in hugehelp()
4215 " Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at\n" in hugehelp()
4216 " the same time -x, --proxy is used with an HTTP/HTTPS proxy. In\n" in hugehelp()
4217 " such a case curl first connects to the SOCKS proxy and then con-\n" in hugehelp()
4223 " curl --socks4a hostname:4096 https://example.com\n" in hugehelp()
4225 " --socks5-basic\n" in hugehelp()
4228 " Tells curl to use username/password authentication when connect-\n" in hugehelp()
4230 " enabled by default. Use --socks5-gssapi to force GSS-API au-\n" in hugehelp()
4234 " curl --socks5-basic --socks5 hostname:4096 https://example.com\n" in hugehelp()
4238 " --socks5-gssapi-nec\n" in hugehelp()
4241 " As part of the GSS-API negotiation a protection mode is negoti-\n" in hugehelp()
4244 " --socks5-gssapi-nec allows the unprotected exchange of the pro-\n" in hugehelp()
4248 " curl --socks5-gssapi-nec --socks5 hostname:4096 https://example.com\n" in hugehelp()
4252 " --socks5-gssapi-service <name>\n" in hugehelp()
4253 " The default service name for a socks server is rcmd/server-fqdn.\n" in hugehelp()
4256 " Examples: --socks5 proxy-name --socks5-gssapi-service sockd\n" in hugehelp()
4257 " would use sockd/proxy-name --socks5 proxy-name --socks5-gssapi-\n" in hugehelp()
4258 " service sockd/real-name would use sockd/real-name for cases\n" in hugehelp()
4259 " where the proxy-name does not match the principal name.\n" in hugehelp()
4264 " curl --socks5-gssapi-service sockd --socks5 hostname:4096 https://example.com\n" in hugehelp()
4266 " --socks5-gssapi\n" in hugehelp()
4267 " Tells curl to use GSS-API authentication when connecting to a\n" in hugehelp()
4268 " SOCKS5 proxy. The GSS-API authentication is enabled by default\n" in hugehelp()
4269 " (if curl is compiled with GSS-API support). Use --socks5-basic\n" in hugehelp()
4275 " curl --socks5-gssapi --socks5 hostname:4096 https://example.com\n" in hugehelp()
4279 " --socks5-hostname <host[:port]>\n" in hugehelp()
4284 " This option overrides any previous use of -x, --proxy, as they\n" in hugehelp()
4289 " This option is superfluous since you can specify a socks5 host-\n" in hugehelp()
4290 " name proxy with -x, --proxy using a socks5h:// protocol prefix.\n" in hugehelp()
4292 " Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at\n" in hugehelp()
4293 " the same time -x, --proxy is used with an HTTP/HTTPS proxy. In\n" in hugehelp()
4294 " such a case curl first connects to the SOCKS proxy and then con-\n" in hugehelp()
4302 " curl --socks5-hostname proxy.example:7000 https://example.com\n" in hugehelp()
4304 " --socks5 <host[:port]>\n" in hugehelp()
4305 " Use the specified SOCKS5 proxy - but resolve the host name lo-\n" in hugehelp()
4309 " This option overrides any previous use of -x, --proxy, as they\n" in hugehelp()
4315 " with -x, --proxy using a socks5:// protocol prefix.\n" in hugehelp()
4317 " Since 7.52.0, --preproxy can be used to specify a SOCKS proxy at\n" in hugehelp()
4318 " the same time -x, --proxy is used with an HTTP/HTTPS proxy. In\n" in hugehelp()
4319 " such a case curl first connects to the SOCKS proxy and then con-\n" in hugehelp()
4325 " This option (as well as --socks4) does not work with IPV6, FTPS\n" in hugehelp()
4328 " curl --socks5 proxy.example:7000 https://example.com\n" in hugehelp()
4330 " -Y, --speed-limit <speed>\n" in hugehelp()
4331 " If a download is slower than this given speed (in bytes per sec-\n" in hugehelp()
4332 " ond) for speed-time seconds it gets aborted. speed-time is set\n" in hugehelp()
4335 " with -y, --speed-time and is 30 if not set.\n" in hugehelp()
4340 " curl --speed-limit 300 --speed-time 10 https://example.com\n" in hugehelp()
4342 " -y, --speed-time <seconds>\n" in hugehelp()
4343 " If a download is slower than speed-limit bytes per second during\n" in hugehelp()
4344 " a speed-time period, the download gets aborted. If speed-time is\n" in hugehelp()
4347 " used, the default speed-limit will be 1 unless set with -Y,\n" in hugehelp()
4348 " --speed-limit.\n" in hugehelp()
4351 " connects etc. If this is a concern for you, try the --connect-\n" in hugehelp()
4357 " curl --speed-limit 300 --speed-time 10 https://example.com\n" in hugehelp()
4361 " --ssl-allow-beast\n" in hugehelp()
4362 " This option tells curl to not work around a security flaw in the\n" in hugehelp()
4364 " used, the SSL layer may use workarounds known to cause interop-\n" in hugehelp()
4368 " flag you ask for exactly that.\n" in hugehelp()
4373 " curl --ssl-allow-beast https://example.com\n" in hugehelp()
4375 " --ssl-auto-client-cert\n" in hugehelp()
4376 " Tell libcurl to automatically locate and use a client certifi-\n" in hugehelp()
4377 " cate for authentication, when requested by the server. This op-\n" in hugehelp()
4378 " tion is only supported for Schannel (the native Windows SSL li-\n" in hugehelp()
4387 " curl --ssl-auto-client-cert https://example.com\n" in hugehelp()
4389 " See also --proxy-ssl-auto-client-cert. Added in 7.77.0.\n" in hugehelp()
4391 " --ssl-no-revoke\n" in hugehelp()
4392 " (Schannel) This option tells curl to disable certificate revoca-\n" in hugehelp()
4396 " by using this flag you ask for exactly that.\n" in hugehelp()
4399 " curl --ssl-no-revoke https://example.com\n" in hugehelp()
4403 " --ssl-reqd\n" in hugehelp()
4404 " (FTP IMAP POP3 SMTP) Require SSL/TLS for the connection. Termi-\n" in hugehelp()
4407 " This option was formerly known as --ftp-ssl-reqd.\n" in hugehelp()
4410 " curl --ssl-reqd ftp://example.com\n" in hugehelp()
4414 " --ssl-revoke-best-effort\n" in hugehelp()
4415 " (Schannel) This option tells curl to ignore certificate revoca-\n" in hugehelp()
4417 " points for the revocation check lists.\n" in hugehelp()
4420 " curl --ssl-revoke-best-effort https://example.com\n" in hugehelp()
4424 " --ssl (FTP IMAP POP3 SMTP) Try to use SSL/TLS for the connection. Re-\n" in hugehelp()
4427 " verts to a non-secure connection if the server does not support\n" in hugehelp()
4428 " SSL/TLS. See also --ftp-ssl-control and --ssl-reqd for differ-\n" in hugehelp()
4431 " This option was formerly known as --ftp-ssl. That option name\n" in hugehelp()
4435 " curl --ssl pop3://example.com/\n" in hugehelp()
4437 " -2, --sslv2\n" in hugehelp()
4440 " (SSL) This option previously asked curl to use SSLv2, but start-\n" in hugehelp()
4441 " ing in curl 7.77.0 this instruction is ignored. SSLv2 is widely\n" in hugehelp()
4445 " curl --sslv2 https://example.com\n" in hugehelp()
4447 " See also --http1.1 and --http2. -2, --sslv2 requires that the\n" in hugehelp()
4448 " underlying libcurl was built to support TLS. This option over-\n" in hugehelp()
4451 " rides -3, --sslv3 and -1, --tlsv1 and --tlsv1.1 and --tlsv1.2.\n" in hugehelp()
4453 " -3, --sslv3\n" in hugehelp()
4454 " (SSL) This option previously asked curl to use SSLv3, but start-\n" in hugehelp()
4455 " ing in curl 7.77.0 this instruction is ignored. SSLv3 is widely\n" in hugehelp()
4459 " curl --sslv3 https://example.com\n" in hugehelp()
4461 " See also --http1.1 and --http2. -3, --sslv3 requires that the\n" in hugehelp()
4464 " underlying libcurl was built to support TLS. This option over-\n" in hugehelp()
4465 " rides -2, --sslv2 and -1, --tlsv1 and --tlsv1.1 and --tlsv1.2.\n" in hugehelp()
4467 " --stderr <file>\n" in hugehelp()
4469 " the file name is a plain '-', it is instead written to stdout.\n" in hugehelp()
4471 " This option is global and does not need to be specified for each\n" in hugehelp()
4472 " use of -:, --next.\n" in hugehelp()
4479 " curl --stderr output.txt https://example.com\n" in hugehelp()
4481 " See also -v, --verbose and -s, --silent.\n" in hugehelp()
4483 " --styled-output\n" in hugehelp()
4485 " headers to the terminal. Use --no-styled-output to switch them\n" in hugehelp()
4488 " This option is global and does not need to be specified for each\n" in hugehelp()
4491 " use of -:, --next.\n" in hugehelp()
4494 " curl --styled-output -I https://example.com\n" in hugehelp()
4498 " --suppress-connect-headers\n" in hugehelp()
4499 " When -p, --proxytunnel is used and a CONNECT request is made do\n" in hugehelp()
4501 " to be used with -D, --dump-header or -i, --include which are\n" in hugehelp()
4505 " debug options such as -v, --verbose or --trace, or any statis-\n" in hugehelp()
4509 " curl --suppress-connect-headers --include -x proxy https://example.com\n" in hugehelp()
4511 " See also -D, --dump-header, -i, --include and -p, --proxytunnel.\n" in hugehelp()
4514 " --tcp-fastopen\n" in hugehelp()
4518 " curl --tcp-fastopen https://example.com\n" in hugehelp()
4524 " --tcp-nodelay\n" in hugehelp()
4526 " page for details about this option.\n" in hugehelp()
4528 " Since 7.50.2, curl sets this option by default and you need to\n" in hugehelp()
4532 " curl --tcp-nodelay https://example.com\n" in hugehelp()
4534 " -t, --telnet-option <opt=val>\n" in hugehelp()
4546 " curl -t TTYPE=vt100 telnet://example.com/\n" in hugehelp()
4548 " --tftp-blksize <value>\n" in hugehelp()
4552 " size that curl will try to use when transferring data to or from\n" in hugehelp()
4558 " curl --tftp-blksize 1024 tftp://example.com/file\n" in hugehelp()
4560 " --tftp-no-options\n" in hugehelp()
4561 " (TFTP) Tells curl not to send TFTP options requests.\n" in hugehelp()
4567 " option is used --tftp-blksize is ignored.\n" in hugehelp()
4570 " curl --tftp-no-options tftp://192.168.0.1/\n" in hugehelp()
4574 " -z, --time-cond <time>\n" in hugehelp()
4580 " if it does not match any internal ones, it is taken as a file-\n" in hugehelp()
4582 " instead. See the curl_getdate(3) man pages for date expression\n" in hugehelp()
4585 " Start the date expression with a dash (-) to make it request for\n" in hugehelp()
4594 " curl -z \"Wed 01 Sep 2021 12:18:00\" https://example.com\n" in hugehelp()
4595 " curl -z \"-Wed 01 Sep 2021 12:18:00\" https://example.com\n" in hugehelp()
4596 " curl -z file https://example.com\n" in hugehelp()
4598 " --tls-max <VERSION>\n" in hugehelp()
4605 " If the connection is done without TLS, this option has no ef-\n" in hugehelp()
4606 " fect. This includes QUIC-using (HTTP/3) transfers.\n" in hugehelp()
4619 " curl --tls-max 1.2 https://example.com\n" in hugehelp()
4620 " curl --tls-max 1.3 --tlsv1.2 https://example.com\n" in hugehelp()
4622 " See also --tlsv1.0, --tlsv1.1, --tlsv1.2 and --tlsv1.3. --tls-max re-\n" in hugehelp()
4626 " --tls13-ciphers <ciphersuite list>\n" in hugehelp()
4634 " https://curl.se/docs/ssl-ciphers.html\n" in hugehelp()
4636 " This option is currently used only when curl is built to use\n" in hugehelp()
4638 " you can try setting TLS 1.3 cipher suites by using the --ciphers\n" in hugehelp()
4646 " curl --tls13-ciphers TLS_AES_128_GCM_SHA256 https://example.com\n" in hugehelp()
4650 " --tlsauthtype <type>\n" in hugehelp()
4651 " Set TLS authentication type. Currently, the only supported op-\n" in hugehelp()
4652 " tion is \"SRP\", for TLS-SRP (RFC 5054). If --tlsuser and\n" in hugehelp()
4653 " --tlspassword are specified but --tlsauthtype is not, then this\n" in hugehelp()
4654 " option defaults to \"SRP\". This option works only if the under-\n" in hugehelp()
4657 " lying libcurl is built with TLS-SRP support, which requires\n" in hugehelp()
4658 " OpenSSL or GnuTLS with TLS-SRP support.\n" in hugehelp()
4661 " curl --tlsauthtype SRP https://example.com\n" in hugehelp()
4663 " --tlspassword <string>\n" in hugehelp()
4664 " Set password for use with the TLS authentication method speci-\n" in hugehelp()
4665 " fied with --tlsauthtype. Requires that --tlsuser also be set.\n" in hugehelp()
4672 " curl --tlspassword pwd --tlsuser user https://example.com\n" in hugehelp()
4674 " --tlsuser <name>\n" in hugehelp()
4675 " Set username for use with the TLS authentication method speci-\n" in hugehelp()
4676 " fied with --tlsauthtype. Requires that --tlspassword also is\n" in hugehelp()
4682 " curl --tlspassword pwd --tlsuser user https://example.com\n" in hugehelp()
4684 " --tlsv1.0\n" in hugehelp()
4687 " (TLS) Forces curl to use TLS version 1.0 or later when connect-\n" in hugehelp()
4690 " In old versions of curl this option was documented to allow\n" in hugehelp()
4692 " TLS library. Use --tls-max if you want to set a maximum TLS ver-\n" in hugehelp()
4696 " curl --tlsv1.0 https://example.com\n" in hugehelp()
4702 " --tlsv1.1\n" in hugehelp()
4703 " (TLS) Forces curl to use TLS version 1.1 or later when connect-\n" in hugehelp()
4706 " In old versions of curl this option was documented to allow\n" in hugehelp()
4708 " TLS library. Use --tls-max if you want to set a maximum TLS ver-\n" in hugehelp()
4712 " curl --tlsv1.1 https://example.com\n" in hugehelp()
4718 " --tlsv1.2\n" in hugehelp()
4719 " (TLS) Forces curl to use TLS version 1.2 or later when connect-\n" in hugehelp()
4722 " In old versions of curl this option was documented to allow\n" in hugehelp()
4724 " TLS library. Use --tls-max if you want to set a maximum TLS ver-\n" in hugehelp()
4730 " curl --tlsv1.2 https://example.com\n" in hugehelp()
4734 " --tlsv1.3\n" in hugehelp()
4735 " (TLS) Forces curl to use TLS version 1.3 or later when connect-\n" in hugehelp()
4738 " If the connection is done without TLS, this option has no ef-\n" in hugehelp()
4739 " fect. This includes QUIC-using (HTTP/3) transfers.\n" in hugehelp()
4746 " curl --tlsv1.3 https://example.com\n" in hugehelp()
4750 " -1, --tlsv1\n" in hugehelp()
4751 " (SSL) Tells curl to use at least TLS version 1.x when negotiat-\n" in hugehelp()
4756 " curl --tlsv1 https://example.com\n" in hugehelp()
4758 " See also --http1.1 and --http2. -1, --tlsv1 requires that the\n" in hugehelp()
4761 " underlying libcurl was built to support TLS. This option over-\n" in hugehelp()
4762 " rides --tlsv1.1 and --tlsv1.2 and --tlsv1.3.\n" in hugehelp()
4764 " --tr-encoding\n" in hugehelp()
4765 " (HTTP) Request a compressed Transfer-Encoding response using one\n" in hugehelp()
4766 " of the algorithms curl supports, and uncompress the data while\n" in hugehelp()
4770 " curl --tr-encoding https://example.com\n" in hugehelp()
4772 " --trace-ascii <file>\n" in hugehelp()
4775 " Enables a full trace dump of all incoming and outgoing data, in-\n" in hugehelp()
4777 " \"-\" as filename to have the output sent to stdout.\n" in hugehelp()
4779 " This is similar to --trace, but leaves out the hex part and only\n" in hugehelp()
4781 " might be easier to read for untrained humans.\n" in hugehelp()
4785 " This option is global and does not need to be specified for each\n" in hugehelp()
4786 " use of -:, --next.\n" in hugehelp()
4791 " curl --trace-ascii log.txt https://example.com\n" in hugehelp()
4793 " This option overrides --trace and -v, --verbose.\n" in hugehelp()
4795 " --trace-time\n" in hugehelp()
4796 " Prepends a time stamp to each trace or verbose line that curl\n" in hugehelp()
4801 " This option is global and does not need to be specified for each\n" in hugehelp()
4802 " use of -:, --next.\n" in hugehelp()
4805 " curl --trace-time --trace-ascii output https://example.com\n" in hugehelp()
4807 " --trace <file>\n" in hugehelp()
4808 " Enables a full trace dump of all incoming and outgoing data, in-\n" in hugehelp()
4810 " \"-\" as filename to have the output sent to stdout. Use \"%\" as\n" in hugehelp()
4815 " This option is global and does not need to be specified for each\n" in hugehelp()
4816 " use of -:, --next.\n" in hugehelp()
4821 " curl --trace log.txt https://example.com\n" in hugehelp()
4823 " This option overrides -v, --verbose and --trace-ascii.\n" in hugehelp()
4825 " --unix-socket <path>\n" in hugehelp()
4832 " curl --unix-socket socket-path https://example.com\n" in hugehelp()
4836 " -T, --upload-file <file>\n" in hugehelp()
4838 " there is no file part in the specified URL, curl will append the\n" in hugehelp()
4842 " directory to really prove to Curl that there is no file name or\n" in hugehelp()
4843 " curl will think that your last directory name is the remote file\n" in hugehelp()
4848 " Use the file name \"-\" (a single dash) to use stdin instead of a\n" in hugehelp()
4852 " may be specified instead of \"-\" to use stdin in non-blocking\n" in hugehelp()
4853 " mode to allow reading server output while stdin is being up-\n" in hugehelp()
4856 " You can specify one -T, --upload-file for each URL on the com-\n" in hugehelp()
4857 " mand line. Each -T, --upload-file + URL pair specifies what to\n" in hugehelp()
4858 " upload and to where. curl also supports \"globbing\" of the -T,\n" in hugehelp()
4859 " --upload-file argument, meaning that you can upload multiple\n" in hugehelp()
4862 " files to a single URL by using the same URL globbing style sup-\n" in hugehelp()
4867 " headers and mail body formatted correctly by the user as curl\n" in hugehelp()
4871 " curl -T file https://example.com\n" in hugehelp()
4874 " curl -T \"img[1-1000].png\" ftp://ftp.example.com/\n" in hugehelp()
4875 " curl --upload-file \"{file1,file2}\" https://example.com\n" in hugehelp()
4877 " --url <url>\n" in hugehelp()
4882 " \"ftp://\" etc) then curl will make a guess based on the host. If\n" in hugehelp()
4885 " the outermost sub-domain name matches DICT, FTP, IMAP, LDAP,\n" in hugehelp()
4888 " default protocol, see --proto-default for details.\n" in hugehelp()
4891 " this URL is written, use the -o, --output or the -O, --remote-\n" in hugehelp()
4896 " WARNING: On Windows, particular file:// accesses can be con-\n" in hugehelp()
4900 " curl --url https://example.com\n" in hugehelp()
4902 " -B, --use-ascii\n" in hugehelp()
4903 " (FTP LDAP) Enable ASCII transfer. For FTP, this can also be en-\n" in hugehelp()
4905 " causes data sent to stdout to be in text mode for win32 systems.\n" in hugehelp()
4910 " curl -B ftp://example.com/README\n" in hugehelp()
4912 " -A, --user-agent <name>\n" in hugehelp()
4913 " (HTTP) Specify the User-Agent string to send to the HTTP server.\n" in hugehelp()
4915 " quote marks. This header can also be set with the -H, --header\n" in hugehelp()
4916 " or the --proxy-header options.\n" in hugehelp()
4918 " If you give an empty argument to -A, --user-agent (\"\"), it will\n" in hugehelp()
4927 " curl -A \"Agent 007\" https://example.com\n" in hugehelp()
4929 " -u, --user <user:password>\n" in hugehelp()
4930 " Specify the user name and password to use for server authentica-\n" in hugehelp()
4931 " tion. Overrides -n, --netrc and --netrc-optional.\n" in hugehelp()
4935 " If you simply specify the user name, curl will prompt for a\n" in hugehelp()
4942 " On systems where it works, curl will hide the given option argu-\n" in hugehelp()
4943 " ment from process listings. This is not enough to protect cre-\n" in hugehelp()
4947 " system as they will still be visible for a moment before\n" in hugehelp()
4948 " cleared. Such sensitive data should be retrieved from a file in-\n" in hugehelp()
4951 " include the Windows domain name in the user name, in order for\n" in hugehelp()
4959 " forest in your setup for example.\n" in hugehelp()
4961 " To specify the domain name use either Down-Level Logon Name or\n" in hugehelp()
4964 " UPN (User Principal Name) formats. For example, EXAMPLE\\user and\n" in hugehelp()
4967 " If you use a Windows SSPI-enabled curl binary and perform Ker-\n" in hugehelp()
4969 " tell curl to select the user name and password from your envi-\n" in hugehelp()
4970 " ronment by specifying a single colon with this option: \"-u :\".\n" in hugehelp()
4977 " curl -u user:secret https://example.com\n" in hugehelp()
4979 " -v, --verbose\n" in hugehelp()
4980 " Makes curl verbose during the operation. Useful for debugging\n" in hugehelp()
4982 " with '>' means \"header data\" sent by curl, '<' means \"header\n" in hugehelp()
4983 " data\" received by curl that is hidden in normal cases, and a\n" in hugehelp()
4986 " line starting with '*' means additional info provided by curl.\n" in hugehelp()
4988 " If you only want HTTP headers in the output, -i, --include might\n" in hugehelp()
4989 " be the option you are looking for.\n" in hugehelp()
4992 " consider using --trace or --trace-ascii instead.\n" in hugehelp()
4994 " This option is global and does not need to be specified for each\n" in hugehelp()
4995 " use of -:, --next.\n" in hugehelp()
4999 " Use -s, --silent to make curl really quiet.\n" in hugehelp()
5002 " curl --verbose https://example.com\n" in hugehelp()
5004 " See also -i, --include. This option overrides --trace and\n" in hugehelp()
5005 " --trace-ascii.\n" in hugehelp()
5007 " -V, --version\n" in hugehelp()
5008 " Displays information about curl and the libcurl version it uses.\n" in hugehelp()
5009 " The first line includes the full version of curl, libcurl and\n" in hugehelp()
5020 " alt-svc\n" in hugehelp()
5021 " Support for the Alt-Svc: header is provided.\n" in hugehelp()
5024 " This curl uses asynchronous name resolves. Asynchronous\n" in hugehelp()
5027 " name resolves can be done using either the c-ares or the\n" in hugehelp()
5030 " brotli Support for automatic brotli compression over HTTP(S).\n" in hugehelp()
5033 " curl was built with support for character set conversions\n" in hugehelp()
5036 " Debug This curl uses a libcurl built with Debug. This enables\n" in hugehelp()
5039 " more error-tracking and memory debugging etc. For curl-\n" in hugehelp()
5042 " gsasl The built-in SASL authentication includes extensions to\n" in hugehelp()
5045 " GSS-API\n" in hugehelp()
5046 " GSS-API is supported.\n" in hugehelp()
5050 " HTTP2 HTTP/2 support has been built-in.\n" in hugehelp()
5051 " HTTP3 HTTP/3 support has been built-in.\n" in hugehelp()
5055 " HTTPS-proxy\n" in hugehelp()
5056 " This curl is built to support HTTPS proxy.\n" in hugehelp()
5058 " IDN This curl supports IDN - international domain names.\n" in hugehelp()
5066 " This curl supports transfers of large files, files larger\n" in hugehelp()
5075 " This curl supports multiple TLS backends.\n" in hugehelp()
5082 " PSL PSL is short for Public Suffix List and means that this\n" in hugehelp()
5085 " curl has been built with knowledge about \"public suf-\n" in hugehelp()
5095 " TLS-SRP\n" in hugehelp()
5097 " for TLS.\n" in hugehelp()
5114 " curl --version\n" in hugehelp()
5116 " -w, --write-out <format>\n" in hugehelp()
5117 " Make curl display information on stdout after a completed trans-\n" in hugehelp()
5122 " literal \"string\", or you can have curl read the format from a\n" in hugehelp()
5123 " file with \"@filename\" and to tell curl to read the format from\n" in hugehelp()
5124 " stdin you write \"@-\".\n" in hugehelp()
5129 " by the value or text that curl thinks fit, as described below.\n" in hugehelp()
5139 " NOTE: The %-symbol is a special symbol in the win32-environment,\n" in hugehelp()
5140 " where all occurrences of % must be doubled when using this op-\n" in hugehelp()
5145 " content_type The Content-Type of the requested document, if\n" in hugehelp()
5156 " The ultimate filename that curl writes out to.\n" in hugehelp()
5157 " This is only meaningful if curl is told to write\n" in hugehelp()
5158 " to a file with the -O, --remote-name or -o,\n" in hugehelp()
5159 " --output option. It's most useful in combination\n" in hugehelp()
5160 " with the -J, --remote-header-name option.\n" in hugehelp()
5164 " ftp_entry_path The initial path curl ended up in when logging on\n" in hugehelp()
5170 " http_connect The numerical code that was found in the last re-\n" in hugehelp()
5171 " sponse (from a proxy) to a curl CONNECT request.\n" in hugehelp()
5180 " local_ip The IP address of the local end of the most re-\n" in hugehelp()
5181 " cently done connection - can be either IPv4 or\n" in hugehelp()
5189 " method The http method used in the most recent HTTP re-\n" in hugehelp()
5192 " num_connects Number of new connects made in the recent trans-\n" in hugehelp()
5202 " num_redirects Number of redirects that were followed in the re-\n" in hugehelp()
5206 " transfer returned a non-zero error (Added in\n" in hugehelp()
5212 " The result of the HTTPS proxy's SSL peer certifi-\n" in hugehelp()
5216 " redirect_url When an HTTP request was made without -L, --loca-\n" in hugehelp()
5217 " tion to follow redirects (or when --max-redirs is\n" in hugehelp()
5227 " connection - can be either IPv4 or IPv6.\n" in hugehelp()
5241 " This is the size of the body/data that was trans-\n" in hugehelp()
5246 " size_header The total amount of bytes of the downloaded head-\n" in hugehelp()
5253 " This is the size of the body/data that was trans-\n" in hugehelp()
5258 " speed_download The average download speed that curl measured for\n" in hugehelp()
5261 " speed_upload The average upload speed that curl measured for\n" in hugehelp()
5265 " The result of the SSL peer certificate verifica-\n" in hugehelp()
5271 " stderr From this point on, the -w, --write-out output\n" in hugehelp()
5275 " stdout From this point on, the -w, --write-out output\n" in hugehelp()
5283 " The time, in seconds, it took from the start un-\n" in hugehelp()
5284 " til the SSL/SSH/etc connect/handshake to the re-\n" in hugehelp()
5287 " time_connect The time, in seconds, it took from the start un-\n" in hugehelp()
5294 " The time, in seconds, it took from the start un-\n" in hugehelp()
5298 " The time, in seconds, it took from the start un-\n" in hugehelp()
5302 " This includes all pre-transfer commands and nego-\n" in hugehelp()
5303 " tiations that are specific to the particular pro-\n" in hugehelp()
5306 " time_redirect The time, in seconds, it took for all redirection\n" in hugehelp()
5311 " started. time_redirect shows the complete execu-\n" in hugehelp()
5312 " tion time for multiple redirections.\n" in hugehelp()
5315 " The time, in seconds, it took from the start un-\n" in hugehelp()
5316 " til the first byte was just about to be trans-\n" in hugehelp()
5318 " the time the server needed to calculate the re-\n" in hugehelp()
5323 " time_total The total time, in seconds, that the full opera-\n" in hugehelp()
5328 " urlnum The URL index number of this transfer, 0-indexed.\n" in hugehelp()
5329 " De-globbed URLs share the same index number as\n" in hugehelp()
5334 " url_effective The URL that was fetched last. This is most mean-\n" in hugehelp()
5335 " ingful if you have told curl to follow location:\n" in hugehelp()
5341 " curl -w '%{http_code}\\n' https://example.com\n" in hugehelp()
5343 " --xattr\n" in hugehelp()
5344 " When saving output to a file, this option tells curl to store\n" in hugehelp()
5348 " the URL is stored in the xdg.origin.url attribute and, for HTTP,\n" in hugehelp()
5354 " curl --xattr -o storage https://example.com\n" in hugehelp()
5360 " Default config file, see -K, --config for details.\n" in hugehelp()
5368 " using the -x, --proxy option.\n" in hugehelp()
5371 " Sets the proxy server to use for HTTP.\n" in hugehelp()
5375 " Sets the proxy server to use for HTTPS.\n" in hugehelp()
5377 " [url-protocol]_PROXY [protocol://]<host>[:port]\n" in hugehelp()
5378 " Sets the proxy server to use for [url-protocol], where the pro-\n" in hugehelp()
5379 " tocol is a protocol that curl supports and as specified in a\n" in hugehelp()
5383 " Sets the proxy server to use if no protocol-specific proxy is\n" in hugehelp()
5388 " NO_PROXY <comma-separated list of hosts/domains>\n" in hugehelp()
5391 " list is matched as either a domain name which contains the host-\n" in hugehelp()
5397 " specified with the -x, --proxy option. That is NO_PROXY=di-\n" in hugehelp()
5398 " rect.example.com curl -x http://proxy.example.com http://di-\n" in hugehelp()
5400 " NO_PROXY=direct.example.com curl -x http://proxy.example.com\n" in hugehelp()
5404 " The list of host names can also be include numerical IP ad-\n" in hugehelp()
5407 " dresses, and IPv6 versions should then be given without enclos-\n" in hugehelp()
5415 " If curl was built with support for \"MultiSSL\", meaning that it\n" in hugehelp()
5418 " has built-in support for more than one TLS backend, this envi-\n" in hugehelp()
5420 " particular backend to use when curl is invoked. Setting a name\n" in hugehelp()
5421 " that is not a built-in alternative will make curl stay with the\n" in hugehelp()
5424 " SSL backend names (case-insensitive): bearssl, gnutls, gskit,\n" in hugehelp()
5425 " mbedtls, mesalink, nss, openssl, rustls, schannel, secure-trans-\n" in hugehelp()
5431 " If curl was built with HTTP/3 support, setting this environment\n" in hugehelp()
5432 " variable to a local directory will make curl produce qlogs in\n" in hugehelp()
5440 " If you set this environment variable to a file name, curl will\n" in hugehelp()
5442 " to enable you to analyze the TLS traffic in real time using net-\n" in hugehelp()
5443 " work analyzing tools such as Wireshark. This works with the fol-\n" in hugehelp()
5459 " Makes it use it as an HTTP proxy. The default if no scheme pre-\n" in hugehelp()
5468 " Makes it the equivalent of --socks4\n" in hugehelp()
5471 " Makes it the equivalent of --socks4a\n" in hugehelp()
5474 " Makes it the equivalent of --socks5\n" in hugehelp()
5477 " Makes it the equivalent of --socks5-hostname\n" in hugehelp()
5480 " There are a bunch of different error codes and their corresponding er-\n" in hugehelp()
5486 " 1 Unsupported protocol. This build of curl has no support for this\n" in hugehelp()
5493 " 4 A feature or option that was needed to perform the desired re-\n" in hugehelp()
5494 " quest was not enabled or was explicitly disabled at build-time.\n" in hugehelp()
5497 " To make curl able to do this, you probably need another build of\n" in hugehelp()
5500 " 5 Could not resolve proxy. The given proxy host could not be re-\n" in hugehelp()
5503 " 6 Could not resolve host. The given remote host could not be re-\n" in hugehelp()
5508 " 8 Weird server reply. The server sent data curl could not parse.\n" in hugehelp()
5517 " 10 FTP accept failed. While waiting for the server to connect back\n" in hugehelp()
5523 " 11 FTP weird PASS reply. Curl could not parse the reply sent to the\n" in hugehelp()
5526 " 12 During an active FTP session while waiting for the server to\n" in hugehelp()
5527 " connect back to curl, the timeout expired.\n" in hugehelp()
5529 " 13 FTP weird PASV reply, Curl could not parse the reply sent to the\n" in hugehelp()
5532 " 14 FTP weird 227 format. Curl could not parse the 227-line the\n" in hugehelp()
5538 " 227-line.\n" in hugehelp()
5542 " see the error message for details.\n" in hugehelp()
5551 " 19 FTP could not download/access the given file, the RETR (or simi-\n" in hugehelp()
5555 " 22 HTTP page not retrieved. The requested url was not found or re-\n" in hugehelp()
5557 " above. This return code only appears if -f, --fail is used.\n" in hugehelp()
5561 " 23 Write error. Curl could not write data to a local filesystem or\n" in hugehelp()
5565 " used for FTP uploading.\n" in hugehelp()
5571 " 28 Operation timeout. The specified time-out period was reached ac-\n" in hugehelp()
5577 " support the PORT command, try doing a transfer using PASV in-\n" in hugehelp()
5581 " used for resumed FTP transfers.\n" in hugehelp()
5585 " 34 HTTP post error. Internal post-request generation error.\n" in hugehelp()
5591 " 36 Bad download resume. Could not continue an earlier aborted down-\n" in hugehelp()
5602 " 42 Aborted by callback. An application told curl to abort the oper-\n" in hugehelp()
5612 " 47 Too many redirects. When following redirects, curl hit the maxi-\n" in hugehelp()
5616 " passed a weird option to curl that was passed on to libcurl and\n" in hugehelp()
5641 " 60 Peer certificate cannot be authenticated with known CA certifi-\n" in hugehelp()
5658 " 67 The user name, password, or similar was not accepted and curl\n" in hugehelp()
5721 " message for details.\n" in hugehelp()
5723 " 96 QUIC connection error. This error may be caused by an SSL li-\n" in hugehelp()
5724 " brary error. QUIC is the protocol used for HTTP/3 transfers.\n" in hugehelp()
5726 " XX More error codes will appear here in future releases. The exist-\n" in hugehelp()
5736 " https://curl.se\n" in hugehelp()
5744 /* built-in manual is disabled, blank function */
5757 /* This mumbo-jumbo is the huge help text compressed with gzip.
5760 texts by NOT passing -c to the mkhelp.pl tool. */
10425 /* Decompress and send to stdout a gzip-compressed buffer */
10440 z.avail_in = (unsigned int)(sizeof(hugehelpgz) - headerlen); in hugehelp()
10443 if (inflateInit2(&z, -MAX_WBITS) != Z_OK) in hugehelp()
10453 fwrite(buf, BUF_SIZE - z.avail_out, 1, stdout); in hugehelp()
10465 /* built-in manual is disabled, blank function */