CURLOPT_COOKIESESSION(3)    Library Functions Manual	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 forces
     libcurl to ignore all cookies it is about to load that are	 "session  cook-
     ies"  from the previous session. By default, libcurl always loads all cook-
     ies, 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 result;
	 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");

	 result = curl_easy_perform(curl);

	 curl_easy_cleanup(curl);
       }
     }

AVAILABILITY
     Added in curl 7.9.7

RETURN VALUE
     curl_easy_setopt(3) returns a CURLcode indicating success or error.

     CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
     libcurl-errors(3).

SEE ALSO
     CURLOPT_COOKIE(3), CURLOPT_COOKIEFILE(3), CURLOPT_COOKIEJAR(3)

libcurl				   2026-09-14		CURLOPT_COOKIESESSION(3)