1/*
2 * Copyright (c) 2000-2006 Apple Computer, 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/* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
29/*
30 * Copyright (c) 1982, 1986, 1993
31 *	The Regents of the University of California.  All rights reserved.
32 *
33 * Redistribution and use in source and binary forms, with or without
34 * modification, are permitted provided that the following conditions
35 * are met:
36 * 1. Redistributions of source code must retain the above copyright
37 *    notice, this list of conditions and the following disclaimer.
38 * 2. Redistributions in binary form must reproduce the above copyright
39 *    notice, this list of conditions and the following disclaimer in the
40 *    documentation and/or other materials provided with the distribution.
41 * 3. All advertising materials mentioning features or use of this software
42 *    must display the following acknowledgement:
43 *	This product includes software developed by the University of
44 *	California, Berkeley and its contributors.
45 * 4. Neither the name of the University nor the names of its contributors
46 *    may be used to endorse or promote products derived from this software
47 *    without specific prior written permission.
48 *
49 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
50 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
51 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
52 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
53 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
54 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
55 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
56 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
57 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
58 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
59 * SUCH DAMAGE.
60 *
61 *	@(#)time.h	8.2 (Berkeley) 7/10/94
62 */
63
64#ifndef _SYS_TIME_H_
65#define _SYS_TIME_H_
66
67#include <sys/cdefs.h>
68#include <sys/_types.h>
69#ifdef KERNEL
70#include <machine/types.h>	/* user_time_t */
71#else /* !KERNEL */
72#include <Availability.h>
73#endif /* KERNEL */
74
75/*
76 * [XSI] The fd_set type shall be defined as described in <sys/select.h>.
77 * The timespec structure shall be defined as described in <time.h>
78 */
79#define __need_fd_set
80#define __need_struct_timespec
81#define __need_struct_timeval
82#ifdef KERNEL
83#define __need_struct_user_timespec
84#define __need_struct_user32_timespec
85#define __need_struct_user64_timespec
86#define __need_struct_user_timeval
87#define __need_struct_user32_timeval
88#define __need_struct_user64_timeval
89#define __need_struct_user32_itimerval
90#define __need_struct_user64_itimerval
91#endif /* KERNEL */
92#include <sys/_structs.h>
93
94#ifndef	_TIME_T
95#define	_TIME_T
96typedef	__darwin_time_t	time_t;
97#endif
98
99#ifndef _SUSECONDS_T
100#define _SUSECONDS_T
101typedef __darwin_suseconds_t	suseconds_t;
102#endif
103
104/*
105 * Structure used as a parameter by getitimer(2) and setitimer(2) system
106 * calls.
107 */
108struct	itimerval {
109	struct	timeval it_interval;	/* timer interval */
110	struct	timeval it_value;	/* current value */
111};
112
113/*
114 * Names of the interval timers, and structure
115 * defining a timer setting.
116 */
117#define	ITIMER_REAL	0
118#define	ITIMER_VIRTUAL	1
119#define	ITIMER_PROF	2
120
121/*
122 * Select uses bit masks of file descriptors in longs.  These macros
123 * manipulate such bit fields (the filesystem macros use chars).  The
124 * extra protection here is to permit application redefinition above
125 * the default size.
126 */
127#ifndef	FD_SETSIZE
128#define	FD_SETSIZE	__DARWIN_FD_SETSIZE
129#endif	/* FD_SETSIZE */
130#ifndef FD_SET
131#define	FD_SET(n, p)	__DARWIN_FD_SET(n, p)
132#endif	/* FD_SET */
133#ifndef	FD_CLR
134#define	FD_CLR(n,p)	__DARWIN_FD_CLR(n, p)
135#endif	/* FD_CLR */
136#ifndef FD_ISSET
137#define	FD_ISSET(n, p)	__DARWIN_FD_ISSET(n, p)
138#endif	/* FD_ISSET */
139#ifndef FD_ZERO
140#define	FD_ZERO(p)	__DARWIN_FD_ZERO(p)
141#endif	/* FD_ZERO */
142
143#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
144
145#ifndef FD_COPY
146#define	FD_COPY(f, t)	__DARWIN_FD_COPY(f, t)
147#endif	/* FD_COPY */
148
149#define	TIMEVAL_TO_TIMESPEC(tv, ts) {					\
150	(ts)->tv_sec = (tv)->tv_sec;					\
151	(ts)->tv_nsec = (tv)->tv_usec * 1000;				\
152}
153#define	TIMESPEC_TO_TIMEVAL(tv, ts) {					\
154	(tv)->tv_sec = (ts)->tv_sec;					\
155	(tv)->tv_usec = (ts)->tv_nsec / 1000;				\
156}
157
158struct timezone {
159	int	tz_minuteswest;	/* minutes west of Greenwich */
160	int	tz_dsttime;	/* type of dst correction */
161};
162#define	DST_NONE	0	/* not on dst */
163#define	DST_USA		1	/* USA style dst */
164#define	DST_AUST	2	/* Australian style dst */
165#define	DST_WET		3	/* Western European dst */
166#define	DST_MET		4	/* Middle European dst */
167#define	DST_EET		5	/* Eastern European dst */
168#define	DST_CAN		6	/* Canada */
169
170/* Operations on timevals. */
171#define	timerclear(tvp)		(tvp)->tv_sec = (tvp)->tv_usec = 0
172#define	timerisset(tvp)		((tvp)->tv_sec || (tvp)->tv_usec)
173#define	timercmp(tvp, uvp, cmp)						\
174	(((tvp)->tv_sec == (uvp)->tv_sec) ?				\
175	    ((tvp)->tv_usec cmp (uvp)->tv_usec) :			\
176	    ((tvp)->tv_sec cmp (uvp)->tv_sec))
177#define	timeradd(tvp, uvp, vvp)						\
178	do {								\
179		(vvp)->tv_sec = (tvp)->tv_sec + (uvp)->tv_sec;		\
180		(vvp)->tv_usec = (tvp)->tv_usec + (uvp)->tv_usec;	\
181		if ((vvp)->tv_usec >= 1000000) {			\
182			(vvp)->tv_sec++;				\
183			(vvp)->tv_usec -= 1000000;			\
184		}							\
185	} while (0)
186#define	timersub(tvp, uvp, vvp)						\
187	do {								\
188		(vvp)->tv_sec = (tvp)->tv_sec - (uvp)->tv_sec;		\
189		(vvp)->tv_usec = (tvp)->tv_usec - (uvp)->tv_usec;	\
190		if ((vvp)->tv_usec < 0) {				\
191			(vvp)->tv_sec--;				\
192			(vvp)->tv_usec += 1000000;			\
193		}							\
194	} while (0)
195
196#define timevalcmp(l, r, cmp)   timercmp(l, r, cmp) /* freebsd */
197
198/*
199 * Getkerninfo clock information structure
200 */
201struct clockinfo {
202	int	hz;		/* clock frequency */
203	int	tick;		/* micro-seconds per hz tick */
204	int	tickadj;	/* clock skew rate for adjtime() */
205	int	stathz;		/* statistics clock frequency */
206	int	profhz;		/* profiling clock frequency */
207};
208#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
209
210#ifdef KERNEL
211
212#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
213__BEGIN_DECLS
214void	microtime(struct timeval *tv);
215void	microuptime(struct timeval *tv);
216#define getmicrotime(a)		microtime(a)
217#define getmicrouptime(a)	microuptime(a)
218void	nanotime(struct timespec *ts);
219void	nanouptime(struct timespec *ts);
220#define getnanotime(a)		nanotime(a)
221#define getnanouptime(a)	nanouptime(a)
222void	timevaladd(struct timeval *t1, struct timeval *t2);
223void	timevalsub(struct timeval *t1, struct timeval *t2);
224void	timevalfix(struct timeval *t1);
225#ifdef	BSD_KERNEL_PRIVATE
226time_t	boottime_sec(void);
227void	inittodr(time_t base) __attribute__((section("__TEXT, initcode")));
228#endif /* BSD_KERNEL_PRIVATE */
229
230__END_DECLS
231
232#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
233
234#else /* !KERNEL */
235
236#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
237#include <time.h>
238#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
239
240__BEGIN_DECLS
241
242#if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
243int	adjtime(const struct timeval *, struct timeval *);
244int	futimes(int, const struct timeval *);
245int	lutimes(const char *, const struct timeval *) __OSX_AVAILABLE_STARTING(__MAC_10_5, __IPHONE_2_0);
246int	settimeofday(const struct timeval *, const struct timezone *);
247#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
248
249int	getitimer(int, struct itimerval *);
250int	gettimeofday(struct timeval * __restrict, void * __restrict);
251
252#include <sys/_select.h>	/* select() prototype */
253
254int	setitimer(int, const struct itimerval * __restrict,
255		struct itimerval * __restrict);
256int	utimes(const char *, const struct timeval *);
257
258__END_DECLS
259
260#endif /* !KERNEL */
261
262#endif /* !_SYS_TIME_H_ */
263