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
103