time.h 8.3 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6
#ifndef _LINUX_TIME_H
#define _LINUX_TIME_H

#include <linux/types.h>

#ifdef __KERNEL__
7
# include <linux/cache.h>
8
# include <linux/seqlock.h>
9
# include <linux/math64.h>
L
Linus Torvalds 已提交
10 11 12 13 14
#endif

#ifndef _STRUCT_TIMESPEC
#define _STRUCT_TIMESPEC
struct timespec {
15 16
	__kernel_time_t	tv_sec;			/* seconds */
	long		tv_nsec;		/* nanoseconds */
L
Linus Torvalds 已提交
17
};
18
#endif
L
Linus Torvalds 已提交
19 20

struct timeval {
21 22
	__kernel_time_t		tv_sec;		/* seconds */
	__kernel_suseconds_t	tv_usec;	/* microseconds */
L
Linus Torvalds 已提交
23 24 25 26 27 28 29 30 31
};

struct timezone {
	int	tz_minuteswest;	/* minutes west of Greenwich */
	int	tz_dsttime;	/* type of dst correction */
};

#ifdef __KERNEL__

32 33
extern struct timezone sys_tz;

34
/* Parameters used to convert the timespec values: */
35 36 37 38 39 40 41
#define MSEC_PER_SEC	1000L
#define USEC_PER_MSEC	1000L
#define NSEC_PER_USEC	1000L
#define NSEC_PER_MSEC	1000000L
#define USEC_PER_SEC	1000000L
#define NSEC_PER_SEC	1000000000L
#define FSEC_PER_SEC	1000000000000000L
L
Linus Torvalds 已提交
42

43 44
#define TIME_T_MAX	(time_t)((1UL << ((sizeof(time_t) << 3) - 1)) - 1)

45 46
static inline int timespec_equal(const struct timespec *a,
                                 const struct timespec *b)
47
{
L
Linus Torvalds 已提交
48
	return (a->tv_sec == b->tv_sec) && (a->tv_nsec == b->tv_nsec);
49
}
L
Linus Torvalds 已提交
50

51 52 53 54 55
/*
 * lhs < rhs:  return <0
 * lhs == rhs: return 0
 * lhs > rhs:  return >0
 */
56
static inline int timespec_compare(const struct timespec *lhs, const struct timespec *rhs)
57 58 59 60 61 62 63 64
{
	if (lhs->tv_sec < rhs->tv_sec)
		return -1;
	if (lhs->tv_sec > rhs->tv_sec)
		return 1;
	return lhs->tv_nsec - rhs->tv_nsec;
}

65
static inline int timeval_compare(const struct timeval *lhs, const struct timeval *rhs)
66 67 68 69 70 71 72 73
{
	if (lhs->tv_sec < rhs->tv_sec)
		return -1;
	if (lhs->tv_sec > rhs->tv_sec)
		return 1;
	return lhs->tv_usec - rhs->tv_usec;
}

74 75 76 77
extern unsigned long mktime(const unsigned int year, const unsigned int mon,
			    const unsigned int day, const unsigned int hour,
			    const unsigned int min, const unsigned int sec);

78
extern void set_normalized_timespec(struct timespec *ts, time_t sec, s64 nsec);
79 80
extern struct timespec timespec_add_safe(const struct timespec lhs,
					 const struct timespec rhs);
L
Linus Torvalds 已提交
81

82 83 84 85 86 87 88 89 90 91 92 93
/*
 * sub = lhs - rhs, in normalized form
 */
static inline struct timespec timespec_sub(struct timespec lhs,
						struct timespec rhs)
{
	struct timespec ts_delta;
	set_normalized_timespec(&ts_delta, lhs.tv_sec - rhs.tv_sec,
				lhs.tv_nsec - rhs.tv_nsec);
	return ts_delta;
}

94 95 96 97
/*
 * Returns true if the timespec is norm, false if denorm:
 */
#define timespec_valid(ts) \
98
	(((ts)->tv_sec >= 0) && (((unsigned long) (ts)->tv_nsec) < NSEC_PER_SEC))
99

L
Linus Torvalds 已提交
100 101
extern struct timespec xtime;
extern struct timespec wall_to_monotonic;
A
Adrian Bunk 已提交
102
extern seqlock_t xtime_lock;
L
Linus Torvalds 已提交
103

