ce6e3e5320
Since "too old" versions are no longer included in the generated man page, this field is now mandatory so that it won't be forgotten and then not included in the documentation. Closes #7786
38 lines
1.6 KiB
D
38 lines
1.6 KiB
D
Short: b
|
|
Long: cookie
|
|
Arg: <data|filename>
|
|
Protocols: HTTP
|
|
Help: Send cookies from string/file
|
|
Category: http
|
|
Example: -b cookiefile $URL
|
|
Example: -b cookiefile -c cookiefile $URL
|
|
Added: 4.9
|
|
---
|
|
Pass the data to the HTTP server in the Cookie header. It is supposedly
|
|
the data previously received from the server in a "Set-Cookie:" line. The
|
|
data should be in the format "NAME1=VALUE1; NAME2=VALUE2".
|
|
|
|
If no '=' symbol is used in the argument, it is instead treated as a filename
|
|
to read previously stored cookie from. This option also activates the cookie
|
|
engine which will make curl record incoming cookies, which may be handy if
|
|
you're using this in combination with the --location option or do multiple URL
|
|
transfers on the same invoke. If the file name is exactly a minus ("-"), curl
|
|
will instead read the contents from stdin.
|
|
|
|
The file format of the file to read cookies from should be plain HTTP headers
|
|
(Set-Cookie style) or the Netscape/Mozilla cookie file format.
|
|
|
|
The file specified with --cookie is only used as input. No cookies will be
|
|
written to the file. To store cookies, use the --cookie-jar option.
|
|
|
|
If you use the Set-Cookie file format and don't specify a domain then the
|
|
cookie is not sent since the domain will never match. To address this, set a
|
|
domain in Set-Cookie line (doing that will include sub-domains) or preferably:
|
|
use the Netscape format.
|
|
|
|
This option can be used multiple times.
|
|
|
|
Users very often want to both read cookies from a file and write updated
|
|
cookies back to a file, so using both --cookie and --cookie-jar in the same
|
|
command line is common.
|