regulator: email - update email address and regulator webpage.
[linux-2.6-block.git] / include / linux / time.h
CommitLineData
1da177e4
LT
1#ifndef _LINUX_TIME_H
2#define _LINUX_TIME_H
3
4#include <linux/types.h>
5
6#ifdef __KERNEL__
82644459 7# include <linux/cache.h>
57a55875 8# include <linux/seqlock.h>
f595ec96 9# include <linux/math64.h>
1da177e4
LT
10#endif
11
12#ifndef _STRUCT_TIMESPEC
13#define _STRUCT_TIMESPEC
14struct timespec {
85efde6f
AB
15 __kernel_time_t tv_sec; /* seconds */
16 long tv_nsec; /* nanoseconds */
1da177e4 17};
57a55875 18#endif
1da177e4
LT
19
20struct timeval {
85efde6f
AB
21 __kernel_time_t tv_sec; /* seconds */
22 __kernel_suseconds_t tv_usec; /* microseconds */
1da177e4
LT
23};
24
25struct timezone {
26 int tz_minuteswest; /* minutes west of Greenwich */
27 int tz_dsttime; /* type of dst correction */
28};
29
30#ifdef __KERNEL__
31
b418da16
CH
32extern struct timezone sys_tz;
33
57a55875 34/* Parameters used to convert the timespec values: */
05ebb761
VP
35#define MSEC_PER_SEC 1000L
36#define USEC_PER_MSEC 1000L
37#define NSEC_PER_USEC 1000L
38#define NSEC_PER_MSEC 1000000L
39#define USEC_PER_SEC 1000000L
40#define NSEC_PER_SEC 1000000000L
41#define FSEC_PER_SEC 1000000000000000L
1da177e4 42
df0cc053
TG
43#define TIME_T_MAX (time_t)((1UL << ((sizeof(time_t) << 3) - 1)) - 1)
44
5b78cc9a
JE
45static inline int timespec_equal(const struct timespec *a,
46 const struct timespec *b)
57a55875 47{
1da177e4 48 return (a->tv_sec == b->tv_sec) && (a->tv_nsec == b->tv_nsec);
57a55875 49}
1da177e4 50
643a6545
AM
51/*
52 * lhs < rhs: return <0
53 * lhs == rhs: return 0
54 * lhs > rhs: return >0
55 */
77adbfbf 56static inline int timespec_compare(const struct timespec *lhs, const struct timespec *rhs)
643a6545
AM
57{
58 if (lhs->tv_sec < rhs->tv_sec)
59 return -1;
60 if (lhs->tv_sec > rhs->tv_sec)
61 return 1;
62 return lhs->tv_nsec - rhs->tv_nsec;
63}
64
77adbfbf 65static inline int timeval_compare(const struct timeval *lhs, const struct timeval *rhs)
643a6545
AM
66{
67 if (lhs->tv_sec < rhs->tv_sec)
68 return -1;
69 if (lhs->tv_sec > rhs->tv_sec)
70 return 1;
71 return lhs->tv_usec - rhs->tv_usec;
72}
73
f4818900
IM
74extern unsigned long mktime(const unsigned int year, const unsigned int mon,
75 const unsigned int day, const unsigned int hour,
76 const unsigned int min, const unsigned int sec);
77
78extern void set_normalized_timespec(struct timespec *ts, time_t sec, long nsec);
df0cc053
TG
79extern struct timespec timespec_add_safe(const struct timespec lhs,
80 const struct timespec rhs);
1da177e4 81
ca74e92b
SN
82/*
83 * sub = lhs - rhs, in normalized form
84 */
85static inline struct timespec timespec_sub(struct timespec lhs,
86 struct timespec rhs)
87{
88 struct timespec ts_delta;
89 set_normalized_timespec(&ts_delta, lhs.tv_sec - rhs.tv_sec,
90 lhs.tv_nsec - rhs.tv_nsec);
91 return ts_delta;
92}
93
5f82b2b7
TG
94/*
95 * Returns true if the timespec is norm, false if denorm:
96 */
97#define timespec_valid(ts) \
bd3f8f2b 98 (((ts)->tv_sec >= 0) && (((unsigned long) (ts)->tv_nsec) < NSEC_PER_SEC))
5f82b2b7 99
1da177e4
LT
100extern struct timespec xtime;
101extern struct timespec wall_to_monotonic;
ba2a631b 102extern seqlock_t xtime_lock;
1da177e4 103
411187fb 104extern unsigned long read_persistent_clock(void);
82644459
TG
105extern int update_persistent_clock(struct timespec now);
106extern int no_sync_cmos_clock __read_mostly;
ad596171 107void timekeeping_init(void);
1c5745aa 108extern int timekeeping_suspended;
ad596171 109
17c38b74 110unsigned long get_seconds(void);
1da177e4
LT
111struct timespec current_kernel_time(void);
112
57a55875 113#define CURRENT_TIME (current_kernel_time())
2c6b47de 114#define CURRENT_TIME_SEC ((struct timespec) { get_seconds(), 0 })
1da177e4
LT
115
116extern void do_gettimeofday(struct timeval *tv);
117extern int do_settimeofday(struct timespec *tv);
118extern int do_sys_settimeofday(struct timespec *tv, struct timezone *tz);
becf8b5d 119#define do_posix_clock_monotonic_gettime(ts) ktime_get_ts(ts)
1c710c89 120extern long do_utimes(int dfd, char __user *filename, struct timespec *times, int flags);
1da177e4 121struct itimerval;
57a55875
IM
122extern int do_setitimer(int which, struct itimerval *value,
123 struct itimerval *ovalue);
c08b8a49 124extern unsigned int alarm_setitimer(unsigned int seconds);
1da177e4 125extern int do_getitimer(int which, struct itimerval *value);
57a55875 126extern void getnstimeofday(struct timespec *tv);
2d42244a 127extern void getrawmonotonic(struct timespec *ts);
7c3f1a57
TJ
128extern void getboottime(struct timespec *ts);
129extern void monotonic_to_bootbased(struct timespec *ts);
1da177e4
LT
130
131extern struct timespec timespec_trunc(struct timespec t, unsigned gran);
cf4fc6cb 132extern int timekeeping_valid_for_hres(void);
8524070b 133extern void update_wall_time(void);
1001d0a9 134extern void update_xtime_cache(u64 nsec);
1da177e4 135
f06febc9
FM
136struct tms;
137extern void do_sys_times(struct tms *);
138
f8f46da3
TG
139/**
140 * timespec_to_ns - Convert timespec to nanoseconds
141 * @ts: pointer to the timespec variable to be converted
142 *
143 * Returns the scalar nanosecond representation of the timespec
144 * parameter.
145 */
df869b63 146static inline s64 timespec_to_ns(const struct timespec *ts)
f8f46da3 147{
df869b63 148 return ((s64) ts->tv_sec * NSEC_PER_SEC) + ts->tv_nsec;
f8f46da3
TG
149}
150
151/**
152 * timeval_to_ns - Convert timeval to nanoseconds
153 * @ts: pointer to the timeval variable to be converted
154 *
155 * Returns the scalar nanosecond representation of the timeval
156 * parameter.
157 */
df869b63 158static inline s64 timeval_to_ns(const struct timeval *tv)
f8f46da3 159{
df869b63 160 return ((s64) tv->tv_sec * NSEC_PER_SEC) +
f8f46da3
TG
161 tv->tv_usec * NSEC_PER_USEC;
162}
163
164/**
165 * ns_to_timespec - Convert nanoseconds to timespec
166 * @nsec: the nanoseconds value to be converted
167 *
168 * Returns the timespec representation of the nsec parameter.
169 */
df869b63 170extern struct timespec ns_to_timespec(const s64 nsec);
f8f46da3
TG
171
172/**
173 * ns_to_timeval - Convert nanoseconds to timeval
174 * @nsec: the nanoseconds value to be converted
175 *
176 * Returns the timeval representation of the nsec parameter.
177 */
df869b63 178extern struct timeval ns_to_timeval(const s64 nsec);
f8f46da3 179
cf3c769b 180/**
181 * timespec_add_ns - Adds nanoseconds to a timespec
182 * @a: pointer to timespec to be incremented
183 * @ns: unsigned nanoseconds value to be added
9412e286
JF
184 *
185 * This must always be inlined because its used from the x86-64 vdso,
186 * which cannot call other kernel functions.
cf3c769b 187 */
9412e286 188static __always_inline void timespec_add_ns(struct timespec *a, u64 ns)
cf3c769b 189{
9412e286 190 a->tv_sec += __iter_div_u64_rem(a->tv_nsec + ns, NSEC_PER_SEC, &ns);
cf3c769b 191 a->tv_nsec = ns;
192}
1da177e4
LT
193#endif /* __KERNEL__ */
194
195#define NFDBITS __NFDBITS
196
197#define FD_SETSIZE __FD_SETSIZE
198#define FD_SET(fd,fdsetp) __FD_SET(fd,fdsetp)
199#define FD_CLR(fd,fdsetp) __FD_CLR(fd,fdsetp)
200#define FD_ISSET(fd,fdsetp) __FD_ISSET(fd,fdsetp)
201#define FD_ZERO(fdsetp) __FD_ZERO(fdsetp)
202
203/*
204 * Names of the interval timers, and structure
57a55875 205 * defining a timer setting:
1da177e4 206 */
57a55875
IM
207#define ITIMER_REAL 0
208#define ITIMER_VIRTUAL 1
209#define ITIMER_PROF 2
1da177e4 210
57a55875
IM
211struct itimerspec {
212 struct timespec it_interval; /* timer period */
213 struct timespec it_value; /* timer expiration */
1da177e4
LT
214};
215
57a55875
IM
216struct itimerval {
217 struct timeval it_interval; /* timer interval */
218 struct timeval it_value; /* current value */
1da177e4
LT
219};
220
1da177e4 221/*
57a55875 222 * The IDs of the various system clocks (for POSIX.1b interval timers):
1da177e4 223 */
1ad106ca
IM
224#define CLOCK_REALTIME 0
225#define CLOCK_MONOTONIC 1
226#define CLOCK_PROCESS_CPUTIME_ID 2
227#define CLOCK_THREAD_CPUTIME_ID 3
2d42244a 228#define CLOCK_MONOTONIC_RAW 4
1da177e4
LT
229
230/*
57a55875 231 * The IDs of various hardware clocks:
1da177e4 232 */
1ad106ca
IM
233#define CLOCK_SGI_CYCLE 10
234#define MAX_CLOCKS 16
235#define CLOCKS_MASK (CLOCK_REALTIME | CLOCK_MONOTONIC)
236#define CLOCKS_MONO CLOCK_MONOTONIC
1da177e4
LT
237
238/*
57a55875 239 * The various flags for setting POSIX.1b interval timers:
1da177e4 240 */
1ad106ca 241#define TIMER_ABSTIME 0x01
1da177e4
LT
242
243#endif