include/linux/time.h

   1 /* SPDX-License-Identifier: GPL-2.0 */
   2 #ifndef _LINUX_TIME_H
   3 #define _LINUX_TIME_H
   4
   5 # include <linux/cache.h>
   6 # include <linux/math64.h>
   7 # include <linux/time64.h>
   8
   9 extern struct timezone sys_tz;
  10
  11 int get_timespec64(struct timespec64 *ts,
  12                 const struct __kernel_timespec __user *uts);
  13 int put_timespec64(const struct timespec64 *ts,
  14                 struct __kernel_timespec __user *uts);
  15 int get_itimerspec64(struct itimerspec64 *it,
  16                         const struct __kernel_itimerspec __user *uit);
  17 int put_itimerspec64(const struct itimerspec64 *it,
  18                         struct __kernel_itimerspec __user *uit);
  19
  20 extern time64_t mktime64(const unsigned int year, const unsigned int mon,
  21                         const unsigned int day, const unsigned int hour,
  22                         const unsigned int min, const unsigned int sec);
  23
  24 #ifdef CONFIG_POSIX_TIMERS
  25 extern void clear_itimer(void);
  26 #else
  27 static inline void clear_itimer(void) {}
  28 #endif
  29
  30 extern long do_utimes(int dfd, const char __user *filename, struct timespec64 *times, int flags);
  31
  32 /*
  33  * Similar to the struct tm in userspace <time.h>, but it needs to be here so
  34  * that the kernel source is self contained.
  35  */
  36 struct tm {
  37         /*
  38          * the number of seconds after the minute, normally in the range
  39          * 0 to 59, but can be up to 60 to allow for leap seconds
  40          */
  41         int tm_sec;
  42         /* the number of minutes after the hour, in the range 0 to 59*/
  43         int tm_min;
  44         /* the number of hours past midnight, in the range 0 to 23 */
  45         int tm_hour;
  46         /* the day of the month, in the range 1 to 31 */
  47         int tm_mday;
  48         /* the number of months since January, in the range 0 to 11 */
  49         int tm_mon;
  50         /* the number of years since 1900 */
  51         long tm_year;
  52         /* the number of days since Sunday, in the range 0 to 6 */
  53         int tm_wday;
  54         /* the number of days since January 1, in the range 0 to 365 */
  55         int tm_yday;
  56 };
  57
  58 void time64_to_tm(time64_t totalsecs, int offset, struct tm *result);
  59
  60 # include <linux/time32.h>
  61
  62 static inline bool itimerspec64_valid(const struct itimerspec64 *its)
  63 {
  64         if (!timespec64_valid(&(its->it_interval)) ||
  65                 !timespec64_valid(&(its->it_value)))
  66                 return false;
  67
  68         return true;
  69 }
  70
  71 /**
  72  * time_after32 - compare two 32-bit relative times
  73  * @a:  the time which may be after @b
  74  * @b:  the time which may be before @a
  75  *
  76  * time_after32(a, b) returns true if the time @a is after time @b.
  77  * time_before32(b, a) returns true if the time @b is before time @a.
  78  *
  79  * Similar to time_after(), compare two 32-bit timestamps for relative
  80  * times.  This is useful for comparing 32-bit seconds values that can't
  81  * be converted to 64-bit values (e.g. due to disk format or wire protocol
  82  * issues) when it is known that the times are less than 68 years apart.
  83  */
  84 #define time_after32(a, b)      ((s32)((u32)(b) - (u32)(a)) < 0)
  85 #define time_before32(b, a)     time_after32(a, b)
  86
  87 /**
  88  * time_between32 - check if a 32-bit timestamp is within a given time range
  89  * @t:  the time which may be within [l,h]
  90  * @l:  the lower bound of the range
  91  * @h:  the higher bound of the range
  92  *
  93  * time_before32(t, l, h) returns true if @l <= @t <= @h. All operands are
  94  * treated as 32-bit integers.
  95  *
  96  * Equivalent to !(time_before32(@t, @l) || time_after32(@t, @h)).
  97  */
  98 #define time_between32(t, l, h) ((u32)(h) - (u32)(l) >= (u32)(t) - (u32)(l))
  99
 100 # include <vdso/time.h>
 101
 102 #endif