1 | /* |
2 | * Copyright (c) 2000-2008 Apple Inc. All rights reserved. |
3 | * |
4 | * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ |
5 | * |
6 | * This file contains Original Code and/or Modifications of Original Code |
7 | * as defined in and that are subject to the Apple Public Source License |
8 | * Version 2.0 (the 'License'). You may not use this file except in |
9 | * compliance with the License. The rights granted to you under the License |
10 | * may not be used to create, or enable the creation or redistribution of, |
11 | * unlawful or unlicensed copies of an Apple operating system, or to |
12 | * circumvent, violate, or enable the circumvention or violation of, any |
13 | * terms of an Apple operating system software license agreement. |
14 | * |
15 | * Please obtain a copy of the License at |
16 | * http://www.opensource.apple.com/apsl/ and read it before using this file. |
17 | * |
18 | * The Original Code and all software distributed under the License are |
19 | * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER |
20 | * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, |
21 | * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, |
22 | * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. |
23 | * Please see the License for the specific language governing rights and |
24 | * limitations under the License. |
25 | * |
26 | * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ |
27 | */ |
28 | /* |
29 | * @OSF_COPYRIGHT@ |
30 | */ |
31 | /* |
32 | */ |
33 | |
34 | #ifndef _KERN_CLOCK_H_ |
35 | #define _KERN_CLOCK_H_ |
36 | |
37 | #include <stdint.h> |
38 | #include <mach/mach_types.h> |
39 | #include <mach/clock_types.h> |
40 | #include <mach/message.h> |
41 | #include <mach/mach_time.h> |
42 | #include <mach/boolean.h> |
43 | |
44 | #include <kern/kern_types.h> |
45 | |
46 | #include <sys/cdefs.h> |
47 | |
48 | |
49 | #ifdef __LP64__ |
50 | |
51 | typedef unsigned long clock_sec_t; |
52 | typedef unsigned int clock_usec_t, clock_nsec_t; |
53 | |
54 | #else /* __LP64__ */ |
55 | |
56 | typedef uint32_t clock_sec_t; |
57 | typedef uint32_t clock_usec_t, clock_nsec_t; |
58 | |
59 | #endif /* __LP64__ */ |
60 | |
61 | #ifdef MACH_KERNEL_PRIVATE |
62 | |
63 | #include <kern/queue.h> |
64 | |
65 | /* |
66 | * Clock operations list structure. Contains vectors to machine |
67 | * dependent clock routines. |
68 | */ |
69 | struct clock_ops { |
70 | int (*c_config)(void); /* configuration */ |
71 | |
72 | int (*c_init)(void); /* initialize */ |
73 | |
74 | kern_return_t (*c_gettime)( /* get time */ |
75 | mach_timespec_t *cur_time); |
76 | |
77 | kern_return_t (*c_getattr)( /* get attributes */ |
78 | clock_flavor_t flavor, |
79 | clock_attr_t attr, |
80 | mach_msg_type_number_t *count); |
81 | }; |
82 | typedef const struct clock_ops *clock_ops_t; |
83 | typedef struct clock_ops clock_ops_data_t; |
84 | |
85 | /* |
86 | * Actual clock object data structure. Contains the machine |
87 | * dependent operations list and clock operation ports. |
88 | */ |
89 | struct clock { |
90 | clock_ops_t cl_ops; /* operations list */ |
91 | struct ipc_port *cl_service; /* service port */ |
92 | struct ipc_port *cl_control; /* control port */ |
93 | }; |
94 | typedef struct clock clock_data_t; |
95 | |
96 | /* |
97 | * Configure the clock system. |
98 | */ |
99 | extern void clock_config(void); |
100 | extern void clock_oldconfig(void); |
101 | |
102 | /* |
103 | * Initialize the clock system. |
104 | */ |
105 | extern void clock_init(void); |
106 | extern void clock_oldinit(void); |
107 | |
108 | extern void clock_timebase_init(void); |
109 | |
110 | /* |
111 | * Initialize the clock ipc service facility. |
112 | */ |
113 | extern void clock_service_create(void); |
114 | |
115 | extern void clock_gettimeofday_set_commpage( |
116 | uint64_t abstime, |
117 | uint64_t sec, |
118 | uint64_t frac, |
119 | uint64_t scale, |
120 | uint64_t tick_per_sec); |
121 | |
122 | extern void machine_delay_until(uint64_t interval, |
123 | uint64_t deadline); |
124 | |
125 | extern uint32_t hz_tick_interval; |
126 | |
127 | extern void nanotime_to_absolutetime( |
128 | clock_sec_t secs, |
129 | clock_nsec_t nanosecs, |
130 | uint64_t *result); |
131 | |
132 | #endif /* MACH_KERNEL_PRIVATE */ |
133 | |
134 | __BEGIN_DECLS |
135 | |
136 | #ifdef XNU_KERNEL_PRIVATE |
137 | |
138 | extern void clock_adjtime( |
139 | long *secs, |
140 | int *microsecs); |
141 | |
142 | extern void clock_initialize_calendar(void); |
143 | |
144 | extern void clock_wakeup_calendar(void); |
145 | |
146 | extern void clock_update_calendar(void); |
147 | |
148 | extern void clock_get_calendar_uptime(clock_sec_t *secs); |
149 | |
150 | extern void clock_gettimeofday_new(clock_sec_t *secs, |
151 | clock_usec_t *microsecs); |
152 | extern void clock_gettimeofday( |
153 | clock_sec_t *secs, |
154 | clock_usec_t *microsecs); |
155 | |
156 | extern void clock_gettimeofday_and_absolute_time( |
157 | clock_sec_t *secs, |
158 | clock_usec_t *microsecs, |
159 | uint64_t *absolute_time); |
160 | |
161 | |
162 | extern void clock_set_calendar_microtime( |
163 | clock_sec_t secs, |
164 | clock_usec_t microsecs); |
165 | |
166 | extern void clock_get_boottime_nanotime( |
167 | clock_sec_t *secs, |
168 | clock_nsec_t *nanosecs); |
169 | |
170 | extern void clock_get_boottime_microtime( |
171 | clock_sec_t *secs, |
172 | clock_nsec_t *microsecs); |
173 | |
174 | extern void absolutetime_to_microtime( |
175 | uint64_t abstime, |
176 | clock_sec_t *secs, |
177 | clock_usec_t *microsecs); |
178 | |
179 | extern void clock_deadline_for_periodic_event( |
180 | uint64_t interval, |
181 | uint64_t abstime, |
182 | uint64_t *deadline); |
183 | |
184 | #if CONFIG_DTRACE |
185 | |
186 | extern void clock_get_calendar_nanotime_nowait( |
187 | clock_sec_t *secs, |
188 | clock_nsec_t *nanosecs); |
189 | |
190 | #endif /* CONFIG_DTRACE */ |
191 | |
192 | boolean_t kdp_clock_is_locked(void); |
193 | |
194 | #endif /* XNU_KERNEL_PRIVATE */ |
195 | |
196 | extern void clock_get_calendar_microtime( |
197 | clock_sec_t *secs, |
198 | clock_usec_t *microsecs); |
199 | |
200 | extern void clock_get_calendar_absolute_and_microtime( |
201 | clock_sec_t *secs, |
202 | clock_usec_t *microsecs, |
203 | uint64_t *abstime); |
204 | |
205 | extern void clock_get_calendar_nanotime( |
206 | clock_sec_t *secs, |
207 | clock_nsec_t *nanosecs); |
208 | |
209 | extern void clock_get_system_microtime( |
210 | clock_sec_t *secs, |
211 | clock_usec_t *microsecs); |
212 | |
213 | extern void clock_get_system_nanotime( |
214 | clock_sec_t *secs, |
215 | clock_nsec_t *nanosecs); |
216 | |
217 | extern void clock_timebase_info( |
218 | mach_timebase_info_t info); |
219 | |
220 | extern void clock_get_uptime( |
221 | uint64_t *result); |
222 | |
223 | extern void clock_interval_to_deadline( |
224 | uint32_t interval, |
225 | uint32_t scale_factor, |
226 | uint64_t *result); |
227 | |
228 | extern void clock_interval_to_absolutetime_interval( |
229 | uint32_t interval, |
230 | uint32_t scale_factor, |
231 | uint64_t *result); |
232 | |
233 | extern void clock_absolutetime_interval_to_deadline( |
234 | uint64_t abstime, |
235 | uint64_t *result); |
236 | |
237 | extern void clock_continuoustime_interval_to_deadline( |
238 | uint64_t abstime, |
239 | uint64_t *result); |
240 | |
241 | extern void clock_delay_until( |
242 | uint64_t deadline); |
243 | |
244 | extern void absolutetime_to_nanoseconds( |
245 | uint64_t abstime, |
246 | uint64_t *result); |
247 | |
248 | extern void nanoseconds_to_absolutetime( |
249 | uint64_t nanoseconds, |
250 | uint64_t *result); |
251 | |
252 | /* |
253 | * Absolute <-> Continuous Time conversion routines |
254 | * |
255 | * It is the caller's responsibility to ensure that these functions are |
256 | * synchronized with respect to updates to the continuous timebase. The |
257 | * returned value is only valid until the next update to the continuous |
258 | * timebase. |
259 | * |
260 | * If the value to be returned by continuoustime_to_absolutetime would be |
261 | * negative, zero is returned. This occurs when the provided continuous time |
262 | * is less the amount of the time the system spent asleep and /must/ be |
263 | * handled. |
264 | */ |
265 | extern uint64_t absolutetime_to_continuoustime( |
266 | uint64_t abstime); |
267 | extern uint64_t continuoustime_to_absolutetime( |
268 | uint64_t conttime); |
269 | |
270 | extern uint64_t mach_absolutetime_asleep; |
271 | extern uint64_t mach_absolutetime_last_sleep; |
272 | |
273 | #ifdef KERNEL_PRIVATE |
274 | |
275 | /* |
276 | * Obsolete interfaces. |
277 | */ |
278 | |
279 | #ifndef __LP64__ |
280 | |
281 | #define MACH_TIMESPEC_SEC_MAX (0 - 1) |
282 | #define MACH_TIMESPEC_NSEC_MAX (NSEC_PER_SEC - 1) |
283 | |
284 | #define MACH_TIMESPEC_MAX ((mach_timespec_t) { \ |
285 | MACH_TIMESPEC_SEC_MAX, \ |
286 | MACH_TIMESPEC_NSEC_MAX } ) |
287 | #define MACH_TIMESPEC_ZERO ((mach_timespec_t) { 0, 0 } ) |
288 | |
289 | #define ADD_MACH_TIMESPEC_NSEC(t1, nsec) \ |
290 | do { \ |
291 | (t1)->tv_nsec += (clock_res_t)(nsec); \ |
292 | if ((clock_res_t)(nsec) > 0 && \ |
293 | (t1)->tv_nsec >= NSEC_PER_SEC) { \ |
294 | (t1)->tv_nsec -= NSEC_PER_SEC; \ |
295 | (t1)->tv_sec += 1; \ |
296 | } \ |
297 | else if ((clock_res_t)(nsec) < 0 && \ |
298 | (t1)->tv_nsec < 0) { \ |
299 | (t1)->tv_nsec += NSEC_PER_SEC; \ |
300 | (t1)->tv_sec -= 1; \ |
301 | } \ |
302 | } while (0) |
303 | |
304 | #include <Availability.h> |
305 | |
306 | /* Use mach_absolute_time() */ |
307 | extern mach_timespec_t clock_get_system_value(void) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_2_0, __IPHONE_6_0); |
308 | |
309 | extern mach_timespec_t clock_get_calendar_value(void) __OSX_AVAILABLE_BUT_DEPRECATED(__MAC_10_0, __MAC_10_8, __IPHONE_2_0, __IPHONE_6_0); |
310 | |
311 | #else /* __LP64__ */ |
312 | |
313 | #ifdef XNU_KERNEL_PRIVATE |
314 | |
315 | #define MACH_TIMESPEC_ZERO ((mach_timespec_t) { 0, 0 } ) |
316 | |
317 | #endif /* XNU_KERNEL_PRIVATE */ |
318 | |
319 | #endif /* __LP64__ */ |
320 | |
321 | extern void delay_for_interval( |
322 | uint32_t interval, |
323 | uint32_t scale_factor); |
324 | |
325 | extern void delay_for_interval_with_leeway( |
326 | uint32_t interval, |
327 | uint32_t leeway, |
328 | uint32_t scale_factor); |
329 | |
330 | #ifdef XNU_KERNEL_PRIVATE |
331 | extern void delay(int usec); |
332 | #endif /* XNU_KERNEL_PRIVATE */ |
333 | |
334 | #endif /* KERNEL_PRIVATE */ |
335 | |
336 | __END_DECLS |
337 | |
338 | #endif /* _KERN_CLOCK_H_ */ |
339 | |