blob: 42d2e6ac35f29036583e831723f0e15732eda729 [file] [log] [blame]
Thomas Gleixner97fc79f2006-01-09 20:52:31 -08001/*
2 * include/linux/ktime.h
3 *
4 * ktime_t - nanosecond-resolution time format.
5 *
6 * Copyright(C) 2005, Thomas Gleixner <tglx@linutronix.de>
7 * Copyright(C) 2005, Red Hat, Inc., Ingo Molnar
8 *
9 * data type definitions, declarations, prototypes and macros.
10 *
11 * Started by: Thomas Gleixner and Ingo Molnar
12 *
Thomas Gleixner66188fa2006-02-01 03:05:13 -080013 * Credits:
14 *
15 * Roman Zippel provided the ideas and primary code snippets of
16 * the ktime_t union and further simplifications of the original
17 * code.
18 *
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080019 * For licencing details see kernel-base/COPYING
20 */
21#ifndef _LINUX_KTIME_H
22#define _LINUX_KTIME_H
23
24#include <linux/time.h>
25#include <linux/jiffies.h>
26
Thomas Gleixner2456e852016-12-25 11:38:40 +010027/* Nanosecond scalar representation for kernel time values */
28typedef s64 ktime_t;
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080029
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080030/**
31 * ktime_set - Set a ktime_t variable from a seconds/nanoseconds value
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080032 * @secs: seconds to set
33 * @nsecs: nanoseconds to set
34 *
Yacine Belkadi36019262013-07-24 23:11:53 -070035 * Return: The ktime_t representation of the value.
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080036 */
John Stultzb17b20d2014-07-16 21:03:56 +000037static inline ktime_t ktime_set(const s64 secs, const unsigned long nsecs)
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080038{
Thomas Gleixner96dd7422006-09-06 00:03:42 -070039 if (unlikely(secs >= KTIME_SEC_MAX))
Thomas Gleixner2456e852016-12-25 11:38:40 +010040 return KTIME_MAX;
John Stultzb17b20d2014-07-16 21:03:56 +000041
Thomas Gleixner2456e852016-12-25 11:38:40 +010042 return secs * NSEC_PER_SEC + (s64)nsecs;
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080043}
44
45/* Subtract two ktime_t variables. rem = lhs -rhs: */
Thomas Gleixner2456e852016-12-25 11:38:40 +010046#define ktime_sub(lhs, rhs) ((lhs) - (rhs))
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080047
48/* Add two ktime_t variables. res = lhs + rhs: */
Thomas Gleixner2456e852016-12-25 11:38:40 +010049#define ktime_add(lhs, rhs) ((lhs) + (rhs))
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080050
51/*
Vegard Nossum979515c2016-08-13 01:37:04 +020052 * Same as ktime_add(), but avoids undefined behaviour on overflow; however,
53 * this means that you must check the result for overflow yourself.
54 */
Thomas Gleixner2456e852016-12-25 11:38:40 +010055#define ktime_add_unsafe(lhs, rhs) ((u64) (lhs) + (rhs))
Vegard Nossum979515c2016-08-13 01:37:04 +020056
57/*
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080058 * Add a ktime_t variable and a scalar nanosecond value.
59 * res = kt + nsval:
60 */
Thomas Gleixner2456e852016-12-25 11:38:40 +010061#define ktime_add_ns(kt, nsval) ((kt) + (nsval))
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080062
Arnaldo Carvalho de Meloa2723782007-08-19 17:16:05 -070063/*
64 * Subtract a scalar nanosecod from a ktime_t variable
65 * res = kt - nsval:
66 */
Thomas Gleixner2456e852016-12-25 11:38:40 +010067#define ktime_sub_ns(kt, nsval) ((kt) - (nsval))
Arnaldo Carvalho de Meloa2723782007-08-19 17:16:05 -070068
John Stultz49cd6f82014-07-16 21:03:59 +000069/* convert a timespec64 to ktime_t format: */
70static inline ktime_t timespec64_to_ktime(struct timespec64 ts)
71{
72 return ktime_set(ts.tv_sec, ts.tv_nsec);
73}
74
John Stultz49cd6f82014-07-16 21:03:59 +000075/* Map the ktime_t to timespec conversion to ns_to_timespec function */
Thomas Gleixner2456e852016-12-25 11:38:40 +010076#define ktime_to_timespec64(kt) ns_to_timespec64((kt))
John Stultz49cd6f82014-07-16 21:03:59 +000077
Eric Dumazeta8802d92018-07-11 11:16:41 -070078/* Convert ktime_t to nanoseconds */
79static inline s64 ktime_to_ns(const ktime_t kt)
80{
81 return kt;
82}
Thomas Gleixner97fc79f2006-01-09 20:52:31 -080083
Daniel Borkmann398f3822012-10-28 08:27:19 +000084/**
85 * ktime_compare - Compares two ktime_t variables for less, greater or equal
86 * @cmp1: comparable1
87 * @cmp2: comparable2
88 *
Yacine Belkadi36019262013-07-24 23:11:53 -070089 * Return: ...
Daniel Borkmann398f3822012-10-28 08:27:19 +000090 * cmp1 < cmp2: return <0
91 * cmp1 == cmp2: return 0
92 * cmp1 > cmp2: return >0
93 */
94static inline int ktime_compare(const ktime_t cmp1, const ktime_t cmp2)
95{
Thomas Gleixner2456e852016-12-25 11:38:40 +010096 if (cmp1 < cmp2)
Daniel Borkmann398f3822012-10-28 08:27:19 +000097 return -1;
Thomas Gleixner2456e852016-12-25 11:38:40 +010098 if (cmp1 > cmp2)
Daniel Borkmann398f3822012-10-28 08:27:19 +000099 return 1;
100 return 0;
101}
102
Daniel Borkmann67cb9362014-06-11 18:19:28 +0200103/**
104 * ktime_after - Compare if a ktime_t value is bigger than another one.
105 * @cmp1: comparable1
106 * @cmp2: comparable2
107 *
108 * Return: true if cmp1 happened after cmp2.
109 */
110static inline bool ktime_after(const ktime_t cmp1, const ktime_t cmp2)
111{
112 return ktime_compare(cmp1, cmp2) > 0;
113}
114
115/**
116 * ktime_before - Compare if a ktime_t value is smaller than another one.
117 * @cmp1: comparable1
118 * @cmp2: comparable2
119 *
120 * Return: true if cmp1 happened before cmp2.
121 */
122static inline bool ktime_before(const ktime_t cmp1, const ktime_t cmp2)
123{
124 return ktime_compare(cmp1, cmp2) < 0;
125}
126
Thomas Gleixner166afb62014-07-16 21:03:55 +0000127#if BITS_PER_LONG < 64
John Stultzf7bcb702015-05-08 13:47:23 -0700128extern s64 __ktime_divns(const ktime_t kt, s64 div);
129static inline s64 ktime_divns(const ktime_t kt, s64 div)
Nicolas Pitre8b618622014-12-03 14:43:06 -0500130{
John Stultzf7bcb702015-05-08 13:47:23 -0700131 /*
132 * Negative divisors could cause an inf loop,
133 * so bug out here.
134 */
135 BUG_ON(div < 0);
Nicolas Pitre8b618622014-12-03 14:43:06 -0500136 if (__builtin_constant_p(div) && !(div >> 32)) {
Thomas Gleixner2456e852016-12-25 11:38:40 +0100137 s64 ns = kt;
John Stultzf7bcb702015-05-08 13:47:23 -0700138 u64 tmp = ns < 0 ? -ns : ns;
139
140 do_div(tmp, div);
141 return ns < 0 ? -tmp : tmp;
Nicolas Pitre8b618622014-12-03 14:43:06 -0500142 } else {
143 return __ktime_divns(kt, div);
144 }
145}
Thomas Gleixner166afb62014-07-16 21:03:55 +0000146#else /* BITS_PER_LONG < 64 */
John Stultzf7bcb702015-05-08 13:47:23 -0700147static inline s64 ktime_divns(const ktime_t kt, s64 div)
148{
149 /*
150 * 32-bit implementation cannot handle negative divisors,
151 * so catch them on 64bit as well.
152 */
153 WARN_ON(div < 0);
Thomas Gleixner2456e852016-12-25 11:38:40 +0100154 return kt / div;
John Stultzf7bcb702015-05-08 13:47:23 -0700155}
Thomas Gleixner166afb62014-07-16 21:03:55 +0000156#endif
157
YOSHIFUJI Hideaki84299b32007-04-24 16:21:38 -0700158static inline s64 ktime_to_us(const ktime_t kt)
159{
Thomas Gleixner166afb62014-07-16 21:03:55 +0000160 return ktime_divns(kt, NSEC_PER_USEC);
YOSHIFUJI Hideaki84299b32007-04-24 16:21:38 -0700161}
162
Chuck Leverf56916b2010-05-07 13:34:37 -0400163static inline s64 ktime_to_ms(const ktime_t kt)
164{
Thomas Gleixner166afb62014-07-16 21:03:55 +0000165 return ktime_divns(kt, NSEC_PER_MSEC);
Chuck Leverf56916b2010-05-07 13:34:37 -0400166}
167
Gerrit Renkerf1c91da2007-06-16 12:38:51 -0300168static inline s64 ktime_us_delta(const ktime_t later, const ktime_t earlier)
169{
170 return ktime_to_us(ktime_sub(later, earlier));
171}
172
Chunyan Zhang41fbf3b2014-12-17 13:11:35 +0800173static inline s64 ktime_ms_delta(const ktime_t later, const ktime_t earlier)
174{
175 return ktime_to_ms(ktime_sub(later, earlier));
176}
177
Arnaldo Carvalho de Melo1e180f72007-06-16 12:39:38 -0300178static inline ktime_t ktime_add_us(const ktime_t kt, const u64 usec)
179{
Liu Yinga44b8bd2013-05-07 16:38:40 +0800180 return ktime_add_ns(kt, usec * NSEC_PER_USEC);
Arnaldo Carvalho de Melo1e180f72007-06-16 12:39:38 -0300181}
182
Daniel Borkmannd36f82b2013-06-25 18:17:26 +0200183static inline ktime_t ktime_add_ms(const ktime_t kt, const u64 msec)
184{
185 return ktime_add_ns(kt, msec * NSEC_PER_MSEC);
186}
187
Arnaldo Carvalho de Meloa2723782007-08-19 17:16:05 -0700188static inline ktime_t ktime_sub_us(const ktime_t kt, const u64 usec)
189{
Liu Yinga44b8bd2013-05-07 16:38:40 +0800190 return ktime_sub_ns(kt, usec * NSEC_PER_USEC);
Arnaldo Carvalho de Meloa2723782007-08-19 17:16:05 -0700191}
192
David Howells77f2efc2016-09-22 00:29:01 +0100193static inline ktime_t ktime_sub_ms(const ktime_t kt, const u64 msec)
194{
195 return ktime_sub_ns(kt, msec * NSEC_PER_MSEC);
196}
197
Thomas Gleixner5a7780e2008-02-13 09:20:43 +0100198extern ktime_t ktime_add_safe(const ktime_t lhs, const ktime_t rhs);
199
Daniel Borkmann6e94d1e2013-04-16 01:29:10 +0000200/**
John Stultz49cd6f82014-07-16 21:03:59 +0000201 * ktime_to_timespec64_cond - convert a ktime_t variable to timespec64
202 * format only if the variable contains data
203 * @kt: the ktime_t variable to convert
204 * @ts: the timespec variable to store the result in
205 *
206 * Return: %true if there was a successful conversion, %false if kt was 0.
207 */
208static inline __must_check bool ktime_to_timespec64_cond(const ktime_t kt,
209 struct timespec64 *ts)
210{
Thomas Gleixner2456e852016-12-25 11:38:40 +0100211 if (kt) {
John Stultz49cd6f82014-07-16 21:03:59 +0000212 *ts = ktime_to_timespec64(kt);
213 return true;
214 } else {
215 return false;
216 }
217}
218
Vincenzo Frascinocc56f322020-03-20 14:53:39 +0000219#include <vdso/ktime.h>
Thomas Gleixnerc0a31322006-01-09 20:52:32 -0800220
Ingo Molnar57d3da22008-02-27 14:05:10 +0100221static inline ktime_t ns_to_ktime(u64 ns)
222{
Thomas Gleixner2456e852016-12-25 11:38:40 +0100223 return ns;
Ingo Molnar57d3da22008-02-27 14:05:10 +0100224}
225
Daniel Borkmannd36f82b2013-06-25 18:17:26 +0200226static inline ktime_t ms_to_ktime(u64 ms)
227{
Thomas Gleixner2456e852016-12-25 11:38:40 +0100228 return ms * NSEC_PER_MSEC;
Daniel Borkmannd36f82b2013-06-25 18:17:26 +0200229}
230
Thomas Gleixner8b094cd2014-07-16 21:04:02 +0000231# include <linux/timekeeping.h>
Arnd Bergmann65469112017-10-19 13:14:49 +0200232# include <linux/timekeeping32.h>
Thomas Gleixner8b094cd2014-07-16 21:04:02 +0000233
Thomas Gleixner97fc79f2006-01-09 20:52:31 -0800234#endif