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

FreeBSD Manual Pages

  
 
  

home | help
CURLINFO_COOKIELIST(3)	   curl_easy_getinfo options	CURLINFO_COOKIELIST(3)

NAME
       CURLINFO_COOKIELIST - get all known cookies

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	curl_easy_getinfo(CURL *handle,	CURLINFO_COOKIELIST,
				  struct curl_slist **cookies);

DESCRIPTION
       Pass  a	pointer	to a 'struct curl_slist	*' to receive a	linked-list of
       all cookies curl	knows  (expired	 ones,	too).  Don't  forget  to  call
       curl_slist_free_all(3)  on  the	list after it has been used.  If there
       are no cookies (cookies for the handle have not been enabled or	simply
       none  have been received) 'struct curl_slist *' will be set to point to
       NULL.

       Since 7.43.0 cookies that were imported in the Set-Cookie format	 with-
       out a domain name are not exported by this option.

PROTOCOLS
       HTTP(S)

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl)	{
	 curl_easy_setopt(curl,	CURLOPT_URL, "http://example.com");

	 /* enable the cookie engine with a non-existing file */
	 curl_easy_setopt(curl,	CURLOPT_COOKIEFILE, "-");

	 res = curl_easy_perform(curl);

	 if(!res) {
	   /* extract all known	cookies	*/
	   struct curl_slist *cookies =	NULL;
	   res = curl_easy_getinfo(curl, CURLINFO_COOKIELIST, &cookies);
	   if(!res && cookies) {
	     /*	a linked list of cookies in cookie file	format */
	     while(cookies) {
	       printf("%s", cookies->data);
	       cookies = cookies->next;
	     }
	     /*	we must	free these cookies when	we're done */
	     curl_slist_free_all(cookies);
	   }
	 }
	 curl_easy_cleanup(curl);
       }

AVAILABILITY
       Added in	7.14.1

RETURN VALUE
       Returns	CURLE_OK  if the option	is supported, and CURLE_UNKNOWN_OPTION
       if not.

SEE ALSO
       curl_easy_getinfo(3), curl_easy_setopt(3), CURLOPT_COOKIELIST(3),

libcurl	7.54.1			 May 06, 2017		CURLINFO_COOKIELIST(3)

NAME | SYNOPSIS | DESCRIPTION | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLINFO_COOKIELIST&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help