romenskiy2012/curl
1
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2026-08-25 12:03:39 +03:00
Code Issues Projects Releases Packages Wiki Activity

HTTP-COOKIES.md: describe the cookie file format

Browse source 
... and refer to that file from from CURLOPT_COOKIEFILE.3 and
CURLOPT_COOKIELIST.3

Assisted-by: Jay Satiro
Reported-by: bsammon on github
Fixes #4805
Closes #4806
This commit is contained in:
Daniel Stenberg 2020-01-10 22:53:05 +01:00
parent 4ccf7622db
commit 9d1a0922b7
No known key found for this signature in database
GPG key ID: 5CC908FDB71E12C2
3 changed files with 28 additions and 2 deletions
Download patch file Download diff file Expand all files Collapse all files

18
docs/HTTP-COOKIES.md
View file

@ -43,6 +43,24 @@
When libcurl saves a cookiejar, it creates a file header of its own in which
there is a URL mention that will link to the web version of this document.
## Cookie file format
The cookie file format is text based and stores one cookie per line. Lines
that start with `#` are treated as comments.
Each line that each specifies a single cookie consists of seven text fields
separated with TAB characters.
|Field| Type | Example | Meaning |
|---|---------|-------------|-----------------------------------------------|
| 0 | string | example.com | Domain name |
| 1 | boolean | FALSE | Include subdomains |
| 2 | string | /foobar/ | Path |
| 3 | boolean | TRUE | Send/receive over HTTPS only |
| 4 | number | 1462299217 | Expires at – seconds since Jan 1st 1970, or 0 |
| 5 | string | person | Name of the cookie |
| 6 | string | daniel | Value of the cookie |
## Cookies with curl the command line tool
curl has a full cookie "engine" built in. If you just activate it, you can