docs: mention umask need when curl creates files

for cookies, alt-svc and HSTS, command line and library

Closes #19396
This commit is contained in:
Daniel Stenberg 2025-11-07 13:42:36 +01:00
parent 891714acb4
commit d8bad9926c
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
7 changed files with 22 additions and 0 deletions

View File

@ -889,6 +889,7 @@ UI
UID
UIDL
Ultrix
umask
Unary
unassign
UNC

View File

@ -24,5 +24,8 @@ filename again if it has been modified.
Specify a "" filename (zero length) to avoid loading/saving and make curl just
handle the cache in memory.
You may want to restrict your umask to prevent other users on the same system
to access the created file.
If this option is used several times, curl loads contents from all the
files but the last one is used for saving.

View File

@ -37,3 +37,6 @@ 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.

View File

@ -28,5 +28,8 @@ performed.
Specify a "" filename (zero length) to avoid loading/saving and make curl just
handle HSTS in memory.
You may want to restrict your umask to prevent other users on the same system
to access the created file.
If this option is used several times, curl loads contents from all the
files but the last one is used for saving.

View File

@ -47,6 +47,10 @@ libcurl cannot fully protect against attacks where an attacker has write
access to the same directory where it is directed to save files. This is
particularly sensitive if you save files using elevated privileges.
libcurl creates the file to store the alt-svc cache in using default file
permissions, meaning that on *nix systems you may need to restrict your umask
to prevent other users on the same system to access the file.
# DEFAULT
NULL. The alt-svc cache is not read nor written to file.

View File

@ -58,6 +58,10 @@ libcurl cannot fully protect against attacks where an attacker has write
access to the same directory where it is directed to save files. This is
particularly sensitive if you save files using elevated privileges.
libcurl creates the file to store cookies using default file permissions,
meaning that on *nix systems you may need to restrict your umask to prevent
other users on the same system to access the file.
# DEFAULT
NULL

View File

@ -67,6 +67,10 @@ libcurl cannot fully protect against attacks where an attacker has write
access to the same directory where it is directed to save files. This is
particularly sensitive if you save files using elevated privileges.
libcurl creates the file to store HSTS data in using default file permissions,
meaning that on *nix systems you may need to restrict your umask to prevent
other users on the same system to access the file.
# %PROTOCOLS%
# EXAMPLE