CURLOPT_COOKIESESSION(3)

1CURLOPT_COOKIESESSION(3)   curl_easy_setopt options   CURLOPT_COOKIESESSION(3)
2
3
4

NAME

6       CURLOPT_COOKIESESSION - start a new cookie session
7

SYNOPSIS

9       #include <curl/curl.h>
10
11       CURLcode  curl_easy_setopt(CURL  *handle,  CURLOPT_COOKIESESSION,  long
12       init);
13

DESCRIPTION

15       Pass a long set to 1 to mark this as a new cookie  "session".  It  will
16       force  libcurl to ignore all cookies it is about to load that are "ses‐
17       sion cookies" from the previous session.  By  default,  libcurl  always
18       stores  and  loads all cookies, independent if they are session cookies
19       or not. Session cookies are cookies without expiry date  and  they  are
20       meant to be alive and existing for this "session" only.
21
22       A  "session" is usually defined in browser land for as long as you have
23       your browser up, more or less.
24

DEFAULT

26       0
27

PROTOCOLS

29       HTTP
30

EXAMPLE

32       CURL *curl = curl_easy_init();
33       if(curl) {
34         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/foo.bin");
35
36         /* new "session", don't load session cookies */
37         curl_easy_setopt(curl, CURLOPT_COOKIESESSION, 1L);
38
39         /* get the (non session) cookies from this file */
40         curl_easy_setopt(curl, CURLOPT_COOKIEFILE, "/tmp/cookies.txt");
41
42         ret = curl_easy_perform(curl);
43
44         curl_easy_cleanup(curl);
45       }
46

AVAILABILITY

48       Along with HTTP
49

RETURN VALUE

51       Returns CURLE_OK
52