curl/docs/cmdline-opts/cookie-jar.md
Daniel Stenberg 6e494a2390
docs: more language cleanups
- present tense
- avoid bad words

Closes #13003
2024-02-27 16:19:43 +01:00

1.3 KiB

c SPDX-License-Identifier Short Long Arg Protocols Help Category Added Multi See-also Example
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. curl c cookie-jar <filename> HTTP Write cookies to <filename> after operation http 7.9 single
cookie
-c store-here.txt $URL
-c store-here.txt -b read-these $URL

--cookie-jar

Specify to which file you want curl to write all cookies after a completed operation. Curl writes all cookies from its in-memory cookie storage to the given file at the end of operations. If no cookies are known, no data is written. The file is created using the Netscape cookie file format. If you set the filename to a single dash, "-", the cookies are written to stdout.

The file specified with --cookie-jar is only used for output. No cookies are read from the file. To read cookies, use the --cookie option. Both options can specify the same file.

This command line option activates the cookie engine that makes curl record and use cookies. The --cookie option also activates it.

If the cookie jar cannot be created or written to, the whole curl operation does not fail or even report an error clearly. Using --verbose gets a warning displayed, but that is the only visible feedback you get about this possibly lethal situation.