time.h 8.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274
  1. #ifndef _LINUX_TIME_H
  2. #define _LINUX_TIME_H
  3. # include <linux/cache.h>
  4. # include <linux/seqlock.h>
  5. # include <linux/math64.h>
  6. #include <uapi/linux/time.h>
  7. extern struct timezone sys_tz;
  8. /* Parameters used to convert the timespec values: */
  9. #define MSEC_PER_SEC 1000L
  10. #define USEC_PER_MSEC 1000L
  11. #define NSEC_PER_USEC 1000L
  12. #define NSEC_PER_MSEC 1000000L
  13. #define USEC_PER_SEC 1000000L
  14. #define NSEC_PER_SEC 1000000000L
  15. #define FSEC_PER_SEC 1000000000000000LL
  16. #define TIME_T_MAX (time_t)((1UL << ((sizeof(time_t) << 3) - 1)) - 1)
  17. static inline int timespec_equal(const struct timespec *a,
  18. const struct timespec *b)
  19. {
  20. return (a->tv_sec == b->tv_sec) && (a->tv_nsec == b->tv_nsec);
  21. }
  22. /*
  23. * lhs < rhs: return <0
  24. * lhs == rhs: return 0
  25. * lhs > rhs: return >0
  26. */
  27. static inline int timespec_compare(const struct timespec *lhs, const struct timespec *rhs)
  28. {
  29. if (lhs->tv_sec < rhs->tv_sec)
  30. return -1;
  31. if (lhs->tv_sec > rhs->tv_sec)
  32. return 1;
  33. return lhs->tv_nsec - rhs->tv_nsec;
  34. }
  35. static inline int timeval_compare(const struct timeval *lhs, const struct timeval *rhs)
  36. {
  37. if (lhs->tv_sec < rhs->tv_sec)
  38. return -1;
  39. if (lhs->tv_sec > rhs->tv_sec)
  40. return 1;
  41. return lhs->tv_usec - rhs->tv_usec;
  42. }
  43. extern unsigned long mktime(const unsigned int year, const unsigned int mon,
  44. const unsigned int day, const unsigned int hour,
  45. const unsigned int min, const unsigned int sec);
  46. extern void set_normalized_timespec(struct timespec *ts, time_t sec, s64 nsec);
  47. /*
  48. * timespec_add_safe assumes both values are positive and checks
  49. * for overflow. It will return TIME_T_MAX if the reutrn would be
  50. * smaller then either of the arguments.
  51. */
  52. extern struct timespec timespec_add_safe(const struct timespec lhs,
  53. const struct timespec rhs);
  54. static inline struct timespec timespec_add(struct timespec lhs,
  55. struct timespec rhs)
  56. {
  57. struct timespec ts_delta;
  58. set_normalized_timespec(&ts_delta, lhs.tv_sec + rhs.tv_sec,
  59. lhs.tv_nsec + rhs.tv_nsec);
  60. return ts_delta;
  61. }
  62. /*
  63. * sub = lhs - rhs, in normalized form
  64. */
  65. static inline struct timespec timespec_sub(struct timespec lhs,
  66. struct timespec rhs)
  67. {
  68. struct timespec ts_delta;
  69. set_normalized_timespec(&ts_delta, lhs.tv_sec - rhs.tv_sec,
  70. lhs.tv_nsec - rhs.tv_nsec);
  71. return ts_delta;
  72. }
  73. #define KTIME_MAX ((s64)~((u64)1 << 63))
  74. #if (BITS_PER_LONG == 64)
  75. # define KTIME_SEC_MAX (KTIME_MAX / NSEC_PER_SEC)
  76. #else
  77. # define KTIME_SEC_MAX LONG_MAX
  78. #endif
  79. /*
  80. * Returns true if the timespec is norm, false if denorm:
  81. */
  82. static inline bool timespec_valid(const struct timespec *ts)
  83. {
  84. /* Dates before 1970 are bogus */
  85. if (ts->tv_sec < 0)
  86. return false;
  87. /* Can't have more nanoseconds then a second */
  88. if ((unsigned long)ts->tv_nsec >= NSEC_PER_SEC)
  89. return false;
  90. return true;
  91. }
  92. static inline bool timespec_valid_strict(const struct timespec *ts)
  93. {
  94. if (!timespec_valid(ts))
  95. return false;
  96. /* Disallow values that could overflow ktime_t */
  97. if ((unsigned long long)ts->tv_sec >= KTIME_SEC_MAX)
  98. return false;
  99. return true;
  100. }
  101. extern bool persistent_clock_exist;
  102. #ifdef ALWAYS_USE_PERSISTENT_CLOCK
  103. #define has_persistent_clock() true
  104. #else
  105. static inline bool has_persistent_clock(void)
  106. {
  107. return persistent_clock_exist;
  108. }
  109. #endif
  110. extern void read_persistent_clock(struct timespec *ts);
  111. extern void read_boot_clock(struct timespec *ts);
  112. extern int persistent_clock_is_local;
  113. extern int update_persistent_clock(struct timespec now);
  114. void timekeeping_init(void);
  115. extern int timekeeping_suspended;
  116. unsigned long get_seconds(void);
  117. struct timespec current_kernel_time(void);
  118. struct timespec __current_kernel_time(void); /* does not take xtime_lock */
  119. struct timespec get_monotonic_coarse(void);
  120. void get_xtime_and_monotonic_and_sleep_offset(struct timespec *xtim,
  121. struct timespec *wtom, struct timespec *sleep);
  122. void timekeeping_inject_sleeptime(struct timespec *delta);
  123. #define CURRENT_TIME (current_kernel_time())
  124. #define CURRENT_TIME_SEC ((struct timespec) { get_seconds(), 0 })
  125. /* Some architectures do not supply their own clocksource.
  126. * This is mainly the case in architectures that get their
  127. * inter-tick times by reading the counter on their interval
  128. * timer. Since these timers wrap every tick, they're not really
  129. * useful as clocksources. Wrapping them to act like one is possible
  130. * but not very efficient. So we provide a callout these arches
  131. * can implement for use with the jiffies clocksource to provide
  132. * finer then tick granular time.
  133. */
  134. #ifdef CONFIG_ARCH_USES_GETTIMEOFFSET
  135. extern u32 (*arch_gettimeoffset)(void);
  136. #endif
  137. extern void do_gettimeofday(struct timeval *tv);
  138. extern int do_settimeofday(const struct timespec *tv);
  139. extern int do_sys_settimeofday(const struct timespec *tv,
  140. const struct timezone *tz);
  141. #define do_posix_clock_monotonic_gettime(ts) ktime_get_ts(ts)
  142. extern long do_utimes(int dfd, const char __user *filename, struct timespec *times, int flags);
  143. struct itimerval;
  144. extern int do_setitimer(int which, struct itimerval *value,
  145. struct itimerval *ovalue);
  146. extern unsigned int alarm_setitimer(unsigned int seconds);
  147. extern int do_getitimer(int which, struct itimerval *value);
  148. extern int __getnstimeofday(struct timespec *tv);
  149. extern void getnstimeofday(struct timespec *tv);
  150. extern void getrawmonotonic(struct timespec *ts);
  151. extern void getnstime_raw_and_real(struct timespec *ts_raw,
  152. struct timespec *ts_real);
  153. extern void getboottime(struct timespec *ts);
  154. extern void monotonic_to_bootbased(struct timespec *ts);
  155. extern void get_monotonic_boottime(struct timespec *ts);
  156. extern struct timespec timespec_trunc(struct timespec t, unsigned gran);
  157. extern int timekeeping_valid_for_hres(void);
  158. extern u64 timekeeping_max_deferment(void);
  159. extern int timekeeping_inject_offset(struct timespec *ts);
  160. extern s32 timekeeping_get_tai_offset(void);
  161. extern void timekeeping_set_tai_offset(s32 tai_offset);
  162. extern void timekeeping_clocktai(struct timespec *ts);
  163. struct tms;
  164. extern void do_sys_times(struct tms *);
  165. /*
  166. * Similar to the struct tm in userspace <time.h>, but it needs to be here so
  167. * that the kernel source is self contained.
  168. */
  169. struct tm {
  170. /*
  171. * the number of seconds after the minute, normally in the range
  172. * 0 to 59, but can be up to 60 to allow for leap seconds
  173. */
  174. int tm_sec;
  175. /* the number of minutes after the hour, in the range 0 to 59*/
  176. int tm_min;
  177. /* the number of hours past midnight, in the range 0 to 23 */
  178. int tm_hour;
  179. /* the day of the month, in the range 1 to 31 */
  180. int tm_mday;
  181. /* the number of months since January, in the range 0 to 11 */
  182. int tm_mon;
  183. /* the number of years since 1900 */
  184. long tm_year;
  185. /* the number of days since Sunday, in the range 0 to 6 */
  186. int tm_wday;
  187. /* the number of days since January 1, in the range 0 to 365 */
  188. int tm_yday;
  189. };
  190. void time_to_tm(time_t totalsecs, int offset, struct tm *result);
  191. /**
  192. * timespec_to_ns - Convert timespec to nanoseconds
  193. * @ts: pointer to the timespec variable to be converted
  194. *
  195. * Returns the scalar nanosecond representation of the timespec
  196. * parameter.
  197. */
  198. static inline s64 timespec_to_ns(const struct timespec *ts)
  199. {
  200. return ((s64) ts->tv_sec * NSEC_PER_SEC) + ts->tv_nsec;
  201. }
  202. /**
  203. * timeval_to_ns - Convert timeval to nanoseconds
  204. * @ts: pointer to the timeval variable to be converted
  205. *
  206. * Returns the scalar nanosecond representation of the timeval
  207. * parameter.
  208. */
  209. static inline s64 timeval_to_ns(const struct timeval *tv)
  210. {
  211. return ((s64) tv->tv_sec * NSEC_PER_SEC) +
  212. tv->tv_usec * NSEC_PER_USEC;
  213. }
  214. /**
  215. * ns_to_timespec - Convert nanoseconds to timespec
  216. * @nsec: the nanoseconds value to be converted
  217. *
  218. * Returns the timespec representation of the nsec parameter.
  219. */
  220. extern struct timespec ns_to_timespec(const s64 nsec);
  221. /**
  222. * ns_to_timeval - Convert nanoseconds to timeval
  223. * @nsec: the nanoseconds value to be converted
  224. *
  225. * Returns the timeval representation of the nsec parameter.
  226. */
  227. extern struct timeval ns_to_timeval(const s64 nsec);
  228. /**
  229. * timespec_add_ns - Adds nanoseconds to a timespec
  230. * @a: pointer to timespec to be incremented
  231. * @ns: unsigned nanoseconds value to be added
  232. *
  233. * This must always be inlined because its used from the x86-64 vdso,
  234. * which cannot call other kernel functions.
  235. */
  236. static __always_inline void timespec_add_ns(struct timespec *a, u64 ns)
  237. {
  238. a->tv_sec += __iter_div_u64_rem(a->tv_nsec + ns, NSEC_PER_SEC, &ns);
  239. a->tv_nsec = ns;
  240. }
  241. #endif