DragonFly On-Line Manual Pages

Search: Section:  

CURLOPT_COOKIESESSION(3)            libcurl           CURLOPT_COOKIESESSION(3)


NAME

       CURLOPT_COOKIESESSION - start a new cookie session


SYNOPSIS

       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_COOKIESESSION, long init);


DESCRIPTION

       Pass a long set to 1 to mark this as a new cookie "session". It will
       force libcurl to ignore all cookies it is about to load that are
       "session cookies" from the previous session. By default, libcurl always
       stores and loads all cookies, independent if they are session cookies
       or not. Session cookies are cookies without expiry date and they are
       meant to be alive and existing for this "session" only.

       A "session" is usually defined in browser land for as long as you have
       your browser up, more or less.


DEFAULT

       0


PROTOCOLS

       HTTP


EXAMPLE

       CURL *curl = curl_easy_init();
       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");

         /* new "session", do not load session cookies */
         curl_easy_setopt(curl, CURLOPT_COOKIESESSION, 1L);

         /* get the (non session) cookies from this file */
         curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "/tmp/cookies.txt");

         ret = curl_easy_perform(curl);

         curl_easy_cleanup(curl);
       }


AVAILABILITY

       Along with HTTP


RETURN VALUE

       Returns CURLE_OK


SEE ALSO

       CURLOPT_COOKIEFILE(3), CURLOPT_COOKIE(3),

ibcurl 8.1.2                    April 26, 2023        CURLOPT_COOKIESESSION(3)

Search: Section: