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
  9extern struct timezone sys_tz;
 10
 11int get_timespec64(struct timespec64 *ts,
 12		const struct __kernel_timespec __user *uts);
 13int put_timespec64(const struct timespec64 *ts,
 14		struct __kernel_timespec __user *uts);
 15int get_itimerspec64(struct itimerspec64 *it,
 16			const struct __kernel_itimerspec __user *uit);
 17int put_itimerspec64(const struct itimerspec64 *it,
 18			struct __kernel_itimerspec __user *uit);
 19
 20extern 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
 25extern void clear_itimer(void);
 26#else
 27static inline void clear_itimer(void) {}
 28#endif
 29
 30extern 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 */
 36struct 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
 58void time64_to_tm(time64_t totalsecs, int offset, struct tm *result);
 59
 60# include <linux/time32.h>
 61
 62static 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