Lines Matching full:curl
10 1.1 What is cURL?
12 1.3 What is curl not?
13 1.4 When will you make curl do XXXX ?
14 1.5 Who makes curl?
15 1.6 What do you get for making curl?
16 1.7 What about CURL from curl.com?
18 1.9 Where do I buy commercial support for curl?
19 1.10 How many are using curl?
22 1.13 curl's ECCN number?
28 2.2 Does curl work/build with other SSL libraries?
29 2.4 Does curl support SOCKS (RFC 1928) ?
32 3.1 curl: (1) SSL is disabled, https: not supported
33 3.2 How do I tell curl to resume a transfer?
35 3.4 How do I tell curl to run custom FTP commands?
37 3.6 Does curl support ASP, XML, XHTML or HTML version Y?
38 3.7 Can I use curl to delete/rename a file through FTP?
39 3.8 How do I tell curl to follow HTTP redirects?
40 3.9 How do I use curl in my favorite programming language?
45 3.14 Does curl support JavaScript or PAC (automated proxy config)?
46 3.15 Can I do recursive fetches with curl?
49 3.18 Can I use curl to send a POST/PUT and not wait for a response?
53 3.22 curl -X gives me HTTP problems
67 4.7 How do I keep user names and passwords secret in curl command lines?
69 4.9 curl cannot authenticate to a server that requires NTLM?
73 4.13 Why is curl -R on Windows one hour off?
74 4.14 Redirects work in browser but not with curl
79 4.19 Why does not curl return an error when the network cable is unplugged?
80 4.20 curl does not return error for HTTP non-200 responses
107 6.5 Can I modify curl/libcurl for my program and keep the changes secret?
108 6.6 Can you please change the curl/libcurl license to XXXX?
111 7. PHP/CURL Issues
112 7.1 What is PHP/CURL?
113 7.2 Who wrote PHP/CURL?
115 7.4 Does PHP/CURL have dependencies?
118 8.1 Why does curl use C89?
119 8.2 Will curl be rewritten?
125 1.1 What is cURL?
127 cURL is the name of the project. The name is a play on 'Client for URLs',
131 version: "curl URL Request Library".
133 The cURL project produces two products:
155 curl
159 Since curl uses libcurl, curl supports the same wide range of common
162 We pronounce curl with an initial k sound. It rhymes with words like girl
168 curl in the project names in various combinations, but you should take
169 notice that this FAQ is directed at the command-line tool named curl (and
170 libcurl the library), and may therefore not be valid for other curl-related
171 projects. (There is however a small section for the PHP/CURL in this FAQ.)
185 1.3 What is curl not?
187 curl is not a wget clone. That is a common misconception. Never, during
188 curl's development, have we intended curl to replace wget or compete on its
189 market. curl is targeted at single-shot file transfers.
191 curl is not a website mirroring program. If you want to use curl to mirror
192 something: fine, go ahead and write a script that wraps around curl or use
195 curl is not an FTP site mirroring program. Sure, get and send FTP with curl
199 curl is not a PHP tool, even though it works perfectly well when used from
200 or with PHP (when using the PHP/CURL module).
202 curl is not a program for a single operating system. curl exists, compiles,
207 1.4 When will you make curl do XXXX ?
209 We love suggestions of what to change in order to make curl and libcurl
211 curl:
213 curl -- the command line tool -- is to remain a non-graphical command line
217 We do not add things to curl that other small and available tools already do
218 well at the side. curl's output can be piped into another program or
222 magic with the supported protocols than curl currently does, chances are
227 considerable time already on maintaining and developing curl. In order to
230 https://github.com/curl/curl, fork the project, and create pull requests
233 If you write the code, chances are better that it will get into curl faster.
235 1.5 Who makes curl?
237 curl and libcurl are not made by any single individual. Daniel Stenberg is
245 curl is developed by a community, with Daniel at the wheel.
247 1.6 What do you get for making curl?
249 Project cURL is entirely free and open. We do this voluntarily, mostly in
250 our spare time. Companies may pay individual developers to work on curl.
251 This is not controlled by nor supervised in any way by the curl project.
255 tracker at https://github.com/curl/curl. Also again, some companies have
262 See also: https://curl.se/sponsors.html
264 1.7 What about CURL from curl.com?
266 During the summer of 2001, curl.com was busy advertising their client-side
267 programming language for the web, named CURL.
269 We are in no way associated with curl.com or their CURL programming
272 Our project name curl has been in effective use since 1998. We were not the
273 first computer related project to use the name "curl" and do not claim any
276 We recognize that we will be living in parallel with curl.com and wish them
282 curl-related questions on a suitable mailing list. All available mailing
284 https://curl.se/mail/
286 Keeping curl-related questions and discussions on mailing lists allows
293 If you have found or simply suspect a security problem in curl or libcurl,
294 submit all the details at https://hackerone.one/curl. On there we keep the
300 Security issues can also be taking to the curl security team by emailing
301 security at curl.se (closed list of receivers, mails are not disclosed).
303 1.9 Where do I buy commercial support for curl?
305 curl is fully open source. It means you can hire any skilled engineer to fix
306 your curl-related problems.
308 We list available alternatives on the curl website:
309 https://curl.se/support.html
311 1.10 How many are using curl?
315 We do not know how many users that knowingly have installed and use curl.
317 We do not know how many users that use curl without knowing that they are in
320 We do not know how many users that downloaded or installed curl and then
323 In 2020, we estimate that curl runs in roughly ten billion installations
328 In the cURL project we have decided not to attempt to keep this file updated
336 be a lot better than a private curl version.
341 for this purpose: https://curl.se/docs/caextract.html
345 There is a bunch of friendly people hanging out in the #curl channel on the
349 1.13 curl's ECCN number?
358 We believe curl's number might be ECCN 5D002, another possibility is
374 "pull requests" on GitHub: https://github.com/curl/curl/pulls
377 the curl-library mailing list. We are many subscribers there and there are
418 2.2 Does curl work with other SSL libraries?
420 curl has been written to use a generic SSL function layer internally, and
424 curl can be built to use one of the following SSL alternatives: OpenSSL,
428 maintain a comparison of them here: https://curl.se/docs/ssl-compared.html
430 2.4 Does curl support SOCKS (RFC 1928) ?
436 3.1 curl: (1) SSL is disabled, https: not supported
439 it means that the instance of curl/libcurl that you are using was built
443 could not find all libs and include files curl requires for SSL to work. If
444 the configure script fails to find them, curl is simply built without SSL
447 To get the https:// support into a curl that was previously built but that
455 3.2 How do I tell curl to resume a transfer?
457 curl supports resumed transfers both ways on both FTP and HTTP.
463 the HTTP operation you need curl to do and what the web server that will
477 3.4 How do I tell curl to run custom FTP commands?
479 You can tell curl to perform optional commands both before and/or after a
482 Since curl is used for file transfers, you do not normally use curl to
493 3.6 Does curl support ASP, XML, XHTML or HTML version Y?
495 To curl, all contents are alike. It does not matter how the page was
497 files. There is no difference to curl and it does not even know what kind of
502 3.7 Can I use curl to delete/rename a file through FTP?
508 curl -O ftp://download.com/coolfile -Q '-DELE coolfile'
512 curl -T infile ftp://upload.com/dir/ -Q "-RNFR infile" -Q "-RNTO newname"
514 3.8 How do I tell curl to follow HTTP redirects?
516 curl does not follow so-called redirects by default. The Location: header
520 curl -L http://redirector.com
524 3.9 How do I use curl in my favorite programming language?
527 curl without having to use the command line tool. If you are fluent in such
530 Find out more about which languages that support curl directly, and how to
531 install and use them, in the libcurl section of the curl website:
532 https://curl.se/libcurl/
535 outside of the cURL project. The cURL project itself only produces libcurl
537 about bindings on the curl-library list too, but be prepared that people on
551 curl adheres to the HTTP spec, which basically means you can play with *any*
564 curl -d "datatopost" -H "Content-Type: text/xml" [URL]
583 curl -d " with spaces " url.com
587 curl -d ' with spaces ' url.com
597 because curl is not a powershell script. You may or may not be able to use
602 the curl docs will use a mix of both of these as shown above. You must
605 Remember that curl works and runs on more operating systems than most single
608 3.14 Does curl support JavaScript or PAC (automated proxy config)?
610 Many web pages do magic stuff using embedded JavaScript. curl and libcurl
617 the name of the proxy to connect to. Since curl does not support JavaScript,
632 3.15 Can I do recursive fetches with curl?
634 No. curl itself has no code that performs recursive operations, such as
639 it, but the command line tool curl itself cannot.
644 talk about using SSL-based protocols (HTTPS or FTPS) using curl or libcurl.
665 bundle. curl does not come with a CA cert bundle but most curl installs
670 certificate. Server certificate verification is enabled by default in curl
673 (https://curl.se/docs/sslcerts.html). Server certificates that are
684 curl ftp://ftp.sunet.se/%2ftmp/
689 curl ftp://ftp.sunet.se//tmp/
691 3.18 Can I use curl to send a POST/PUT and not wait for a response?
706 curl --header "Host: www.example.com" http://127.0.0.1/
708 You can also opt to add faked host name entries to curl with the --resolve
712 curl --resolve www.example.com:80:127.0.0.1 http://www.example.com/
723 curl -O -u user:password sftp://example.com/~/file.txt
727 curl -O -u user:password scp://example.com/~/file.txt
731 When passing on a URL to curl to use, it may respond that the particular
733 is phrased is because curl does not make a distinction internally of whether
735 knows how to speak that protocol) or if it was explicitly disabled. curl can
743 3.22 curl -X gives me HTTP problems
747 By default you use curl without explicitly saying which request method to
749 "curl http://example.com" it will use GET. If you use -d or -F curl will use
752 If for whatever reason you are not happy with these default choices that curl
754 [WHATEVER]. This way you can for example send a DELETE by doing "curl -X
757 It is thus pointless to do "curl -XGET [URL]" as GET would be used
758 anyway. In the same vein it is pointless to do "curl -X POST -d data
760 request-body in a GET request with something like "curl -X GET -d data
763 Note that -X does not actually change curl's behavior as it only modifies the
768 a 303 redirect, you will effectively prevent curl from behaving
784 curl 'http://www.altavista.com/cgi-bin/query?text=yes&q=curl'
797 a URL specified to curl you must quote them.
801 curl '{curl,www}.haxx.se'
804 them for the curl URL "globbing" system), use the -g/--globoff option:
806 curl -g 'www.site.com/weirdname[].html'
810 curl asks remote servers for the page you specify. If the page does not exist
815 By using the --fail option you can tell curl explicitly to not get any data
861 All curl error codes are described at the end of the man page, in the
865 that curl has exited due to a crash. This is a serious error, and we
869 4.7 How do I keep user names and passwords secret in curl command lines?
875 avoided by using the "-K" option to tell curl to read parameters from a file
876 or stdin to which you can pass the secret info. curl itself will also
881 not a task that curl addresses. You could of course encrypt them somehow to
903 4.9 curl cannot authenticate to a server that requires NTLM?
916 software you are trying to interact with. This is not anything curl can do
926 When you invoke curl and get an error 60 error back it means that curl
927 could not verify that the server's certificate was good. curl verifies the
942 fails in curl. When this happens, the reason is usually that the server
951 https://curl.se/docs/sslcerts.html
953 4.13 Why is curl -R on Windows one hour off?
955 Since curl 7.53.0 this issue should be fixed as long as curl was built with
957 compilers or prior curl versions it may set a time that appears one hour off.
962 4.14 Redirects work in browser but not with curl
964 curl supports HTTP redirects well (see item 3.8). Browsers generally support
965 at least two other ways to perform redirects that curl does not:
973 There is no way to make curl follow these redirects. You must either
979 curl supports FTPS (sometimes known as FTP-SSL) both implicit and explicit
982 When a URL is used that starts with FTPS://, curl assumes implicit SSL on
1018 anything else. This will make (lib)curl to consider the connection connected
1023 When using curl to try to download a local file, one might use a URL
1028 you will find that even if D:\blah.txt does exist, curl returns a 'file
1034 host component, and is taken away. Thus, curl tries to open '/blah.txt'.
1047 In either case, curl should now be looking for the correct file.
1049 4.19 Why does not curl return an error when the network cable is unplugged?
1061 for it to detect an issue. The curl option --keepalive-time enables
1068 do not use TCP. To handle those situations, curl offers a number of timeouts
1079 4.20 curl does not return error for HTTP non-200 responses
1083 When doing HTTP transfers, curl will perform exactly what you are asking it
1084 to do and if successful it will not return an error. You can use curl to
1090 curl. It simply sends and delivers HTTP as you asked and if that worked,
1092 higher level error information that curl does not care about. The error was
1097 message, curl has a dedicated option for that: -f (CURLOPT_FAILONERROR in
1116 https://curl.se/libcurl/c/threadsafe.html
1177 curl and libcurl have excellent support for persistent connections when
1178 transferring several files from the same server. curl will attempt to reuse
1346 curl -s ftp.funet.fi/pub/ -X MLSD | \
1349 curl -s ftp.kernel.org/pub/linux/kernel/ | \
1398 curl and libcurl are released under a MIT/X derivative license. The license
1434 6.5 Can I modify curl/libcurl for my program and keep the changes secret?
1442 6.6 Can you please change the curl/libcurl license to XXXX?
1449 we want on curl/libcurl and it does not spread to other programs or
1451 curl in their projects, no matter what license they already have in use.
1472 As can be seen here: https://curl.se/docs/companies.html and elsewhere,
1477 7. PHP/CURL Issues
1479 7.1 What is PHP/CURL?
1481 The module for PHP that makes it possible for PHP programs to access curl-
1484 In the cURL project we call this module PHP/CURL to differentiate it from
1485 curl the command line tool and libcurl the library. The PHP team however
1487 CURL (often using all caps) or sometimes ext/curl, but both cause much
1490 7.2 Who wrote PHP/CURL?
1492 PHP/CURL was initially written by Sterling Hughes.
1503 7.4 Does PHP/CURL have dependencies?
1505 PHP/CURL is a module that comes with the regular PHP package. It depends on
1507 PHP/CURL can be used.
1511 8.1 Why does curl use C89?
1513 As with everything in curl, there is a history and we keep using what we have
1528 8.2 Will curl be rewritten?
1533 Every now and then the urge apparently arises to request that we rewrite curl
1536 Some the most important properties in curl are maintaining the API and ABI