tldr/pages/common/curl.md

# curl

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

- Download a URL to a file:

`curl "{{URL}}" -o {{filename}}`

- Send form-encoded data:

`curl --data {{name=bob}} {{http://localhost/form}}`

- Send JSON data:

`curl -X POST -H "Content-Type: application/json" -d {{'{"name":"bob"}'}} {{http://localhost/login}}`

- Specify an HTTP method:

`curl -X {{DELETE}} {{http://localhost/item/123}}`

- Head request:

`curl --head {{http://localhost}}`

- Include an extra header:

`curl -H "{{X-MyHeader: 123}}" {{http://localhost}}`

- Pass a user name and password for server authentication:

`curl -u myusername:mypassword {{http://localhost}}`

- Pass client certificate and key for a secure resource:

`curl -v -key {{key.pem}} -cacert {{ca.pem}} -cert {{client.pem}} -k {{https://localhost}}`
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.`
			`> Supports most protocols including HTTP, FTP, POP.`
initial commit 2013-12-08 08:56:16 +00:00
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`- Download a 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: fix example according to style guide. 2016-01-06 11:05:23 +00:00			`curl "{{URL}}" -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
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`- Send form-encoded data:`
initial commit 2013-12-08 08:56:16 +00:00
Markdown format closer to the output + highlight replacable tokens 2013-12-09 11:12:16 +00:00			`curl --data {{name=bob}} {{http://localhost/form}}`
initial commit 2013-12-08 08:56:16 +00:00
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`- Send JSON data:`
initial commit 2013-12-08 08:56:16 +00:00
Markdown format closer to the output + highlight replacable tokens 2013-12-09 11:12:16 +00:00			`curl -X POST -H "Content-Type: application/json" -d {{'{"name":"bob"}'}} {{http://localhost/login}}`
initial commit 2013-12-08 08:56:16 +00:00
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`- Specify an HTTP method:`
initial commit 2013-12-08 08:56:16 +00:00
Markdown format closer to the output + highlight replacable tokens 2013-12-09 11:12:16 +00:00			`curl -X {{DELETE}} {{http://localhost/item/123}}`
initial commit 2013-12-08 08:56:16 +00:00
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`- Head request:`
initial commit 2013-12-08 08:56:16 +00:00
Update curl.md Only including the HEAD change 2016-01-22 23:33:32 +00:00			`curl --head {{http://localhost}}`
Add user password -u option to Curl 2014-03-11 15:01:45 +00:00
Merge branch 'curl-header' of git://github.com/jamescarlos/tldr into jamescarlos-curl-header 2016-01-12 19:33:40 +00:00			`- Include an extra header:`
curl: add --header example 2016-01-12 19:24:22 +00:00
-H instead of --head for cURL, adding verbose output 2016-01-19 18:09:42 +00:00			`curl -H "{{X-MyHeader: 123}}" {{http://localhost}}`
curl: add --header example 2016-01-12 19:24:22 +00:00
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00: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 -u myusername:mypassword {{http://localhost}}`
Client certificate in cUrl example 2016-01-28 12:12:55 +00:00
			`- Pass client certificate and key for a secure resource:`

curl: hyphen instead of en dash (#857) 2016-04-26 18:28:44 +01:00			`curl -v -key {{key.pem}} -cacert {{ca.pem}} -cert {{client.pem}} -k {{https://localhost}}`