Sortix nightly manual
This manual documents Sortix nightly, a development build that has not been officially released. You can instead view this document in the latest official manual.
CURLOPT_COOKIEFILE(3) | libcurl | CURLOPT_COOKIEFILE(3) |
NAME
CURLOPT_COOKIEFILE - file name to read cookies fromSYNOPSIS
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIEFILE, char *filename);
DESCRIPTION
Pass a pointer to a null-terminated string as parameter. It should point to the file name of your file holding cookie data to read. The cookie data can be in either the old Netscape / Mozilla cookie data format or just regular HTTP headers (Set-Cookie style) dumped to a file.SECURITY
This document previously mentioned how specifying a non-existing file can also enable the cookie engine. While true, we strongly advise against using that method as it is too hard to be sure that files that stay that way in the long run.DEFAULT
NULLPROTOCOLS
HTTPEXAMPLE
int main(void)
{
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");
/* get cookies from an existing file */
curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "/tmp/cookies.txt");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
}
Cookie file format
The cookie file format and general cookie concepts in curl are described online here: https://curl.se/docs/http-cookies.htmlAVAILABILITY
As long as HTTP is supportedRETURN VALUE
Returns CURLE_OK if HTTP is supported, and CURLE_UNKNOWN_OPTION if not.SEE ALSO
CURLOPT_COOKIE(3), CURLOPT_COOKIEJAR(3), CURLOPT_COOKIESESSION(3)December 4, 2023 | ibcurl 8.5.0 |