summaryrefslogtreecommitdiff
path: root/docs/HTTP-COOKIES.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/HTTP-COOKIES.md')
-rw-r--r--docs/HTTP-COOKIES.md18
1 files changed, 18 insertions, 0 deletions
diff --git a/docs/HTTP-COOKIES.md b/docs/HTTP-COOKIES.md
index 06790f8a7..62367c2a9 100644
--- a/docs/HTTP-COOKIES.md
+++ b/docs/HTTP-COOKIES.md
@@ -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