104
extern void read_persistent_clock(struct timespec *ts);
105
extern void read_boot_clock(struct timespec *ts);
106 107
extern int update_persistent_clock(struct timespec now);
extern int no_sync_cmos_clock __read_mostly;
108
void timekeeping_init(void);
109
extern int timekeeping_suspended;
110

111
unsigned long get_seconds(void);
L
Linus Torvalds 已提交
112
struct timespec current_kernel_time(void);
113 114
struct timespec __current_kernel_time(void); /* does not hold xtime_lock */
struct timespec get_monotonic_coarse(void);
L
Linus Torvalds 已提交
115

116
#define CURRENT_TIME		(current_kernel_time())
117
#define CURRENT_TIME_SEC	((struct timespec) { get_seconds(), 0 })
L
Linus Torvalds 已提交
118

119 120 121 122 123 124 125 126 127 128 129 130 131 132 133
/* Some architectures do not supply their own clocksource.
 * This is mainly the case in architectures that get their
 * inter-tick times by reading the counter on their interval
 * timer. Since these timers wrap every tick, they're not really
 * useful as clocksources. Wrapping them to act like one is possible
 * but not very efficient. So we provide a callout these arches
 * can implement for use with the jiffies clocksource to provide
 * finer then tick granular time.
 */
#ifdef CONFIG_ARCH_USES_GETTIMEOFFSET
extern u32 arch_gettimeoffset(void);
#else
static inline u32 arch_gettimeoffset(void) { return 0; }
#endif

L
Linus Torvalds 已提交
134 135 136
extern void do_gettimeofday(struct timeval *tv);
extern int do_settimeofday(struct timespec *tv);
extern int do_sys_settimeofday(struct timespec *tv, struct timezone *tz);
137
#define do_posix_clock_monotonic_gettime(ts) ktime_get_ts(ts)
U
Ulrich Drepper 已提交
138
extern long do_utimes(int dfd, char __user *filename, struct timespec *times, int flags);
L
Linus Torvalds 已提交
139
struct itimerval;
140 141
extern int do_setitimer(int which, struct itimerval *value,
			struct itimerval *ovalue);
142
extern unsigned int alarm_setitimer(unsigned int seconds);
L
Linus Torvalds 已提交
143
extern int do_getitimer(int which, struct itimerval *value);
144
extern void getnstimeofday(struct timespec *tv);
145
extern void getrawmonotonic(struct timespec *ts);
T
Tomas Janousek 已提交
146 147
extern void getboottime(struct timespec *ts);
extern void monotonic_to_bootbased(struct timespec *ts);
L
Linus Torvalds 已提交
148 149

extern struct timespec timespec_trunc(struct timespec t, unsigned gran);
150
extern int timekeeping_valid_for_hres(void);
151
extern u64 timekeeping_max_deferment(void);
152
extern void update_wall_time(void);
153
extern void timekeeping_leap_insert(int leapsecond);
L
Linus Torvalds 已提交
154

155 156 157
struct tms;
extern void do_sys_times(struct tms *);

158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185
/*
 * Similar to the struct tm in userspace <time.h>, but it needs to be here so
 * that the kernel source is self contained.
 */
struct tm {
	/*
	 * the number of seconds after the minute, normally in the range
	 * 0 to 59, but can be up to 60 to allow for leap seconds
	 */
	int tm_sec;
	/* the number of minutes after the hour, in the range 0 to 59*/
	int tm_min;
	/* the number of hours past midnight, in the range 0 to 23 */
	int tm_hour;
	/* the day of the month, in the range 1 to 31 */
	int tm_mday;
	/* the number of months since January, in the range 0 to 11 */
	int tm_mon;
	/* the number of years since 1900 */
	long tm_year;
	/* the number of days since Sunday, in the range 0 to 6 */
	int tm_wday;
	/* the number of days since January 1, in the range 0 to 365 */
	int tm_yday;
};

void time_to_tm(time_t totalsecs, int offset, struct tm *result);

186 187 188 189 190 191 192
/**
 * timespec_to_ns - Convert timespec to nanoseconds
 * @ts:		pointer to the timespec variable to be converted
 *
 * Returns the scalar nanosecond representation of the timespec
 * parameter.
 */
