Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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
       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
       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				  2025-06-03	      CURLOPT_COOKIESESSION(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLOPT_COOKIESESSION&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help