tldr/pages/common/curl.md

# curl

> Transfers data from or to a server.
> Supports most protocols including HTTP, FTP, POP3.

- 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):

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

- Send data, specifying a custom HTTP method, and including an extra header:

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

- Pass a user name and password for server authentication and show headers info only:

`curl -u myusername:mypassword -I {{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: 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			`> Supports most protocols including HTTP, FTP, POP3.`
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: 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 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: 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			`- Send form-encoded data (POST request of type application/x-www-form-urlencoded):`
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: 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			`- Send data, specifying a custom HTTP method, and including an extra header:`
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"}'}} -X {{PUT}} -H {{'Content-Type: application/json'}} {{http://example.com/users/1234}}`
curl: add --header example 2016-01-12 19:24:22 +00:00
curl: add -I option to the -u example (#1240) 2017-01-15 15:47:30 +00:00			`- Pass a user name and password for server authentication and show headers info only:`
Add user password -u option to Curl 2014-03-11 15:01:45 +00:00
curl: add -I option to the -u example (#1240) 2017-01-15 15:47:30 +00:00			`curl -u myusername:mypassword -I {{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}}`