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

source code of linux/include/linux/time.h