Difference between revisions of "CURL"

From wikieduonline
Jump to navigation Jump to search
 
(60 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 
{{lowercase title}}  
 
{{lowercase title}}  
[[w:CURL (software)|cURL]]<ref>http://man7.org/linux/man-pages/man1/curl.1.html</ref> is a command-line tool for getting or sending data including files using URL syntax. cURL supports a range of common network protocols, currently including HTTP, HTTPS, FTP, FTPS, SCP, SFTP, TFTP, LDAP, DAP, DICT, TELNET, FILE, IMAP, POP3, SMTP and RTSP.
+
[[wikipedia:CURL|cURL]] ([[1996]]) <ref>http://man7.org/linux/man-pages/man1/curl.1.html</ref> is a command-line tool for getting or sending data including files using URL syntax. cURL supports a range of common network protocols, currently including HTTP, HTTPS, FTP, FTPS, SCP, SFTP, TFTP, LDAP, DAP, DICT, TELNET, FILE, IMAP, POP3, SMTP and RTSP.
  
 +
[[brew install curl]]
 +
[[apt install curl]]
  
== Basic Usage ==
+
== Examples ==
 +
* <code>[[curl --help]]</code>
 +
* <code>curl -vvv https://google.com</code>
 +
* <code>curl [[--insecure]] https://yourdomain.com</code>
 +
* <code>curl https://google.com/file_to_download -o output_file_name</code>
 
* <code>curl -sS https://google.com</code>
 
* <code>curl -sS https://google.com</code>
 +
::<code>-s [[--silent]] Avoid showing progress bar</code>
 +
::<code>-S --show-error</code>
 +
* <code>[[curl -sSL]]</code>
 +
::<code>[[-L]], --location follow redirects</code>
 
* <code>curl -u YOUR_USERNAME:YOUR_PASSWORD https://yourpasswordprotectedpage.com/</code>
 
* <code>curl -u YOUR_USERNAME:YOUR_PASSWORD https://yourpasswordprotectedpage.com/</code>
 
* Save your cookies and reuse them:
 
* Save your cookies and reuse them:
 
:<code>curl --user user:pass --cookie-jar ./somefile_with_your_cookies https://xyz.com/a</code>
 
:<code>curl --user user:pass --cookie-jar ./somefile_with_your_cookies https://xyz.com/a</code>
 
:<code>curl --cookie ./omefile_with_your_cookiese https://xyz.com/b</code>
 
:<code>curl --cookie ./omefile_with_your_cookiese https://xyz.com/b</code>
*<code>curl --header 'X-JFrog-Art-Api: 1234567890'</code>
+
* <code>[[curl --header]] 'X-JFrog-Art-Api: 1234567890'</code>
 +
* <code>curl --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/notification_settings</code><ref>https://docs.gitlab.com/ee/api/notification_settings.html#global-notification-settings</ref>
 +
* <code>[[curl -Is]] https://yourdomain.com/ | head -1</code>
 +
 
 +
* <code>-m, [[--max-time]]</code>
 +
* <code>[[curl --compressed]]</code>
 +
 
 +
* Upload a file:
 +
:<code>curl -u YOUR_USERNAME:YOUR_PASSWORD -T FILE_TO_UPLOAD https://yourpasswordprotectedpage.com/your_destionation</code>
 +
::<code>-T, --upload-file <file></code>
 +
 
 +
* [[Display HTTP response headers]]:
 +
: <code>curl -sD - -o /dev/null http://example.com</code><ref>https://stackoverflow.com/questions/3252851/how-to-display-request-headers-with-command-line-curl</ref>
 +
::-s  Avoid showing progress bar
 +
::-D  Dump headers to a file, but - sends it to stdout
 +
::-o /dev/null  Ignore response body
 +
 
 +
* <code>curl -XDELETE localhost:[[9200]]/index/type/documentID (Invoke-WebRequest -method DELETE http://localhost:9200/_all)</code>
 +
 
 +
 
 +
Offers the same features to fetch remote banner information from HTTP servers:
 +
 
 +
<code> curl -s -I 192.168.0.15 | grep -e "Server: "</code>
 +
 
 +
Other options:
 +
-k, --insecure To accept [[self signed certificate]]
 +
-L, --location
  
 
== Advance usage==
 
== Advance usage==
* Use cURL to measure request and response times: https://stackoverflow.com/a/22625150
+
* Use cURL to measure request and response times: https://stackoverflow.com/a/22625150  
 
+
::<code>curl -o /dev/null -s -w 'Total: %{time_total}s\n'  https://www.google.com</code>
  
 +
== Errors ==
 +
* <code>[[curl: (52) Empty reply from server]]</code>
 +
* <code>[[CURL Error (7): couldn't connect to host]]</code>
 +
* <code>[[curl: (35) OpenSSL SSL connect: SSL ERROR SYSCALL in connection to]]</code>
 +
* <code>[[curl: (47) Maximum (50) redirects followed]]</code>
  
 +
== Related terms ==
 +
* [[JSON]]
 +
* <code>[[opensearch-cli curl]]</code>
 +
* [[Elasticsearch curl URLs]]
 +
* [[Python requests]] library
 +
* [[Scraping]]
 +
* <code>[[get_url]]</code> [[ansible]]
 +
* <code>[[kubectl run -it --rm]] test --image=[[curlimages/curl]] --restart=Never [[--]] [[/bin/sh]]</code>
 +
* <code>[[pv]]</code>
 +
* <code>[[cast rpc]]</code>
  
 
== See also ==
 
== See also ==
* [[Netcat]]
+
* {{wget}}
* [[wget]]: <code>wget -r http://example.com/</code>  
+
* {{nc}}
* iwr (Invoke-WebRequest) [[PowerShell]] functionality
+
* <code>[[iwr]]</code> (Invoke-WebRequest) [[PowerShell]] functionality
* [[links (browser)]], [[lynx (browser)]], [[Elinks (browser)]] command line browsers
+
* {{lynx}}
  
 
[[Category:Linux]]
 
[[Category:Linux]]
 
[[Category:Networking]]
 
[[Category:Networking]]

Latest revision as of 08:34, 25 October 2024

cURL (1996) [1] is a command-line tool for getting or sending data including files using URL syntax. cURL supports a range of common network protocols, currently including HTTP, HTTPS, FTP, FTPS, SCP, SFTP, TFTP, LDAP, DAP, DICT, TELNET, FILE, IMAP, POP3, SMTP and RTSP.

brew install curl
apt install curl

Examples[edit]

-s --silent Avoid showing progress bar
-S --show-error
-L, --location follow redirects
curl --user user:pass --cookie-jar ./somefile_with_your_cookies https://xyz.com/a
curl --cookie ./omefile_with_your_cookiese https://xyz.com/b
  • Upload a file:
curl -u YOUR_USERNAME:YOUR_PASSWORD -T FILE_TO_UPLOAD https://yourpasswordprotectedpage.com/your_destionation
-T, --upload-file <file>
curl -sD - -o /dev/null http://example.com[3]
-s Avoid showing progress bar
-D Dump headers to a file, but - sends it to stdout
-o /dev/null Ignore response body


Offers the same features to fetch remote banner information from HTTP servers:

curl -s -I 192.168.0.15 | grep -e "Server: "

Other options:

-k, --insecure To accept self signed certificate
-L, --location

Advance usage[edit]

curl -o /dev/null -s -w 'Total: %{time_total}s\n' https://www.google.com

Errors[edit]

Related terms[edit]

See also[edit]

  • http://man7.org/linux/man-pages/man1/curl.1.html
  • https://docs.gitlab.com/ee/api/notification_settings.html#global-notification-settings
  • https://stackoverflow.com/questions/3252851/how-to-display-request-headers-with-command-line-curl
  • Advertising: