diff options
| author | Daniel Stenberg <daniel@haxx.se> | 2020-02-18 14:23:04 +0100 |
|---|---|---|
| committer | Daniel Stenberg <daniel@haxx.se> | 2020-02-18 14:23:04 +0100 |
| commit | 268d47f4257bead8c756e0133185ad618dc8c2db (patch) | |
| tree | c6a6aa71627de84e8fa6f6924f03d8fb851b4058 | |
| parent | 3735107d62ad28d6e25bd94109ab9f2454c22116 (diff) | |
| download | curl-bagder/cookie-newline.tar.gz | |
HTTP-COOKIES: mention that a trailing newline is requiredbagder/cookie-newline
... so that we know we got the whole and not a partial line.
Also, changed the formatting of the fields away from a table again since
the table format requires a github-markdown tool version that we don't
run on the web server atm.
Reported-by: Sunny Bean
Fixes #4946
| -rw-r--r-- | docs/HTTP-COOKIES.md | 25 |
1 files changed, 14 insertions, 11 deletions
diff --git a/docs/HTTP-COOKIES.md b/docs/HTTP-COOKIES.md index 62367c2a9..31af9f6d9 100644 --- a/docs/HTTP-COOKIES.md +++ b/docs/HTTP-COOKIES.md @@ -49,17 +49,20 @@ 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 | + separated with TAB characters. A valid line must end with a newline + character. + +### Fields in the file + + Field number, what type and example data and the meaning of it: + + 0. string `example.com` - the 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 |