annotate src/lib/time-util.c @ 23007:36e01285b5b8

lib: buffer - Improve header comment for buffer_insert() and buffer_delete().
author Stephan Bosch <stephan.bosch@dovecot.fi>
date Mon, 18 Mar 2019 00:52:37 +0100
parents 33a2b955ea19
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
22713
cb108f786fb4 Updated copyright notices to include the year 2018.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 21854
diff changeset
1 /* Copyright (c) 2008-2018 Dovecot authors, see the included COPYING file */
9769
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
2
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
3 #include "lib.h"
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
4 #include "time-util.h"
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
5
13923
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
6 #include <time.h>
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
7
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
8 #define STRFTIME_MAX_BUFSIZE (1024*64)
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
9
9769
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
10 int timeval_cmp(const struct timeval *tv1, const struct timeval *tv2)
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
11 {
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
12 if (tv1->tv_sec < tv2->tv_sec)
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
13 return -1;
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
14 if (tv1->tv_sec > tv2->tv_sec)
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
15 return 1;
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
16 if (tv1->tv_usec < tv2->tv_usec)
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
17 return -1;
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
18 if (tv1->tv_usec > tv2->tv_usec)
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
19 return 1;
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
20 return 0;
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
21 }
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
22
17855
e45dda2d7cd6 lib: Created timeval_cmp_margin().
Stephan Bosch <stephan@rename-it.nl>
parents: 17130
diff changeset
23 int timeval_cmp_margin(const struct timeval *tv1, const struct timeval *tv2,
e45dda2d7cd6 lib: Created timeval_cmp_margin().
Stephan Bosch <stephan@rename-it.nl>
parents: 17130
diff changeset
24 unsigned int usec_margin)
e45dda2d7cd6 lib: Created timeval_cmp_margin().
Stephan Bosch <stephan@rename-it.nl>
parents: 17130
diff changeset
25 {
22804
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
26 unsigned long long usecs_diff;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
27 int sec_margin, ret;
17855
e45dda2d7cd6 lib: Created timeval_cmp_margin().
Stephan Bosch <stephan@rename-it.nl>
parents: 17130
diff changeset
28
22804
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
29 if (tv1->tv_sec < tv2->tv_sec) {
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
30 sec_margin = ((int)usec_margin / 1000000) + 1;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
31 if ((tv2->tv_sec - tv1->tv_sec) > sec_margin)
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
32 return -1;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
33 usecs_diff = (tv2->tv_sec - tv1->tv_sec) * 1000000ULL +
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
34 (tv2->tv_usec - tv1->tv_usec);
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
35 ret = -1;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
36 } else if (tv1->tv_sec > tv2->tv_sec) {
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
37 sec_margin = ((int)usec_margin / 1000000) + 1;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
38 if ((tv1->tv_sec - tv2->tv_sec) > sec_margin)
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
39 return 1;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
40 usecs_diff = (tv1->tv_sec - tv2->tv_sec) * 1000000ULL +
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
41 (tv1->tv_usec - tv2->tv_usec);
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
42 ret = 1;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
43 } else if (tv1->tv_usec < tv2->tv_usec) {
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
44 usecs_diff = tv2->tv_usec - tv1->tv_usec;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
45 ret = -1;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
46 } else {
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
47 usecs_diff = tv1->tv_usec - tv2->tv_usec;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
48 ret = 1;
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
49 }
33a2b955ea19 lib: time-util: Fix timeval_cmp_margin() to correctly handle a margin crossing the second boundary.
Stephan Bosch <stephan.bosch@dovecot.fi>
parents: 22713
diff changeset
50 return usecs_diff > usec_margin ? ret : 0;
17855
e45dda2d7cd6 lib: Created timeval_cmp_margin().
Stephan Bosch <stephan@rename-it.nl>
parents: 17130
diff changeset
51 }
e45dda2d7cd6 lib: Created timeval_cmp_margin().
Stephan Bosch <stephan@rename-it.nl>
parents: 17130
diff changeset
52
9769
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
53 int timeval_diff_msecs(const struct timeval *tv1, const struct timeval *tv2)
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
54 {
9771
6ff08c7c9f03 timeval_diff_*() fixes.
Timo Sirainen <tss@iki.fi>
parents: 9769
diff changeset
55 return timeval_diff_usecs(tv1, tv2) / 1000;
9769
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
56 }
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
57
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
58 long long timeval_diff_usecs(const struct timeval *tv1,
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
59 const struct timeval *tv2)
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
60 {
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
61 time_t secs;
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
62 int usecs;
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
63
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
64 secs = tv1->tv_sec - tv2->tv_sec;
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
65 usecs = tv1->tv_usec - tv2->tv_usec;
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
66 if (usecs < 0) {
9771
6ff08c7c9f03 timeval_diff_*() fixes.
Timo Sirainen <tss@iki.fi>
parents: 9769
diff changeset
67 secs--;
9769
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
68 usecs += 1000000;
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
69 }
15909
f74bf0521d69 Avoid under/overflows in unsigned integer calculations.
Timo Sirainen <tss@iki.fi>
parents: 15715
diff changeset
70 return ((long long)secs * 1000000LL) + usecs;
9769
8716936443db Moved all struct timeval comparing/calculation code to lib/time-util.
Timo Sirainen <tss@iki.fi>
parents:
diff changeset
71 }
13923
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
72
21854
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
73 time_t time_to_local_day_start(time_t t)
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
74 {
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
75 const struct tm *day_tm;
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
76 struct tm tm;
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
77 time_t new_start_time;
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
78
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
79 day_tm = localtime(&t);
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
80 i_zero(&tm);
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
81 tm.tm_year = day_tm->tm_year;
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
82 tm.tm_mon = day_tm->tm_mon;
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
83 tm.tm_mday = day_tm->tm_mday;
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
84 tm.tm_isdst = -1;
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
85 new_start_time = mktime(&tm);
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
86 i_assert(new_start_time != (time_t)-1);
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
87 return new_start_time;
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
88 }
3ffd4442b22c lib: Add time_to_local_day_start()
Timo Sirainen <timo.sirainen@dovecot.fi>
parents: 21390
diff changeset
89
21278
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
90 static const char *strftime_real(const char *fmt, const struct tm *tm)
13923
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
91 {
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
92 size_t bufsize = strlen(fmt) + 32;
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
93 char *buf = t_buffer_get(bufsize);
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
94 size_t ret;
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
95
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
96 while ((ret = strftime(buf, bufsize, fmt, tm)) == 0) {
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
97 bufsize *= 2;
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
98 i_assert(bufsize <= STRFTIME_MAX_BUFSIZE);
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
99 buf = t_buffer_get(bufsize);
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
100 }
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
101 t_buffer_alloc(ret + 1);
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
102 return buf;
22cfba724675 Added t_strflocaltime().
Timo Sirainen <tss@iki.fi>
parents: 12782
diff changeset
103 }
21278
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
104
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
105 const char *t_strftime(const char *fmt, const struct tm *tm)
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
106 {
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
107 return strftime_real(fmt, tm);
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
108 }
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
109
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
110 const char *t_strflocaltime(const char *fmt, time_t t)
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
111 {
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
112 return strftime_real(fmt, localtime(&t));
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
113 }
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
114
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
115 const char *t_strfgmtime(const char *fmt, time_t t)
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
116 {
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
117 return strftime_real(fmt, gmtime(&t));
fcb25852e8b7 lib: add t_strfgmtime and t_strftime
Martti Rannanjärvi <martti.rannanjarvi@dovecot.fi>
parents: 20331
diff changeset
118 }