kinetic (3) CURLOPT_COOKIESESSION.3.gz

Provided by: libcurl4-doc_7.85.0-1_all bug

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),