Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | #ifndef _LINUX_TIME_H |
| 2 | #define _LINUX_TIME_H |
| 3 | |
Thomas Gleixner | 8264445 | 2007-07-21 04:37:37 -0700 | [diff] [blame] | 4 | # include <linux/cache.h> |
Ingo Molnar | 57a5587 | 2006-01-09 20:52:26 -0800 | [diff] [blame] | 5 | # include <linux/seqlock.h> |
Jeremy Fitzhardinge | f595ec9 | 2008-06-12 10:47:56 +0200 | [diff] [blame] | 6 | # include <linux/math64.h> |
John Stultz | 361a3bf | 2014-07-16 21:03:58 +0000 | [diff] [blame] | 7 | # include <linux/time64.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 8 | |
Christoph Hellwig | b418da1 | 2008-10-15 22:02:06 -0700 | [diff] [blame] | 9 | extern struct timezone sys_tz; |
| 10 | |
Thomas Gleixner | df0cc05 | 2008-08-31 08:09:53 -0700 | [diff] [blame] | 11 | #define TIME_T_MAX (time_t)((1UL << ((sizeof(time_t) << 3) - 1)) - 1) |
| 12 | |
Jan Engelhardt | 5b78cc9 | 2007-07-17 04:03:53 -0700 | [diff] [blame] | 13 | static inline int timespec_equal(const struct timespec *a, |
| 14 | const struct timespec *b) |
Ingo Molnar | 57a5587 | 2006-01-09 20:52:26 -0800 | [diff] [blame] | 15 | { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 16 | return (a->tv_sec == b->tv_sec) && (a->tv_nsec == b->tv_nsec); |
Ingo Molnar | 57a5587 | 2006-01-09 20:52:26 -0800 | [diff] [blame] | 17 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 18 | |
Andrew Morton | 643a654 | 2006-02-11 17:55:52 -0800 | [diff] [blame] | 19 | /* |
| 20 | * lhs < rhs: return <0 |
| 21 | * lhs == rhs: return 0 |
| 22 | * lhs > rhs: return >0 |
| 23 | */ |
Rolf Eike Beer | 77adbfb | 2007-02-10 01:45:49 -0800 | [diff] [blame] | 24 | static inline int timespec_compare(const struct timespec *lhs, const struct timespec *rhs) |
Andrew Morton | 643a654 | 2006-02-11 17:55:52 -0800 | [diff] [blame] | 25 | { |
| 26 | if (lhs->tv_sec < rhs->tv_sec) |
| 27 | return -1; |
| 28 | if (lhs->tv_sec > rhs->tv_sec) |
| 29 | return 1; |
| 30 | return lhs->tv_nsec - rhs->tv_nsec; |
| 31 | } |
| 32 | |
Rolf Eike Beer | 77adbfb | 2007-02-10 01:45:49 -0800 | [diff] [blame] | 33 | static inline int timeval_compare(const struct timeval *lhs, const struct timeval *rhs) |
Andrew Morton | 643a654 | 2006-02-11 17:55:52 -0800 | [diff] [blame] | 34 | { |
| 35 | if (lhs->tv_sec < rhs->tv_sec) |
| 36 | return -1; |
| 37 | if (lhs->tv_sec > rhs->tv_sec) |
| 38 | return 1; |
| 39 | return lhs->tv_usec - rhs->tv_usec; |
| 40 | } |
| 41 | |
pang.xunlei | 90b6ce9 | 2014-11-18 19:15:18 +0800 | [diff] [blame] | 42 | extern time64_t mktime64(const unsigned int year, const unsigned int mon, |
| 43 | const unsigned int day, const unsigned int hour, |
| 44 | const unsigned int min, const unsigned int sec); |
| 45 | |
| 46 | /** |
| 47 | * Deprecated. Use mktime64(). |
| 48 | */ |
| 49 | static inline unsigned long mktime(const unsigned int year, |
| 50 | const unsigned int mon, const unsigned int day, |
| 51 | const unsigned int hour, const unsigned int min, |
| 52 | const unsigned int sec) |
| 53 | { |
| 54 | return mktime64(year, mon, day, hour, min, sec); |
| 55 | } |
Ingo Molnar | f481890 | 2006-01-09 20:52:23 -0800 | [diff] [blame] | 56 | |
Thomas Gleixner | 12e0933 | 2009-09-14 23:37:40 +0200 | [diff] [blame] | 57 | extern void set_normalized_timespec(struct timespec *ts, time_t sec, s64 nsec); |
John Stultz | ce3bf7a | 2010-07-13 17:56:19 -0700 | [diff] [blame] | 58 | |
| 59 | /* |
| 60 | * timespec_add_safe assumes both values are positive and checks |
| 61 | * for overflow. It will return TIME_T_MAX if the reutrn would be |
| 62 | * smaller then either of the arguments. |
| 63 | */ |
Thomas Gleixner | df0cc05 | 2008-08-31 08:09:53 -0700 | [diff] [blame] | 64 | extern struct timespec timespec_add_safe(const struct timespec lhs, |
| 65 | const struct timespec rhs); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 66 | |
John Stultz | ce3bf7a | 2010-07-13 17:56:19 -0700 | [diff] [blame] | 67 | |
| 68 | static inline struct timespec timespec_add(struct timespec lhs, |
| 69 | struct timespec rhs) |
| 70 | { |
| 71 | struct timespec ts_delta; |
| 72 | set_normalized_timespec(&ts_delta, lhs.tv_sec + rhs.tv_sec, |
| 73 | lhs.tv_nsec + rhs.tv_nsec); |
| 74 | return ts_delta; |
| 75 | } |
| 76 | |
Thomas Gleixner | 5f82b2b | 2006-01-09 20:52:29 -0800 | [diff] [blame] | 77 | /* |
Shailabh Nagar | ca74e92 | 2006-07-14 00:24:36 -0700 | [diff] [blame] | 78 | * sub = lhs - rhs, in normalized form |
| 79 | */ |
| 80 | static inline struct timespec timespec_sub(struct timespec lhs, |
| 81 | struct timespec rhs) |
| 82 | { |
| 83 | struct timespec ts_delta; |
| 84 | set_normalized_timespec(&ts_delta, lhs.tv_sec - rhs.tv_sec, |
| 85 | lhs.tv_nsec - rhs.tv_nsec); |
| 86 | return ts_delta; |
| 87 | } |
| 88 | |
| 89 | /* |
Thomas Gleixner | 5f82b2b | 2006-01-09 20:52:29 -0800 | [diff] [blame] | 90 | * Returns true if the timespec is norm, false if denorm: |
| 91 | */ |
John Stultz | 4e8b145 | 2012-08-08 15:36:20 -0400 | [diff] [blame] | 92 | static inline bool timespec_valid(const struct timespec *ts) |
| 93 | { |
| 94 | /* Dates before 1970 are bogus */ |
| 95 | if (ts->tv_sec < 0) |
| 96 | return false; |
| 97 | /* Can't have more nanoseconds then a second */ |
| 98 | if ((unsigned long)ts->tv_nsec >= NSEC_PER_SEC) |
| 99 | return false; |
John Stultz | cee5848 | 2012-08-31 13:30:06 -0400 | [diff] [blame] | 100 | return true; |
| 101 | } |
| 102 | |
| 103 | static inline bool timespec_valid_strict(const struct timespec *ts) |
| 104 | { |
| 105 | if (!timespec_valid(ts)) |
| 106 | return false; |
John Stultz | 4e8b145 | 2012-08-08 15:36:20 -0400 | [diff] [blame] | 107 | /* Disallow values that could overflow ktime_t */ |
| 108 | if ((unsigned long long)ts->tv_sec >= KTIME_SEC_MAX) |
| 109 | return false; |
| 110 | return true; |
| 111 | } |
Thomas Gleixner | 5f82b2b | 2006-01-09 20:52:29 -0800 | [diff] [blame] | 112 | |
Sasha Levin | 6ada1fc | 2014-12-03 19:22:48 -0500 | [diff] [blame] | 113 | static inline bool timeval_valid(const struct timeval *tv) |
| 114 | { |
| 115 | /* Dates before 1970 are bogus */ |
| 116 | if (tv->tv_sec < 0) |
| 117 | return false; |
| 118 | |
| 119 | /* Can't have more microseconds then a second */ |
| 120 | if (tv->tv_usec < 0 || tv->tv_usec >= USEC_PER_SEC) |
| 121 | return false; |
| 122 | |
| 123 | return true; |
| 124 | } |
| 125 | |
Thomas Gleixner | 8b094cd | 2014-07-16 21:04:02 +0000 | [diff] [blame] | 126 | extern struct timespec timespec_trunc(struct timespec t, unsigned gran); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 127 | |
John Stultz | 37cf4dc | 2015-12-03 22:09:31 -0500 | [diff] [blame] | 128 | /* |
| 129 | * Validates if a timespec/timeval used to inject a time offset is valid. |
| 130 | * Offsets can be postive or negative. The value of the timeval/timespec |
| 131 | * is the sum of its fields, but *NOTE*: the field tv_usec/tv_nsec must |
| 132 | * always be non-negative. |
| 133 | */ |
| 134 | static inline bool timeval_inject_offset_valid(const struct timeval *tv) |
| 135 | { |
| 136 | /* We don't check the tv_sec as it can be positive or negative */ |
| 137 | |
| 138 | /* Can't have more microseconds then a second */ |
| 139 | if (tv->tv_usec < 0 || tv->tv_usec >= USEC_PER_SEC) |
| 140 | return false; |
| 141 | return true; |
| 142 | } |
| 143 | |
| 144 | static inline bool timespec_inject_offset_valid(const struct timespec *ts) |
| 145 | { |
| 146 | /* We don't check the tv_sec as it can be positive or negative */ |
| 147 | |
| 148 | /* Can't have more nanoseconds then a second */ |
| 149 | if (ts->tv_nsec < 0 || ts->tv_nsec >= NSEC_PER_SEC) |
| 150 | return false; |
| 151 | return true; |
| 152 | } |
| 153 | |
Ingo Molnar | 57a5587 | 2006-01-09 20:52:26 -0800 | [diff] [blame] | 154 | #define CURRENT_TIME (current_kernel_time()) |
john stultz | 2c6b47d | 2007-07-24 17:47:43 -0700 | [diff] [blame] | 155 | #define CURRENT_TIME_SEC ((struct timespec) { get_seconds(), 0 }) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 156 | |
john stultz | 7d27558 | 2009-05-01 13:10:26 -0700 | [diff] [blame] | 157 | /* Some architectures do not supply their own clocksource. |
| 158 | * This is mainly the case in architectures that get their |
| 159 | * inter-tick times by reading the counter on their interval |
| 160 | * timer. Since these timers wrap every tick, they're not really |
| 161 | * useful as clocksources. Wrapping them to act like one is possible |
| 162 | * but not very efficient. So we provide a callout these arches |
| 163 | * can implement for use with the jiffies clocksource to provide |
| 164 | * finer then tick granular time. |
| 165 | */ |
| 166 | #ifdef CONFIG_ARCH_USES_GETTIMEOFFSET |
Stephen Warren | 7b1f620 | 2012-11-07 17:58:54 -0700 | [diff] [blame] | 167 | extern u32 (*arch_gettimeoffset)(void); |
john stultz | 7d27558 | 2009-05-01 13:10:26 -0700 | [diff] [blame] | 168 | #endif |
| 169 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 170 | struct itimerval; |
Ingo Molnar | 57a5587 | 2006-01-09 20:52:26 -0800 | [diff] [blame] | 171 | extern int do_setitimer(int which, struct itimerval *value, |
| 172 | struct itimerval *ovalue); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 173 | extern int do_getitimer(int which, struct itimerval *value); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 174 | |
Thomas Gleixner | 8b094cd | 2014-07-16 21:04:02 +0000 | [diff] [blame] | 175 | extern unsigned int alarm_setitimer(unsigned int seconds); |
| 176 | |
| 177 | extern long do_utimes(int dfd, const char __user *filename, struct timespec *times, int flags); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 178 | |
Frank Mayhar | f06febc | 2008-09-12 09:54:39 -0700 | [diff] [blame] | 179 | struct tms; |
| 180 | extern void do_sys_times(struct tms *); |
| 181 | |
Zhaolei | 57f1f08 | 2009-09-23 15:56:10 -0700 | [diff] [blame] | 182 | /* |
| 183 | * Similar to the struct tm in userspace <time.h>, but it needs to be here so |
| 184 | * that the kernel source is self contained. |
| 185 | */ |
| 186 | struct tm { |
| 187 | /* |
| 188 | * the number of seconds after the minute, normally in the range |
| 189 | * 0 to 59, but can be up to 60 to allow for leap seconds |
| 190 | */ |
| 191 | int tm_sec; |
| 192 | /* the number of minutes after the hour, in the range 0 to 59*/ |
| 193 | int tm_min; |
| 194 | /* the number of hours past midnight, in the range 0 to 23 */ |
| 195 | int tm_hour; |
| 196 | /* the day of the month, in the range 1 to 31 */ |
| 197 | int tm_mday; |
| 198 | /* the number of months since January, in the range 0 to 11 */ |
| 199 | int tm_mon; |
| 200 | /* the number of years since 1900 */ |
| 201 | long tm_year; |
| 202 | /* the number of days since Sunday, in the range 0 to 6 */ |
| 203 | int tm_wday; |
| 204 | /* the number of days since January 1, in the range 0 to 365 */ |
| 205 | int tm_yday; |
| 206 | }; |
| 207 | |
| 208 | void time_to_tm(time_t totalsecs, int offset, struct tm *result); |
| 209 | |
Thomas Gleixner | f8f46da | 2006-01-09 20:52:30 -0800 | [diff] [blame] | 210 | /** |
| 211 | * timespec_to_ns - Convert timespec to nanoseconds |
| 212 | * @ts: pointer to the timespec variable to be converted |
| 213 | * |
| 214 | * Returns the scalar nanosecond representation of the timespec |
| 215 | * parameter. |
| 216 | */ |
Roman Zippel | df869b6 | 2006-03-26 01:38:11 -0800 | [diff] [blame] | 217 | static inline s64 timespec_to_ns(const struct timespec *ts) |
Thomas Gleixner | f8f46da | 2006-01-09 20:52:30 -0800 | [diff] [blame] | 218 | { |
Roman Zippel | df869b6 | 2006-03-26 01:38:11 -0800 | [diff] [blame] | 219 | return ((s64) ts->tv_sec * NSEC_PER_SEC) + ts->tv_nsec; |
Thomas Gleixner | f8f46da | 2006-01-09 20:52:30 -0800 | [diff] [blame] | 220 | } |
| 221 | |
| 222 | /** |
| 223 | * timeval_to_ns - Convert timeval to nanoseconds |
| 224 | * @ts: pointer to the timeval variable to be converted |
| 225 | * |
| 226 | * Returns the scalar nanosecond representation of the timeval |
| 227 | * parameter. |
| 228 | */ |
Roman Zippel | df869b6 | 2006-03-26 01:38:11 -0800 | [diff] [blame] | 229 | static inline s64 timeval_to_ns(const struct timeval *tv) |
Thomas Gleixner | f8f46da | 2006-01-09 20:52:30 -0800 | [diff] [blame] | 230 | { |
Roman Zippel | df869b6 | 2006-03-26 01:38:11 -0800 | [diff] [blame] | 231 | return ((s64) tv->tv_sec * NSEC_PER_SEC) + |
Thomas Gleixner | f8f46da | 2006-01-09 20:52:30 -0800 | [diff] [blame] | 232 | tv->tv_usec * NSEC_PER_USEC; |
| 233 | } |
| 234 | |
| 235 | /** |
| 236 | * ns_to_timespec - Convert nanoseconds to timespec |
| 237 | * @nsec: the nanoseconds value to be converted |
| 238 | * |
| 239 | * Returns the timespec representation of the nsec parameter. |
| 240 | */ |
Roman Zippel | df869b6 | 2006-03-26 01:38:11 -0800 | [diff] [blame] | 241 | extern struct timespec ns_to_timespec(const s64 nsec); |
Thomas Gleixner | f8f46da | 2006-01-09 20:52:30 -0800 | [diff] [blame] | 242 | |
| 243 | /** |
| 244 | * ns_to_timeval - Convert nanoseconds to timeval |
| 245 | * @nsec: the nanoseconds value to be converted |
| 246 | * |
| 247 | * Returns the timeval representation of the nsec parameter. |
| 248 | */ |
Roman Zippel | df869b6 | 2006-03-26 01:38:11 -0800 | [diff] [blame] | 249 | extern struct timeval ns_to_timeval(const s64 nsec); |
Thomas Gleixner | f8f46da | 2006-01-09 20:52:30 -0800 | [diff] [blame] | 250 | |
john stultz | cf3c769 | 2006-06-26 00:25:08 -0700 | [diff] [blame] | 251 | /** |
| 252 | * timespec_add_ns - Adds nanoseconds to a timespec |
| 253 | * @a: pointer to timespec to be incremented |
| 254 | * @ns: unsigned nanoseconds value to be added |
Jeremy Fitzhardinge | 9412e286 | 2008-06-12 10:48:00 +0200 | [diff] [blame] | 255 | * |
| 256 | * This must always be inlined because its used from the x86-64 vdso, |
| 257 | * which cannot call other kernel functions. |
john stultz | cf3c769 | 2006-06-26 00:25:08 -0700 | [diff] [blame] | 258 | */ |
Jeremy Fitzhardinge | 9412e286 | 2008-06-12 10:48:00 +0200 | [diff] [blame] | 259 | static __always_inline void timespec_add_ns(struct timespec *a, u64 ns) |
john stultz | cf3c769 | 2006-06-26 00:25:08 -0700 | [diff] [blame] | 260 | { |
Jeremy Fitzhardinge | 9412e286 | 2008-06-12 10:48:00 +0200 | [diff] [blame] | 261 | a->tv_sec += __iter_div_u64_rem(a->tv_nsec + ns, NSEC_PER_SEC, &ns); |
john stultz | cf3c769 | 2006-06-26 00:25:08 -0700 | [diff] [blame] | 262 | a->tv_nsec = ns; |
| 263 | } |
H. Peter Anvin | 8b3d1cd | 2012-02-07 21:09:05 -0800 | [diff] [blame] | 264 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 265 | #endif |