curl-curl/docs/cmdline-opts/cookie-jar.md
Daniel Stenberg d8bad9926c
docs: mention umask need when curl creates files
for cookies, alt-svc and HSTS, command line and library

Closes #19396
2025-11-07 14:12:59 +01:00

1.5 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 Save cookies to <filename> after operation http 7.9 single
cookie
junk-session-cookies
-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. Even if no cookies are known, a file is created so that it removes any formerly existing cookies from the file. The file uses the Netscape cookie file format. If you set the filename to a single minus, "-", 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.

You may want to restrict your umask to prevent other users on the same system to access the created file.