tldr/pages/common/curl.md

# curl

> Transfers data from or to a server.
> Supports most protocols, including HTTP, FTP, and POP3.
> More information: <https://curl.se>.

- Download the contents of an URL to a file:

`curl {{http://example.com}} -o {{filename}}`

- Download a file, saving the output under the filename indicated by the URL:

`curl -O {{http://example.com/filename}}`

- Download a file, following [L]ocation redirects, and automatically [C]ontinuing (resuming) a previous file transfer:

`curl -O -L -C - {{http://example.com/filename}}`

- Send form-encoded data (POST request of type `application/x-www-form-urlencoded`). Use `-d @file_name` or `-d @'-'` to read from STDIN:

`curl -d {{'name=bob'}} {{http://example.com/form}}`

- Send a request with an extra header, using a custom HTTP method:

`curl -H {{'X-My-Header: 123'}} -X {{PUT}} {{http://example.com}}`

- Send data in JSON format, specifying the appropriate content-type header:

`curl -d {{'{"name":"bob"}'}} -H {{'Content-Type: application/json'}} {{http://example.com/users/1234}}`

- Pass a user name and password for server authentication:

`curl -u myusername:mypassword {{http://example.com}}`

- Pass client certificate and key for a resource, skipping certificate validation:

`curl --cert {{client.pem}} --key {{key.pem}} --insecure {{https://example.com}}`
initial commit 2013-12-08 08:56:16 +00:00			`# curl`

Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`> Transfers data from or to a server.`
curl: remove -I from auth example (fixes #1406) (#1417) (also, minor tweaks to some of the descriptions) 2017-06-26 11:13:01 +01:00			`> Supports most protocols, including HTTP, FTP, and POP3.`
curl: update to new 'more information' link (#5254) 2021-02-07 20:27:41 +00:00			`> More information: <https://curl.se>.`
initial commit 2013-12-08 08:56:16 +00:00
curl: Add more download and rewrite data examples (#1023) - Download: first example introduces `-o`, second one introduces `-O`, third example introduces `-L` and `-C` using brackets as per #1018 - Data: first example introduces `-d` (default method is POST and default Content-Type is application/x-www-form-urlencoded), second example introduces `-X` and `-H` - Remove "Head request" - Expand description of "Send form-encoded data" example 2016-08-31 19:33:33 +01:00			`- Download the contents of an URL to a file:`
A bunch of new pages: common/: dig, gzip, rm, sort, zfs, zpool linux/: apt-get, shutdown osx/: airport, caffeinate, diskutil, networksetup open, pgrep, qlmanage, say, shutdown, sysctl, system_profiler Edits to existing pages: curl: Added simple download example find: Added iname and size exmaples grep: Edited -c description ps: Added wide lines example ssh: edited -D description, added simple port forwarding example unzip: added list option 2014-02-10 20:36:05 +00:00
curl: Add more download and rewrite data examples (#1023) - Download: first example introduces `-o`, second one introduces `-O`, third example introduces `-L` and `-C` using brackets as per #1018 - Data: first example introduces `-d` (default method is POST and default Content-Type is application/x-www-form-urlencoded), second example introduces `-X` and `-H` - Remove "Head request" - Expand description of "Send form-encoded data" example 2016-08-31 19:33:33 +01:00			`curl {{http://example.com}} -o {{filename}}`
A bunch of new pages: common/: dig, gzip, rm, sort, zfs, zpool linux/: apt-get, shutdown osx/: airport, caffeinate, diskutil, networksetup open, pgrep, qlmanage, say, shutdown, sysctl, system_profiler Edits to existing pages: curl: Added simple download example find: Added iname and size exmaples grep: Edited -c description ps: Added wide lines example ssh: edited -D description, added simple port forwarding example unzip: added list option 2014-02-10 20:36:05 +00:00
curl: remove -I from auth example (fixes #1406) (#1417) (also, minor tweaks to some of the descriptions) 2017-06-26 11:13:01 +01:00			`- Download a file, saving the output under the filename indicated by the URL:`
initial commit 2013-12-08 08:56:16 +00:00
curl: Add more download and rewrite data examples (#1023) - Download: first example introduces `-o`, second one introduces `-O`, third example introduces `-L` and `-C` using brackets as per #1018 - Data: first example introduces `-d` (default method is POST and default Content-Type is application/x-www-form-urlencoded), second example introduces `-X` and `-H` - Remove "Head request" - Expand description of "Send form-encoded data" example 2016-08-31 19:33:33 +01:00			`curl -O {{http://example.com/filename}}`
initial commit 2013-12-08 08:56:16 +00:00
curl: minor punctuation fix 2017-02-02 11:35:43 +00:00			`- Download a file, following [L]ocation redirects, and automatically [C]ontinuing (resuming) a previous file transfer:`
initial commit 2013-12-08 08:56:16 +00:00
curl: Add more download and rewrite data examples (#1023) - Download: first example introduces `-o`, second one introduces `-O`, third example introduces `-L` and `-C` using brackets as per #1018 - Data: first example introduces `-d` (default method is POST and default Content-Type is application/x-www-form-urlencoded), second example introduces `-X` and `-H` - Remove "Head request" - Expand description of "Send form-encoded data" example 2016-08-31 19:33:33 +01:00			`curl -O -L -C - {{http://example.com/filename}}`
initial commit 2013-12-08 08:56:16 +00:00
curl: explain -d example (#4183) 2020-07-21 21:27:14 +01:00			- Send form-encoded data (POST request of type `application/x-www-form-urlencoded`). Use `-d @file_name` or `-d @'-'` to read from STDIN:
initial commit 2013-12-08 08:56:16 +00:00
curl: Add more download and rewrite data examples (#1023) - Download: first example introduces `-o`, second one introduces `-O`, third example introduces `-L` and `-C` using brackets as per #1018 - Data: first example introduces `-d` (default method is POST and default Content-Type is application/x-www-form-urlencoded), second example introduces `-X` and `-H` - Remove "Head request" - Expand description of "Send form-encoded data" example 2016-08-31 19:33:33 +01:00			`curl -d {{'name=bob'}} {{http://example.com/form}}`
initial commit 2013-12-08 08:56:16 +00:00
curl: remove -I from auth example (fixes #1406) (#1417) (also, minor tweaks to some of the descriptions) 2017-06-26 11:13:01 +01:00			`- Send a request with an extra header, using a custom HTTP method:`
initial commit 2013-12-08 08:56:16 +00:00
curl: add separate entry for header & HTTP method; clarify entry for JSON (#1396) 2017-06-06 08:23:00 +01:00			`curl -H {{'X-My-Header: 123'}} -X {{PUT}} {{http://example.com}}`

			`- Send data in JSON format, specifying the appropriate content-type header:`

			`curl -d {{'{"name":"bob"}'}} -H {{'Content-Type: application/json'}} {{http://example.com/users/1234}}`
curl: add --header example 2016-01-12 19:24:22 +00:00
curl: remove -I from auth example (fixes #1406) (#1417) (also, minor tweaks to some of the descriptions) 2017-06-26 11:13:01 +01:00			`- Pass a user name and password for server authentication:`
Add user password -u option to Curl 2014-03-11 15:01:45 +00:00
curl: remove -I from auth example (fixes #1406) (#1417) (also, minor tweaks to some of the descriptions) 2017-06-26 11:13:01 +01:00			`curl -u myusername:mypassword {{http://example.com}}`
Client certificate in cUrl example 2016-01-28 12:12:55 +00:00
curl: tweak desc of last example, per code review 2017-04-19 19:25:38 +01:00			`- Pass client certificate and key for a resource, skipping certificate validation:`
Client certificate in cUrl example 2016-01-28 12:12:55 +00:00
curl: spell out the --insecure option 2017-04-19 10:22:34 +01:00			`curl --cert {{client.pem}} --key {{key.pem}} --insecure {{https://example.com}}`