parsedate.c 16 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601
  1. /***************************************************************************
  2. * _ _ ____ _
  3. * Project ___| | | | _ \| |
  4. * / __| | | | |_) | |
  5. * | (__| |_| | _ <| |___
  6. * \___|\___/|_| \_\_____|
  7. *
  8. * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
  9. *
  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 https://curl.se/docs/copyright.html.
  13. *
  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.
  17. *
  18. * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
  19. * KIND, either express or implied.
  20. *
  21. ***************************************************************************/
  22. /*
  23. A brief summary of the date string formats this parser groks:
  24. RFC 2616 3.3.1
  25. Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
  26. Sunday, 06-Nov-94 08:49:37 GMT ; RFC 850, obsoleted by RFC 1036
  27. Sun Nov 6 08:49:37 1994 ; ANSI C's asctime() format
  28. we support dates without week day name:
  29. 06 Nov 1994 08:49:37 GMT
  30. 06-Nov-94 08:49:37 GMT
  31. Nov 6 08:49:37 1994
  32. without the time zone:
  33. 06 Nov 1994 08:49:37
  34. 06-Nov-94 08:49:37
  35. weird order:
  36. 1994 Nov 6 08:49:37 (GNU date fails)
  37. GMT 08:49:37 06-Nov-94 Sunday
  38. 94 6 Nov 08:49:37 (GNU date fails)
  39. time left out:
  40. 1994 Nov 6
  41. 06-Nov-94
  42. Sun Nov 6 94
  43. unusual separators:
  44. 1994.Nov.6
  45. Sun/Nov/6/94/GMT
  46. commonly used time zone names:
  47. Sun, 06 Nov 1994 08:49:37 CET
  48. 06 Nov 1994 08:49:37 EST
  49. time zones specified using RFC822 style:
  50. Sun, 12 Sep 2004 15:05:58 -0700
  51. Sat, 11 Sep 2004 21:32:11 +0200
  52. compact numerical date strings:
  53. 20040912 15:05:58 -0700
  54. 20040911 +0200
  55. */
  56. #include "curl_setup.h"
  57. #include <limits.h>
  58. #include <curl/curl.h>
  59. #include "strcase.h"
  60. #include "warnless.h"
  61. #include "parsedate.h"
  62. /*
  63. * parsedate()
  64. *
  65. * Returns:
  66. *
  67. * PARSEDATE_OK - a fine conversion
  68. * PARSEDATE_FAIL - failed to convert
  69. * PARSEDATE_LATER - time overflow at the far end of time_t
  70. * PARSEDATE_SOONER - time underflow at the low end of time_t
  71. */
  72. static int parsedate(const char *date, time_t *output);
  73. #define PARSEDATE_OK 0
  74. #define PARSEDATE_FAIL -1
  75. #define PARSEDATE_LATER 1
  76. #define PARSEDATE_SOONER 2
  77. #if !defined(CURL_DISABLE_PARSEDATE) || !defined(CURL_DISABLE_FTP) || \
  78. !defined(CURL_DISABLE_FILE)
  79. /* These names are also used by FTP and FILE code */
  80. const char * const Curl_wkday[] =
  81. {"Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun"};
  82. const char * const Curl_month[]=
  83. { "Jan", "Feb", "Mar", "Apr", "May", "Jun",
  84. "Jul", "Aug", "Sep", "Oct", "Nov", "Dec" };
  85. #endif
  86. #ifndef CURL_DISABLE_PARSEDATE
  87. static const char * const weekday[] =
  88. { "Monday", "Tuesday", "Wednesday", "Thursday",
  89. "Friday", "Saturday", "Sunday" };
  90. struct tzinfo {
  91. char name[5];
  92. int offset; /* +/- in minutes */
  93. };
  94. /* Here's a bunch of frequently used time zone names. These were supported
  95. by the old getdate parser. */
  96. #define tDAYZONE -60 /* offset for daylight savings time */
  97. static const struct tzinfo tz[]= {
  98. {"GMT", 0}, /* Greenwich Mean */
  99. {"UT", 0}, /* Universal Time */
  100. {"UTC", 0}, /* Universal (Coordinated) */
  101. {"WET", 0}, /* Western European */
  102. {"BST", 0 tDAYZONE}, /* British Summer */
  103. {"WAT", 60}, /* West Africa */
  104. {"AST", 240}, /* Atlantic Standard */
  105. {"ADT", 240 tDAYZONE}, /* Atlantic Daylight */
  106. {"EST", 300}, /* Eastern Standard */
  107. {"EDT", 300 tDAYZONE}, /* Eastern Daylight */
  108. {"CST", 360}, /* Central Standard */
  109. {"CDT", 360 tDAYZONE}, /* Central Daylight */
  110. {"MST", 420}, /* Mountain Standard */
  111. {"MDT", 420 tDAYZONE}, /* Mountain Daylight */
  112. {"PST", 480}, /* Pacific Standard */
  113. {"PDT", 480 tDAYZONE}, /* Pacific Daylight */
  114. {"YST", 540}, /* Yukon Standard */
  115. {"YDT", 540 tDAYZONE}, /* Yukon Daylight */
  116. {"HST", 600}, /* Hawaii Standard */
  117. {"HDT", 600 tDAYZONE}, /* Hawaii Daylight */
  118. {"CAT", 600}, /* Central Alaska */
  119. {"AHST", 600}, /* Alaska-Hawaii Standard */
  120. {"NT", 660}, /* Nome */
  121. {"IDLW", 720}, /* International Date Line West */
  122. {"CET", -60}, /* Central European */
  123. {"MET", -60}, /* Middle European */
  124. {"MEWT", -60}, /* Middle European Winter */
  125. {"MEST", -60 tDAYZONE}, /* Middle European Summer */
  126. {"CEST", -60 tDAYZONE}, /* Central European Summer */
  127. {"MESZ", -60 tDAYZONE}, /* Middle European Summer */
  128. {"FWT", -60}, /* French Winter */
  129. {"FST", -60 tDAYZONE}, /* French Summer */
  130. {"EET", -120}, /* Eastern Europe, USSR Zone 1 */
  131. {"WAST", -420}, /* West Australian Standard */
  132. {"WADT", -420 tDAYZONE}, /* West Australian Daylight */
  133. {"CCT", -480}, /* China Coast, USSR Zone 7 */
  134. {"JST", -540}, /* Japan Standard, USSR Zone 8 */
  135. {"EAST", -600}, /* Eastern Australian Standard */
  136. {"EADT", -600 tDAYZONE}, /* Eastern Australian Daylight */
  137. {"GST", -600}, /* Guam Standard, USSR Zone 9 */
  138. {"NZT", -720}, /* New Zealand */
  139. {"NZST", -720}, /* New Zealand Standard */
  140. {"NZDT", -720 tDAYZONE}, /* New Zealand Daylight */
  141. {"IDLE", -720}, /* International Date Line East */
  142. /* Next up: Military timezone names. RFC822 allowed these, but (as noted in
  143. RFC 1123) had their signs wrong. Here we use the correct signs to match
  144. actual military usage.
  145. */
  146. {"A", 1 * 60}, /* Alpha */
  147. {"B", 2 * 60}, /* Bravo */
  148. {"C", 3 * 60}, /* Charlie */
  149. {"D", 4 * 60}, /* Delta */
  150. {"E", 5 * 60}, /* Echo */
  151. {"F", 6 * 60}, /* Foxtrot */
  152. {"G", 7 * 60}, /* Golf */
  153. {"H", 8 * 60}, /* Hotel */
  154. {"I", 9 * 60}, /* India */
  155. /* "J", Juliet is not used as a timezone, to indicate the observer's local
  156. time */
  157. {"K", 10 * 60}, /* Kilo */
  158. {"L", 11 * 60}, /* Lima */
  159. {"M", 12 * 60}, /* Mike */
  160. {"N", -1 * 60}, /* November */
  161. {"O", -2 * 60}, /* Oscar */
  162. {"P", -3 * 60}, /* Papa */
  163. {"Q", -4 * 60}, /* Quebec */
  164. {"R", -5 * 60}, /* Romeo */
  165. {"S", -6 * 60}, /* Sierra */
  166. {"T", -7 * 60}, /* Tango */
  167. {"U", -8 * 60}, /* Uniform */
  168. {"V", -9 * 60}, /* Victor */
  169. {"W", -10 * 60}, /* Whiskey */
  170. {"X", -11 * 60}, /* X-ray */
  171. {"Y", -12 * 60}, /* Yankee */
  172. {"Z", 0}, /* Zulu, zero meridian, a.k.a. UTC */
  173. };
  174. /* returns:
  175. -1 no day
  176. 0 monday - 6 sunday
  177. */
  178. static int checkday(const char *check, size_t len)
  179. {
  180. int i;
  181. const char * const *what;
  182. bool found = FALSE;
  183. if(len > 3)
  184. what = &weekday[0];
  185. else
  186. what = &Curl_wkday[0];
  187. for(i = 0; i<7; i++) {
  188. if(strcasecompare(check, what[0])) {
  189. found = TRUE;
  190. break;
  191. }
  192. what++;
  193. }
  194. return found?i:-1;
  195. }
  196. static int checkmonth(const char *check)
  197. {
  198. int i;
  199. const char * const *what;
  200. bool found = FALSE;
  201. what = &Curl_month[0];
  202. for(i = 0; i<12; i++) {
  203. if(strcasecompare(check, what[0])) {
  204. found = TRUE;
  205. break;
  206. }
  207. what++;
  208. }
  209. return found?i:-1; /* return the offset or -1, no real offset is -1 */
  210. }
  211. /* return the time zone offset between GMT and the input one, in number
  212. of seconds or -1 if the timezone wasn't found/legal */
  213. static int checktz(const char *check)
  214. {
  215. unsigned int i;
  216. const struct tzinfo *what;
  217. bool found = FALSE;
  218. what = tz;
  219. for(i = 0; i< sizeof(tz)/sizeof(tz[0]); i++) {
  220. if(strcasecompare(check, what->name)) {
  221. found = TRUE;
  222. break;
  223. }
  224. what++;
  225. }
  226. return found?what->offset*60:-1;
  227. }
  228. static void skip(const char **date)
  229. {
  230. /* skip everything that aren't letters or digits */
  231. while(**date && !ISALNUM(**date))
  232. (*date)++;
  233. }
  234. enum assume {
  235. DATE_MDAY,
  236. DATE_YEAR,
  237. DATE_TIME
  238. };
  239. /*
  240. * time2epoch: time stamp to seconds since epoch in GMT time zone. Similar to
  241. * mktime but for GMT only.
  242. */
  243. static time_t time2epoch(int sec, int min, int hour,
  244. int mday, int mon, int year)
  245. {
  246. static const int month_days_cumulative [12] =
  247. { 0, 31, 59, 90, 120, 151, 181, 212, 243, 273, 304, 334 };
  248. int leap_days = year - (mon <= 1);
  249. leap_days = ((leap_days / 4) - (leap_days / 100) + (leap_days / 400)
  250. - (1969 / 4) + (1969 / 100) - (1969 / 400));
  251. return ((((time_t) (year - 1970) * 365
  252. + leap_days + month_days_cumulative[mon] + mday - 1) * 24
  253. + hour) * 60 + min) * 60 + sec;
  254. }
  255. /*
  256. * parsedate()
  257. *
  258. * Returns:
  259. *
  260. * PARSEDATE_OK - a fine conversion
  261. * PARSEDATE_FAIL - failed to convert
  262. * PARSEDATE_LATER - time overflow at the far end of time_t
  263. * PARSEDATE_SOONER - time underflow at the low end of time_t
  264. */
  265. static int parsedate(const char *date, time_t *output)
  266. {
  267. time_t t = 0;
  268. int wdaynum = -1; /* day of the week number, 0-6 (mon-sun) */
  269. int monnum = -1; /* month of the year number, 0-11 */
  270. int mdaynum = -1; /* day of month, 1 - 31 */
  271. int hournum = -1;
  272. int minnum = -1;
  273. int secnum = -1;
  274. int yearnum = -1;
  275. int tzoff = -1;
  276. enum assume dignext = DATE_MDAY;
  277. const char *indate = date; /* save the original pointer */
  278. int part = 0; /* max 6 parts */
  279. while(*date && (part < 6)) {
  280. bool found = FALSE;
  281. skip(&date);
  282. if(ISALPHA(*date)) {
  283. /* a name coming up */
  284. char buf[32]="";
  285. size_t len;
  286. if(sscanf(date, "%31[ABCDEFGHIJKLMNOPQRSTUVWXYZ"
  287. "abcdefghijklmnopqrstuvwxyz]", buf))
  288. len = strlen(buf);
  289. else
  290. len = 0;
  291. if(wdaynum == -1) {
  292. wdaynum = checkday(buf, len);
  293. if(wdaynum != -1)
  294. found = TRUE;
  295. }
  296. if(!found && (monnum == -1)) {
  297. monnum = checkmonth(buf);
  298. if(monnum != -1)
  299. found = TRUE;
  300. }
  301. if(!found && (tzoff == -1)) {
  302. /* this just must be a time zone string */
  303. tzoff = checktz(buf);
  304. if(tzoff != -1)
  305. found = TRUE;
  306. }
  307. if(!found)
  308. return PARSEDATE_FAIL; /* bad string */
  309. date += len;
  310. }
  311. else if(ISDIGIT(*date)) {
  312. /* a digit */
  313. int val;
  314. char *end;
  315. int len = 0;
  316. if((secnum == -1) &&
  317. (3 == sscanf(date, "%02d:%02d:%02d%n",
  318. &hournum, &minnum, &secnum, &len))) {
  319. /* time stamp! */
  320. date += len;
  321. }
  322. else if((secnum == -1) &&
  323. (2 == sscanf(date, "%02d:%02d%n", &hournum, &minnum, &len))) {
  324. /* time stamp without seconds */
  325. date += len;
  326. secnum = 0;
  327. }
  328. else {
  329. long lval;
  330. int error;
  331. int old_errno;
  332. old_errno = errno;
  333. errno = 0;
  334. lval = strtol(date, &end, 10);
  335. error = errno;
  336. if(errno != old_errno)
  337. errno = old_errno;
  338. if(error)
  339. return PARSEDATE_FAIL;
  340. #if LONG_MAX != INT_MAX
  341. if((lval > (long)INT_MAX) || (lval < (long)INT_MIN))
  342. return PARSEDATE_FAIL;
  343. #endif
  344. val = curlx_sltosi(lval);
  345. if((tzoff == -1) &&
  346. ((end - date) == 4) &&
  347. (val <= 1400) &&
  348. (indate< date) &&
  349. ((date[-1] == '+' || date[-1] == '-'))) {
  350. /* four digits and a value less than or equal to 1400 (to take into
  351. account all sorts of funny time zone diffs) and it is preceded
  352. with a plus or minus. This is a time zone indication. 1400 is
  353. picked since +1300 is frequently used and +1400 is mentioned as
  354. an edge number in the document "ISO C 200X Proposal: Timezone
  355. Functions" at http://david.tribble.com/text/c0xtimezone.html If
  356. anyone has a more authoritative source for the exact maximum time
  357. zone offsets, please speak up! */
  358. found = TRUE;
  359. tzoff = (val/100 * 60 + val%100)*60;
  360. /* the + and - prefix indicates the local time compared to GMT,
  361. this we need their reversed math to get what we want */
  362. tzoff = date[-1]=='+'?-tzoff:tzoff;
  363. }
  364. if(((end - date) == 8) &&
  365. (yearnum == -1) &&
  366. (monnum == -1) &&
  367. (mdaynum == -1)) {
  368. /* 8 digits, no year, month or day yet. This is YYYYMMDD */
  369. found = TRUE;
  370. yearnum = val/10000;
  371. monnum = (val%10000)/100-1; /* month is 0 - 11 */
  372. mdaynum = val%100;
  373. }
  374. if(!found && (dignext == DATE_MDAY) && (mdaynum == -1)) {
  375. if((val > 0) && (val<32)) {
  376. mdaynum = val;
  377. found = TRUE;
  378. }
  379. dignext = DATE_YEAR;
  380. }
  381. if(!found && (dignext == DATE_YEAR) && (yearnum == -1)) {
  382. yearnum = val;
  383. found = TRUE;
  384. if(yearnum < 100) {
  385. if(yearnum > 70)
  386. yearnum += 1900;
  387. else
  388. yearnum += 2000;
  389. }
  390. if(mdaynum == -1)
  391. dignext = DATE_MDAY;
  392. }
  393. if(!found)
  394. return PARSEDATE_FAIL;
  395. date = end;
  396. }
  397. }
  398. part++;
  399. }
  400. if(-1 == secnum)
  401. secnum = minnum = hournum = 0; /* no time, make it zero */
  402. if((-1 == mdaynum) ||
  403. (-1 == monnum) ||
  404. (-1 == yearnum))
  405. /* lacks vital info, fail */
  406. return PARSEDATE_FAIL;
  407. #ifdef HAVE_TIME_T_UNSIGNED
  408. if(yearnum < 1970) {
  409. /* only positive numbers cannot return earlier */
  410. *output = TIME_T_MIN;
  411. return PARSEDATE_SOONER;
  412. }
  413. #endif
  414. #if (SIZEOF_TIME_T < 5)
  415. #ifdef HAVE_TIME_T_UNSIGNED
  416. /* an unsigned 32 bit time_t can only hold dates to 2106 */
  417. if(yearnum > 2105) {
  418. *output = TIME_T_MAX;
  419. return PARSEDATE_LATER;
  420. }
  421. #else
  422. /* a signed 32 bit time_t can only hold dates to the beginning of 2038 */
  423. if(yearnum > 2037) {
  424. *output = TIME_T_MAX;
  425. return PARSEDATE_LATER;
  426. }
  427. if(yearnum < 1903) {
  428. *output = TIME_T_MIN;
  429. return PARSEDATE_SOONER;
  430. }
  431. #endif
  432. #else
  433. /* The Gregorian calendar was introduced 1582 */
  434. if(yearnum < 1583)
  435. return PARSEDATE_FAIL;
  436. #endif
  437. if((mdaynum > 31) || (monnum > 11) ||
  438. (hournum > 23) || (minnum > 59) || (secnum > 60))
  439. return PARSEDATE_FAIL; /* clearly an illegal date */
  440. /* time2epoch() returns a time_t. time_t is often 32 bits, sometimes even on
  441. architectures that feature 64 bit 'long' but ultimately time_t is the
  442. correct data type to use.
  443. */
  444. t = time2epoch(secnum, minnum, hournum, mdaynum, monnum, yearnum);
  445. /* Add the time zone diff between local time zone and GMT. */
  446. if(tzoff == -1)
  447. tzoff = 0;
  448. if((tzoff > 0) && (t > TIME_T_MAX - tzoff)) {
  449. *output = TIME_T_MAX;
  450. return PARSEDATE_LATER; /* time_t overflow */
  451. }
  452. t += tzoff;
  453. *output = t;
  454. return PARSEDATE_OK;
  455. }
  456. #else
  457. /* disabled */
  458. static int parsedate(const char *date, time_t *output)
  459. {
  460. (void)date;
  461. *output = 0;
  462. return PARSEDATE_OK; /* a lie */
  463. }
  464. #endif
  465. time_t curl_getdate(const char *p, const time_t *now)
  466. {
  467. time_t parsed = -1;
  468. int rc = parsedate(p, &parsed);
  469. (void)now; /* legacy argument from the past that we ignore */
  470. if(rc == PARSEDATE_OK) {
  471. if(parsed == -1)
  472. /* avoid returning -1 for a working scenario */
  473. parsed++;
  474. return parsed;
  475. }
  476. /* everything else is fail */
  477. return -1;
  478. }
  479. /* Curl_getdate_capped() differs from curl_getdate() in that this will return
  480. TIME_T_MAX in case the parsed time value was too big, instead of an
  481. error. */
  482. time_t Curl_getdate_capped(const char *p)
  483. {
  484. time_t parsed = -1;
  485. int rc = parsedate(p, &parsed);
  486. switch(rc) {
  487. case PARSEDATE_OK:
  488. if(parsed == -1)
  489. /* avoid returning -1 for a working scenario */
  490. parsed++;
  491. return parsed;
  492. case PARSEDATE_LATER:
  493. /* this returns the maximum time value */
  494. return parsed;
  495. default:
  496. return -1; /* everything else is fail */
  497. }
  498. /* UNREACHABLE */
  499. }
  500. /*
  501. * Curl_gmtime() is a gmtime() replacement for portability. Do not use the
  502. * gmtime_r() or gmtime() functions anywhere else but here.
  503. *
  504. */
  505. CURLcode Curl_gmtime(time_t intime, struct tm *store)
  506. {
  507. const struct tm *tm;
  508. #ifdef HAVE_GMTIME_R
  509. /* thread-safe version */
  510. tm = (struct tm *)gmtime_r(&intime, store);
  511. #else
  512. /* !checksrc! disable BANNEDFUNC 1 */
  513. tm = gmtime(&intime);
  514. if(tm)
  515. *store = *tm; /* copy the pointed struct to the local copy */
  516. #endif
  517. if(!tm)
  518. return CURLE_BAD_FUNCTION_ARGUMENT;
  519. return CURLE_OK;
  520. }