193
static inline s64 timespec_to_ns(const struct timespec *ts)
194
{
195
	return ((s64) ts->tv_sec * NSEC_PER_SEC) + ts->tv_nsec;
196 197 198 199 200 201 202 203 204
}

/**
 * timeval_to_ns - Convert timeval to nanoseconds
 * @ts:		pointer to the timeval variable to be converted
 *
 * Returns the scalar nanosecond representation of the timeval
 * parameter.
 */
205
static inline s64 timeval_to_ns(const struct timeval *tv)
206
{
207
	return ((s64) tv->tv_sec * NSEC_PER_SEC) +
208 209 210 211 212 213 214 215 216
		tv->tv_usec * NSEC_PER_USEC;
}

/**
 * ns_to_timespec - Convert nanoseconds to timespec
 * @nsec:	the nanoseconds value to be converted
 *
 * Returns the timespec representation of the nsec parameter.
 */
217
extern struct timespec ns_to_timespec(const s64 nsec);
218 219 220 221 222 223 224

/**
 * ns_to_timeval - Convert nanoseconds to timeval
 * @nsec:	the nanoseconds value to be converted
 *
 * Returns the timeval representation of the nsec parameter.
 */
225
extern struct timeval ns_to_timeval(const s64 nsec);
226

227 228 229 230
/**
 * timespec_add_ns - Adds nanoseconds to a timespec
 * @a:		pointer to timespec to be incremented
 * @ns:		unsigned nanoseconds value to be added
231 232 233
 *
 * This must always be inlined because its used from the x86-64 vdso,
 * which cannot call other kernel functions.
234
 */
235
static __always_inline void timespec_add_ns(struct timespec *a, u64 ns)
236
{
237
	a->tv_sec += __iter_div_u64_rem(a->tv_nsec + ns, NSEC_PER_SEC, &ns);
238 239
	a->tv_nsec = ns;
}
L
Linus Torvalds 已提交
240 241 242 243 244 245 246 247 248 249 250 251
#endif /* __KERNEL__ */

#define NFDBITS			__NFDBITS

#define FD_SETSIZE		__FD_SETSIZE
#define FD_SET(fd,fdsetp)	__FD_SET(fd,fdsetp)
#define FD_CLR(fd,fdsetp)	__FD_CLR(fd,fdsetp)
#define FD_ISSET(fd,fdsetp)	__FD_ISSET(fd,fdsetp)
#define FD_ZERO(fdsetp)		__FD_ZERO(fdsetp)

/*
 * Names of the interval timers, and structure
252
 * defining a timer setting:
L
Linus Torvalds 已提交
253
 */
254 255 256
#define	ITIMER_REAL		0
#define	ITIMER_VIRTUAL		1
#define	ITIMER_PROF		2
L
Linus Torvalds 已提交
257

258 259 260
struct itimerspec {
	struct timespec it_interval;	/* timer period */
	struct timespec it_value;	/* timer expiration */
L
Linus Torvalds 已提交
261 262
};

263 264 265
struct itimerval {
	struct timeval it_interval;	/* timer interval */
	struct timeval it_value;	/* current value */
L
Linus Torvalds 已提交
266 267 268
};

/*
269
 * The IDs of the various system clocks (for POSIX.1b interval timers):
L
Linus Torvalds 已提交
270
 */
271 272 273 274
#define CLOCK_REALTIME			0
#define CLOCK_MONOTONIC			1
#define CLOCK_PROCESS_CPUTIME_ID	2
#define CLOCK_THREAD_CPUTIME_ID		3
275
#define CLOCK_MONOTONIC_RAW		4
276 277
#define CLOCK_REALTIME_COARSE		5
#define CLOCK_MONOTONIC_COARSE		6
L
Linus Torvalds 已提交
278 279

/*
280
 * The IDs of various hardware clocks:
L
Linus Torvalds 已提交
281
 */
282 283 284 285
#define CLOCK_SGI_CYCLE			10
#define MAX_CLOCKS			16
#define CLOCKS_MASK			(CLOCK_REALTIME | CLOCK_MONOTONIC)
#define CLOCKS_MONO			CLOCK_MONOTONIC
L
Linus Torvalds 已提交
286 287

/*
288
 * The various flags for setting POSIX.1b interval timers:
L
Linus Torvalds 已提交
289
 */
290
#define TIMER_ABSTIME			0x01
L
Linus Torvalds 已提交
291 292

#endif