1 /***************************************************************************
3 * Project ___| | | | _ \| |
5 * | (__| |_| | _ <| |___
6 * \___|\___/|_| \_\_____|
8 * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.
10 * This software is licensed as described in the file COPYING, which
11 * you should have received as part of this distribution. The terms
12 * are also available at http://curl.haxx.se/docs/copyright.html.
14 * You may opt to use, copy, modify, merge, publish, distribute and/or sell
15 * copies of the Software, and permit persons to whom the Software is
16 * furnished to do so, under the terms of the COPYING file.
18 * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
19 * KIND, either express or implied.
21 ***************************************************************************/
26 RECEIVING COOKIE INFORMATION
27 ============================
29 struct CookieInfo *Curl_cookie_init(struct SessionHandle *data,
30 const char *file, struct CookieInfo *inc, bool newsession);
32 Inits a cookie struct to store data in a local file. This is always
33 called before any cookies are set.
35 struct Cookie *Curl_cookie_add(struct SessionHandle *data,
36 struct CookieInfo *c, bool httpheader, char *lineptr,
37 const char *domain, const char *path);
39 The 'lineptr' parameter is a full "Set-cookie:" line as
40 received from a server.
42 The function need to replace previously stored lines that this new
45 It may remove lines that are expired.
47 It should return an indication of success/error.
50 SENDING COOKIE INFORMATION
51 ==========================
53 struct Cookies *Curl_cookie_getlist(struct CookieInfo *cookie,
54 char *host, char *path, bool secure);
56 For a given host and path, return a linked list of cookies that
57 the client should send to the server if used now. The secure
58 boolean informs the cookie if a secure connection is achieved or
61 It shall only return cookies that haven't expired.
64 Example set of cookies:
66 Set-cookie: PRODUCTINFO=webxpress; domain=.fidelity.com; path=/; secure
67 Set-cookie: PERSONALIZE=none;expires=Monday, 13-Jun-1988 03:04:55 GMT;
68 domain=.fidelity.com; path=/ftgw; secure
69 Set-cookie: FidHist=none;expires=Monday, 13-Jun-1988 03:04:55 GMT;
70 domain=.fidelity.com; path=/; secure
71 Set-cookie: FidOrder=none;expires=Monday, 13-Jun-1988 03:04:55 GMT;
72 domain=.fidelity.com; path=/; secure
73 Set-cookie: DisPend=none;expires=Monday, 13-Jun-1988 03:04:55 GMT;
74 domain=.fidelity.com; path=/; secure
75 Set-cookie: FidDis=none;expires=Monday, 13-Jun-1988 03:04:55 GMT;
76 domain=.fidelity.com; path=/; secure
78 Session_Key@6791a9e0-901a-11d0-a1c8-9b012c88aa77=none;expires=Monday,
79 13-Jun-1988 03:04:55 GMT; domain=.fidelity.com; path=/; secure
83 #include "curl_setup.h"
85 #if !defined(CURL_DISABLE_HTTP) && !defined(CURL_DISABLE_COOKIES)
87 #define _MPRINTF_REPLACE
88 #include <curl/mprintf.h>
96 #include "curl_memory.h"
98 #include "strtoofft.h"
100 #include "curl_memrchr.h"
101 #include "inet_pton.h"
103 /* The last #include file should be: */
104 #include "memdebug.h"
106 static void freecookie(struct Cookie *co)
128 static bool tailmatch(const char *cooke_domain, const char *hostname)
130 size_t cookie_domain_len = strlen(cooke_domain);
131 size_t hostname_len = strlen(hostname);
133 if(hostname_len < cookie_domain_len)
136 if(!Curl_raw_equal(cooke_domain, hostname+hostname_len-cookie_domain_len))
139 /* A lead char of cookie_domain is not '.'.
140 RFC6265 4.1.2.3. The Domain Attribute says:
141 For example, if the value of the Domain attribute is
142 "example.com", the user agent will include the cookie in the Cookie
143 header when making HTTP requests to example.com, www.example.com, and
144 www.corp.example.com.
146 if(hostname_len == cookie_domain_len)
148 if('.' == *(hostname + hostname_len - cookie_domain_len - 1))
154 * matching cookie path and url path
155 * RFC6265 5.1.4 Paths and Path-Match
157 static bool pathmatch(const char* cookie_path, const char* request_uri)
159 size_t cookie_path_len;
161 char* uri_path = NULL;
165 /* cookie_path must not have last '/' separator. ex: /sample */
166 cookie_path_len = strlen(cookie_path);
167 if(1 == cookie_path_len) {
168 /* cookie_path must be '/' */
172 uri_path = strdup(request_uri);
175 pos = strchr(uri_path, '?');
179 /* #-fragments are already cut off! */
180 if(0 == strlen(uri_path) || uri_path[0] != '/') {
182 uri_path = strdup("/");
187 /* here, RFC6265 5.1.4 says
188 4. Output the characters of the uri-path from the first character up
189 to, but not including, the right-most %x2F ("/").
190 but URL path /hoge?fuga=xxx means /hoge/index.cgi?fuga=xxx in some site
192 Ignore this algorithm because /hoge is uri path for this case
196 uri_path_len = strlen(uri_path);
198 if(uri_path_len < cookie_path_len) {
203 /* not using checkprefix() because matching should be case-sensitive */
204 if(strncmp(cookie_path, uri_path, cookie_path_len)) {
209 /* The cookie-path and the uri-path are identical. */
210 if(cookie_path_len == uri_path_len) {
215 /* here, cookie_path_len < url_path_len */
216 if(uri_path[cookie_path_len] == '/') {
229 * cookie path sanitize
231 static char *sanitize_cookie_path(const char *cookie_path)
234 char *new_path = strdup(cookie_path);
238 /* some stupid site sends path attribute with '"'. */
239 len = strlen(new_path);
240 if(new_path[0] == '\"') {
241 memmove((void *)new_path, (const void *)(new_path + 1), len);
244 if(len && (new_path[len - 1] == '\"')) {
245 new_path[len - 1] = 0x0;
249 /* RFC6265 5.2.4 The Path Attribute */
250 if(new_path[0] != '/') {
251 /* Let cookie-path be the default-path. */
253 new_path = strdup("/");
257 /* convert /hoge/ to /hoge */
258 if(len && new_path[len - 1] == '/') {
259 new_path[len - 1] = 0x0;
266 * Load cookies from all given cookie files (CURLOPT_COOKIEFILE).
268 * NOTE: OOM or cookie parsing failures are ignored.
270 void Curl_cookie_loadfiles(struct SessionHandle *data)
272 struct curl_slist *list = data->change.cookielist;
274 Curl_share_lock(data, CURL_LOCK_DATA_COOKIE, CURL_LOCK_ACCESS_SINGLE);
276 struct CookieInfo *newcookies = Curl_cookie_init(data,
279 data->set.cookiesession);
281 /* Failure may be due to OOM or a bad cookie; both are ignored
282 * but only the first should be
284 infof(data, "ignoring failed cookie_init for %s\n", list->data);
286 data->cookies = newcookies;
289 curl_slist_free_all(data->change.cookielist); /* clean up list */
290 data->change.cookielist = NULL; /* don't do this again! */
291 Curl_share_unlock(data, CURL_LOCK_DATA_COOKIE);
296 * strstore() makes a strdup() on the 'newstr' and if '*str' is non-NULL
297 * that will be freed before the allocated string is stored there.
299 * It is meant to easily replace strdup()
301 static void strstore(char **str, const char *newstr)
305 *str = strdup(newstr);
309 * remove_expired() removes expired cookies.
311 static void remove_expired(struct CookieInfo *cookies)
313 struct Cookie *co, *nx, *pv;
314 curl_off_t now = (curl_off_t)time(NULL);
316 co = cookies->cookies;
320 if((co->expirestr || co->maxage) && co->expires < now) {
321 if(co == cookies->cookies) {
322 cookies->cookies = co->next;
327 cookies->numcookies--;
338 * Return true if the given string is an IP(v4|v6) address.
340 static bool isip(const char *domain)
344 struct in6_addr addr6;
347 if(Curl_inet_pton(AF_INET, domain, &addr)
349 || Curl_inet_pton(AF_INET6, domain, &addr6)
352 /* domain name given as IP address */
359 /****************************************************************************
363 * Add a single cookie line to the cookie keeping object.
365 * Be aware that sometimes we get an IP-only host name, and that might also be
366 * a numerical IPv6 address.
368 * Returns NULL on out of memory or invalid cookie. This is suboptimal,
369 * as they should be treated separately.
370 ***************************************************************************/
373 Curl_cookie_add(struct SessionHandle *data,
374 /* The 'data' pointer here may be NULL at times, and thus
375 must only be used very carefully for things that can deal
376 with data being NULL. Such as infof() and similar */
378 struct CookieInfo *c,
379 bool httpheader, /* TRUE if HTTP header-style line */
380 char *lineptr, /* first character of the line */
381 const char *domain, /* default domain */
382 const char *path) /* full path used when this cookie is set,
383 used to get default path for the cookie
386 struct Cookie *clist;
389 struct Cookie *lastc=NULL;
390 time_t now = time(NULL);
391 bool replace_old = FALSE;
392 bool badcookie = FALSE; /* cookies are good by default. mmmmm yummy */
394 #ifdef CURL_DISABLE_VERBOSE_STRINGS
398 /* First, alloc and init a new struct for it */
399 co = calloc(1, sizeof(struct Cookie));
401 return NULL; /* bail out if we're this low on memory */
404 /* This line was read off a HTTP-header */
409 what = malloc(MAX_COOKIE_LINE);
415 semiptr=strchr(lineptr, ';'); /* first, find a semicolon */
417 while(*lineptr && ISBLANK(*lineptr))
422 /* we have a <what>=<this> pair or a stand-alone word here */
423 name[0]=what[0]=0; /* init the buffers */
424 if(1 <= sscanf(ptr, "%" MAX_NAME_TXT "[^;\r\n =]=%"
425 MAX_COOKIE_LINE_TXT "[^;\r\n]",
427 /* Use strstore() below to properly deal with received cookie
428 headers that have the same string property set more than once,
429 and then we use the last one. */
433 size_t len=strlen(what);
434 const char *endofn = &ptr[ strlen(name) ];
436 /* skip trailing spaces in name */
437 while(*endofn && ISBLANK(*endofn))
440 /* name ends with a '=' ? */
441 sep = (*endofn == '=')?TRUE:FALSE;
443 /* Strip off trailing whitespace from the 'what' */
444 while(len && ISBLANK(what[len-1])) {
449 /* Skip leading whitespace from the 'what' */
451 while(*whatptr && ISBLANK(*whatptr))
455 /* this was a "<name>=" with no content, and we must allow
456 'secure' and 'httponly' specified this weirdly */
458 if(Curl_raw_equal("secure", name))
460 else if(Curl_raw_equal("httponly", name))
463 /* there was a '=' so we're not done parsing this field */
468 else if(Curl_raw_equal("path", name)) {
469 strstore(&co->path, whatptr);
471 badcookie = TRUE; /* out of memory bad */
474 co->spath = sanitize_cookie_path(co->path);
476 badcookie = TRUE; /* out of memory bad */
480 else if(Curl_raw_equal("domain", name)) {
484 /* Now, we make sure that our host is within the given domain,
485 or the given domain is not valid and thus cannot be set. */
487 if('.' == whatptr[0])
488 whatptr++; /* ignore preceding dot */
490 is_ip = isip(domain ? domain : whatptr);
492 /* check for more dots */
493 dotp = strchr(whatptr, '.');
498 || (is_ip && !strcmp(whatptr, domain))
499 || (!is_ip && tailmatch(whatptr, domain))) {
500 strstore(&co->domain, whatptr);
506 co->tailmatch=TRUE; /* we always do that if the domain name was
510 /* we did not get a tailmatch and then the attempted set domain
511 is not a domain to which the current host belongs. Mark as
514 infof(data, "skipped cookie with bad tailmatch domain: %s\n",
518 else if(Curl_raw_equal("version", name)) {
519 strstore(&co->version, whatptr);
525 else if(Curl_raw_equal("max-age", name)) {
526 /* Defined in RFC2109:
528 Optional. The Max-Age attribute defines the lifetime of the
529 cookie, in seconds. The delta-seconds value is a decimal non-
530 negative integer. After delta-seconds seconds elapse, the
531 client should discard the cookie. A value of zero means the
532 cookie should be discarded immediately.
535 strstore(&co->maxage, whatptr);
541 else if(Curl_raw_equal("expires", name)) {
542 strstore(&co->expirestr, whatptr);
549 co->name = strdup(name);
550 co->value = strdup(whatptr);
551 if(!co->name || !co->value) {
557 else this is the second (or more) name we don't know
561 /* this is an "illegal" <what>=<this> pair */
564 if(!semiptr || !*semiptr) {
565 /* we already know there are no more cookies */
571 while(*ptr && ISBLANK(*ptr))
573 semiptr=strchr(ptr, ';'); /* now, find the next semicolon */
576 /* There are no more semicolons, but there's a final name=value pair
578 semiptr=strchr(ptr, '\0');
583 curlx_strtoofft((*co->maxage=='\"')?
584 &co->maxage[1]:&co->maxage[0], NULL, 10);
585 if(CURL_OFF_T_MAX - now < co->expires)
587 co->expires = CURL_OFF_T_MAX;
591 else if(co->expirestr) {
592 /* Note that if the date couldn't get parsed for whatever reason,
593 the cookie will be treated as a session cookie */
594 co->expires = curl_getdate(co->expirestr, NULL);
596 /* Session cookies have expires set to 0 so if we get that back
597 from the date parser let's add a second to make it a
598 non-session cookie */
601 else if(co->expires < 0)
605 if(!badcookie && !co->domain) {
607 /* no domain was given in the header line, set the default */
608 co->domain=strdup(domain);
614 if(!badcookie && !co->path && path) {
615 /* No path was given in the header line, set the default.
616 Note that the passed-in path to this function MAY have a '?' and
617 following part that MUST not be stored as part of the path. */
618 char *queryp = strchr(path, '?');
620 /* queryp is where the interesting part of the path ends, so now we
621 want to the find the last */
624 endslash = strrchr(path, '/');
626 endslash = memrchr(path, '/', (size_t)(queryp - path));
628 size_t pathlen = (size_t)(endslash-path+1); /* include ending slash */
629 co->path=malloc(pathlen+1); /* one extra for the zero byte */
631 memcpy(co->path, path, pathlen);
632 co->path[pathlen]=0; /* zero terminate */
633 co->spath = sanitize_cookie_path(co->path);
635 badcookie = TRUE; /* out of memory bad */
644 if(badcookie || !co->name) {
645 /* we didn't get a cookie name or a bad one,
646 this is an illegal line, bail out */
653 /* This line is NOT a HTTP header style line, we do offer support for
654 reading the odd netscape cookies-file format here */
660 /* IE introduced HTTP-only cookies to prevent XSS attacks. Cookies
661 marked with httpOnly after the domain name are not accessible
662 from javascripts, but since curl does not operate at javascript
663 level, we include them anyway. In Firefox's cookie files, these
664 lines are preceded with #HttpOnly_ and then everything is
665 as usual, so we skip 10 characters of the line..
667 if(strncmp(lineptr, "#HttpOnly_", 10) == 0) {
672 if(lineptr[0]=='#') {
673 /* don't even try the comments */
677 /* strip off the possible end-of-line characters */
678 ptr=strchr(lineptr, '\r');
680 *ptr=0; /* clear it */
681 ptr=strchr(lineptr, '\n');
683 *ptr=0; /* clear it */
685 firstptr=strtok_r(lineptr, "\t", &tok_buf); /* tokenize it on the TAB */
687 /* Now loop through the fields and init the struct we already have
689 for(ptr=firstptr, fields=0; ptr && !badcookie;
690 ptr=strtok_r(NULL, "\t", &tok_buf), fields++) {
693 if(ptr[0]=='.') /* skip preceding dots */
695 co->domain = strdup(ptr);
700 /* This field got its explanation on the 23rd of May 2001 by
703 flag: A TRUE/FALSE value indicating if all machines within a given
704 domain can access the variable. This value is set automatically by
705 the browser, depending on the value you set for the domain.
707 As far as I can see, it is set to true when the cookie says
708 .domain.com and to false when the domain is complete www.domain.com
710 co->tailmatch = Curl_raw_equal(ptr, "TRUE")?TRUE:FALSE;
713 /* It turns out, that sometimes the file format allows the path
714 field to remain not filled in, we try to detect this and work
715 around it! Andrés GarcÃa made us aware of this... */
716 if(strcmp("TRUE", ptr) && strcmp("FALSE", ptr)) {
717 /* only if the path doesn't look like a boolean option! */
718 co->path = strdup(ptr);
722 co->spath = sanitize_cookie_path(co->path);
724 badcookie = TRUE; /* out of memory bad */
729 /* this doesn't look like a path, make one up! */
730 co->path = strdup("/");
733 co->spath = strdup("/");
736 fields++; /* add a field and fall down to secure */
739 co->secure = Curl_raw_equal(ptr, "TRUE")?TRUE:FALSE;
742 co->expires = curlx_strtoofft(ptr, NULL, 10);
745 co->name = strdup(ptr);
750 co->value = strdup(ptr);
757 /* we got a cookie with blank contents, fix it */
758 co->value = strdup("");
765 if(!badcookie && (7 != fields))
766 /* we did not find the sufficient number of fields */
776 if(!c->running && /* read from a file */
777 c->newsession && /* clean session cookies */
778 !co->expires) { /* this is a session cookie since it doesn't expire! */
783 co->livecookie = c->running;
785 /* now, we have parsed the incoming line, we must now check if this
786 superceeds an already existing cookie, which it may if the previous have
787 the same domain and path as this */
789 /* at first, remove expired cookies */
795 if(Curl_raw_equal(clist->name, co->name)) {
796 /* the names are identical */
798 if(clist->domain && co->domain) {
799 if(Curl_raw_equal(clist->domain, co->domain))
800 /* The domains are identical */
803 else if(!clist->domain && !co->domain)
807 /* the domains were identical */
809 if(clist->spath && co->spath) {
810 if(Curl_raw_equal(clist->spath, co->spath)) {
816 else if(!clist->spath && !co->spath)
823 if(replace_old && !co->livecookie && clist->livecookie) {
824 /* Both cookies matched fine, except that the already present
825 cookie is "live", which means it was set from a header, while
826 the new one isn't "live" and thus only read from a file. We let
827 live cookies stay alive */
829 /* Free the newcomer and get out of here! */
835 co->next = clist->next; /* get the next-pointer first */
837 /* then free all the old pointers */
848 free(clist->expirestr);
851 free(clist->version);
855 *clist = *co; /* then store all the new data */
857 free(co); /* free the newly alloced memory */
858 co = clist; /* point to the previous struct instead */
860 /* We have replaced a cookie, now skip the rest of the list but
861 make sure the 'lastc' pointer is properly set */
874 /* Only show this when NOT reading the cookies from a file */
875 infof(data, "%s cookie %s=\"%s\" for domain %s, path %s, "
876 "expire %" CURL_FORMAT_CURL_OFF_T "\n",
877 replace_old?"Replaced":"Added", co->name, co->value,
878 co->domain, co->path, co->expires);
881 /* then make the last item point on this new one */
886 c->numcookies++; /* one more cookie in the jar */
892 /*****************************************************************************
896 * Inits a cookie struct to read data from a local file. This is always
897 * called before any cookies are set. File may be NULL.
899 * If 'newsession' is TRUE, discard all "session cookies" on read from file.
901 * Returns NULL on out of memory. Invalid cookies are ignored.
902 ****************************************************************************/
903 struct CookieInfo *Curl_cookie_init(struct SessionHandle *data,
905 struct CookieInfo *inc,
908 struct CookieInfo *c;
914 /* we didn't get a struct, create one */
915 c = calloc(1, sizeof(struct CookieInfo));
917 return NULL; /* failed to get memory */
918 c->filename = strdup(file?file:"none"); /* copy the name just in case */
920 goto fail; /* failed to get memory */
923 /* we got an already existing one, use that */
926 c->running = FALSE; /* this is not running, this is init */
928 if(file && strequal(file, "-")) {
932 else if(file && !*file) {
933 /* points to a "" string */
937 fp = file?fopen(file, "r"):NULL;
939 c->newsession = newsession; /* new session? */
945 line = malloc(MAX_COOKIE_LINE);
948 while(fgets(line, MAX_COOKIE_LINE, fp)) {
949 if(checkprefix("Set-Cookie:", line)) {
950 /* This is a cookie line, get it! */
958 while(*lineptr && ISBLANK(*lineptr))
961 Curl_cookie_add(data, c, headerline, lineptr, NULL, NULL);
963 free(line); /* free the line buffer */
969 c->running = TRUE; /* now, we're running */
976 /* Only clean up if we allocated it here, as the original could still be in
977 * use by a share handle */
978 Curl_cookie_cleanup(c);
981 return NULL; /* out of memory */
984 /* sort this so that the longest path gets before the shorter path */
985 static int cookie_sort(const void *p1, const void *p2)
987 struct Cookie *c1 = *(struct Cookie **)p1;
988 struct Cookie *c2 = *(struct Cookie **)p2;
991 /* 1 - compare cookie path lengths */
992 l1 = c1->path ? strlen(c1->path) : 0;
993 l2 = c2->path ? strlen(c2->path) : 0;
996 return (l2 > l1) ? 1 : -1 ; /* avoid size_t <=> int conversions */
998 /* 2 - compare cookie domain lengths */
999 l1 = c1->domain ? strlen(c1->domain) : 0;
1000 l2 = c2->domain ? strlen(c2->domain) : 0;
1003 return (l2 > l1) ? 1 : -1 ; /* avoid size_t <=> int conversions */
1005 /* 3 - compare cookie names */
1006 if(c1->name && c2->name)
1007 return strcmp(c1->name, c2->name);
1009 /* sorry, can't be more deterministic */
1013 /*****************************************************************************
1015 * Curl_cookie_getlist()
1017 * For a given host and path, return a linked list of cookies that the
1018 * client should send to the server if used now. The secure boolean informs
1019 * the cookie if a secure connection is achieved or not.
1021 * It shall only return cookies that haven't expired.
1023 ****************************************************************************/
1025 struct Cookie *Curl_cookie_getlist(struct CookieInfo *c,
1026 const char *host, const char *path,
1029 struct Cookie *newco;
1031 time_t now = time(NULL);
1032 struct Cookie *mainco=NULL;
1036 if(!c || !c->cookies)
1037 return NULL; /* no cookie struct or no cookies in the struct */
1039 /* at first, remove expired cookies */
1042 /* check if host is an IP(v4|v6) address */
1048 /* only process this cookie if it is not expired or had no expire
1049 date AND that if the cookie requires we're secure we must only
1050 continue if we are! */
1051 if((!co->expires || (co->expires > now)) &&
1052 (co->secure?secure:TRUE)) {
1054 /* now check if the domain is correct */
1056 (co->tailmatch && !is_ip && tailmatch(co->domain, host)) ||
1057 ((!co->tailmatch || is_ip) && Curl_raw_equal(host, co->domain)) ) {
1058 /* the right part of the host matches the domain stuff in the
1061 /* now check the left part of the path with the cookies path
1063 if(!co->spath || pathmatch(co->spath, path) ) {
1065 /* and now, we know this is a match and we should create an
1066 entry for the return-linked-list */
1068 newco = malloc(sizeof(struct Cookie));
1070 /* first, copy the whole source cookie: */
1071 memcpy(newco, co, sizeof(struct Cookie));
1073 /* then modify our next */
1074 newco->next = mainco;
1076 /* point the main to us */
1083 /* failure, clear up the allocated chain and return NULL */
1099 /* Now we need to make sure that if there is a name appearing more than
1100 once, the longest specified path version comes first. To make this
1101 the swiftest way, we just sort them all based on path length. */
1102 struct Cookie **array;
1105 /* alloc an array and store all cookie pointers */
1106 array = malloc(sizeof(struct Cookie *) * matches);
1112 for(i=0; co; co = co->next)
1115 /* now sort the cookie pointers in path length order */
1116 qsort(array, matches, sizeof(struct Cookie *), cookie_sort);
1118 /* remake the linked list order according to the new order */
1120 mainco = array[0]; /* start here */
1121 for(i=0; i<matches-1; i++)
1122 array[i]->next = array[i+1];
1123 array[matches-1]->next = NULL; /* terminate the list */
1125 free(array); /* remove the temporary data again */
1128 return mainco; /* return the new list */
1131 /*****************************************************************************
1133 * Curl_cookie_clearall()
1135 * Clear all existing cookies and reset the counter.
1137 ****************************************************************************/
1138 void Curl_cookie_clearall(struct CookieInfo *cookies)
1141 Curl_cookie_freelist(cookies->cookies, TRUE);
1142 cookies->cookies = NULL;
1143 cookies->numcookies = 0;
1147 /*****************************************************************************
1149 * Curl_cookie_freelist()
1151 * Free a list of cookies previously returned by Curl_cookie_getlist();
1153 * The 'cookiestoo' argument tells this function whether to just free the
1154 * list or actually also free all cookies within the list as well.
1156 ****************************************************************************/
1158 void Curl_cookie_freelist(struct Cookie *co, bool cookiestoo)
1160 struct Cookie *next;
1166 free(co); /* we only free the struct since the "members" are all just
1167 pointed out in the main cookie list! */
1173 /*****************************************************************************
1175 * Curl_cookie_clearsess()
1177 * Free all session cookies in the cookies list.
1179 ****************************************************************************/
1180 void Curl_cookie_clearsess(struct CookieInfo *cookies)
1182 struct Cookie *first, *curr, *next, *prev = NULL;
1184 if(!cookies || !cookies->cookies)
1187 first = curr = prev = cookies->cookies;
1189 for(; curr; curr = next) {
1191 if(!curr->expires) {
1201 cookies->numcookies--;
1207 cookies->cookies = first;
1211 /*****************************************************************************
1213 * Curl_cookie_cleanup()
1215 * Free a "cookie object" previous created with Curl_cookie_init().
1217 ****************************************************************************/
1218 void Curl_cookie_cleanup(struct CookieInfo *c)
1223 Curl_cookie_freelist(c->cookies, TRUE);
1224 free(c); /* free the base struct as well */
1228 /* get_netscape_format()
1230 * Formats a string for Netscape output file, w/o a newline at the end.
1232 * Function returns a char * to a formatted line. Has to be free()d
1234 static char *get_netscape_format(const struct Cookie *co)
1237 "%s" /* httponly preamble */
1238 "%s%s\t" /* domain */
1239 "%s\t" /* tailmatch */
1242 "%" CURL_FORMAT_CURL_OFF_T "\t" /* expires */
1245 co->httponly?"#HttpOnly_":"",
1246 /* Make sure all domains are prefixed with a dot if they allow
1247 tailmatching. This is Mozilla-style. */
1248 (co->tailmatch && co->domain && co->domain[0] != '.')? ".":"",
1249 co->domain?co->domain:"unknown",
1250 co->tailmatch?"TRUE":"FALSE",
1251 co->path?co->path:"/",
1252 co->secure?"TRUE":"FALSE",
1255 co->value?co->value:"");
1261 * Writes all internally known cookies to the specified file. Specify
1262 * "-" as file name to write to stdout.
1264 * The function returns non-zero on write failure.
1266 static int cookie_output(struct CookieInfo *c, const char *dumphere)
1270 bool use_stdout=FALSE;
1272 if((NULL == c) || (0 == c->numcookies))
1273 /* If there are no known cookies, we don't write or even create any
1277 /* at first, remove expired cookies */
1280 if(strequal("-", dumphere)) {
1286 out = fopen(dumphere, "w");
1288 return 1; /* failure */
1294 fputs("# Netscape HTTP Cookie File\n"
1295 "# http://curl.haxx.se/docs/http-cookies.html\n"
1296 "# This file was generated by libcurl! Edit at your own risk.\n\n",
1301 format_ptr = get_netscape_format(co);
1302 if(format_ptr == NULL) {
1303 fprintf(out, "#\n# Fatal libcurl error\n");
1308 fprintf(out, "%s\n", format_ptr);
1320 struct curl_slist *Curl_cookie_list(struct SessionHandle *data)
1322 struct curl_slist *list = NULL;
1323 struct curl_slist *beg;
1327 if((data->cookies == NULL) ||
1328 (data->cookies->numcookies == 0))
1331 c = data->cookies->cookies;
1334 /* fill the list with _all_ the cookies we know */
1335 line = get_netscape_format(c);
1337 curl_slist_free_all(list);
1340 beg = Curl_slist_append_nodup(list, line);
1343 curl_slist_free_all(list);
1353 void Curl_flush_cookies(struct SessionHandle *data, int cleanup)
1355 if(data->set.str[STRING_COOKIEJAR]) {
1356 if(data->change.cookielist) {
1357 /* If there is a list of cookie files to read, do it first so that
1358 we have all the told files read before we write the new jar.
1359 Curl_cookie_loadfiles() LOCKS and UNLOCKS the share itself! */
1360 Curl_cookie_loadfiles(data);
1363 Curl_share_lock(data, CURL_LOCK_DATA_COOKIE, CURL_LOCK_ACCESS_SINGLE);
1365 /* if we have a destination file for all the cookies to get dumped to */
1366 if(cookie_output(data->cookies, data->set.str[STRING_COOKIEJAR]))
1367 infof(data, "WARNING: failed to save cookies in %s\n",
1368 data->set.str[STRING_COOKIEJAR]);
1371 if(cleanup && data->change.cookielist) {
1372 /* since nothing is written, we can just free the list of cookie file
1374 curl_slist_free_all(data->change.cookielist); /* clean up list */
1375 data->change.cookielist = NULL;
1377 Curl_share_lock(data, CURL_LOCK_DATA_COOKIE, CURL_LOCK_ACCESS_SINGLE);
1380 if(cleanup && (!data->share || (data->cookies != data->share->cookies))) {
1381 Curl_cookie_cleanup(data->cookies);
1383 Curl_share_unlock(data, CURL_LOCK_DATA_COOKIE);
1386 #endif /* CURL_DISABLE_HTTP || CURL_DISABLE_COOKIES */