romenskiy2012/curl
1
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2026-05-30 06:47:28 +03:00
Code Issues Projects Releases Packages Wiki Activity

cookie.d: Document use of empty string to enable cookie engine

Browse source 
- Explain that --cookie "" can be used to enable the cookie engine
  without reading any initial cookies.

As is documented in CURLOPT_COOKIEFILE.

Ref: https://curl.se/libcurl/c/CURLOPT_COOKIEFILE.html

Bug: https://github.com/curl/curl/issues/12643#issuecomment-1879844420
Reported-by: janko-js@users.noreply.github.com

Closes https://github.com/curl/curl/pull/12646
This commit is contained in:
Jay Satiro 2024-01-07 00:25:13 -05:00
parent ac4dbc9cb5
commit 0ad13e0618
1 changed files with 6 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

8
docs/cmdline-opts/cookie.d
View file

@ -6,6 +6,7 @@ Arg: <data|filename>
Protocols: HTTP
Help: Send cookies from string/file
Category: http
Example: -b "" $URL
Example: -b cookiefile $URL
Example: -b cookiefile -c cookiefile $URL
See-also: cookie-jar junk-session-cookies
@ -23,8 +24,11 @@ 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 makes curl record incoming cookies, which may be handy if you are
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
instead reads the contents from stdin.
transfers on the same invoke.
If the file name is exactly a minus ("-"), curl instead reads the contents from
stdin. If the file name is an empty string ("") and is the only cookie input,
curl will activate the cookie engine without any cookies.
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.