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 forces libcurl to ignore all cookies it
       is about to load that are "session cookies" from the previous session. By default, libcurl  always  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.
       libcurl  needs  the  application  to  use  this option to tell it when a new session starts, otherwise it
       assumes everything is still in the same session.

DEFAULT

       0

PROTOCOLS

       This functionality affects http only

EXAMPLE

       int main(void)
       {
         CURL *curl = curl_easy_init();
         if(curl) {
           CURLcode res;
           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");

           res = curl_easy_perform(curl);

           curl_easy_cleanup(curl);
         }
       }

AVAILABILITY

       Added in curl 7.9.7

RETURN VALUE

       Returns CURLE_OK

SEE ALSO

       CURLOPT_COOKIE(3), CURLOPT_COOKIEFILE(3), CURLOPT_COOKIEJAR(3)