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 -v –key {{key.pem}} –cacert {{ca.pem}} –cert {{client.pem}} -k {{https://localhost}}`