[apple/xnu.git] / osfmk / mach / clock_types.h

/*
 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
 *
 * @APPLE_LICENSE_HEADER_START@
 * 
 * The contents of this file constitute Original Code as defined in and
 * are subject to the Apple Public Source License Version 1.1 (the
 * "License").  You may not use this file except in compliance with the
 * License.  Please obtain a copy of the License at
 * http://www.apple.com/publicsource and read it before using this file.
 * 
 * This Original Code and all software distributed under the License are
 * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
 * License for the specific language governing rights and limitations
 * under the License.
 * 
 * @APPLE_LICENSE_HEADER_END@
 */
/*
 * @OSF_COPYRIGHT@
 */
/*
 *	File:		clock_types.h
 *	Purpose:	Clock facility header definitions. These
 *				definitons are needed by both kernel and
 *				user-level software.
 */

/*
 * N.B. This interface has been deprecated and the contents
 * of this file should be considered obsolete.
 */

#ifndef	_MACH_CLOCK_TYPES_H_
#define	_MACH_CLOCK_TYPES_H_

#include <mach/time_value.h>

/*
 * Reserved clock id values for default clocks.
 */
#define SYSTEM_CLOCK		0	/* advances monotonically and
								 * uniformly; set to zero at boot */
#define CALENDAR_CLOCK		1	/* 'wall' clock; effectively
								 * synchronized to UTC */

#define REALTIME_CLOCK		0	/* obsolete; use SYSTEM or CALENDAR
								 * clock depending on particular
								 * requirements */

/*
 * Type definitions.
 */
typedef	int	alarm_type_t;		/* alarm time type */
typedef int	sleep_type_t;		/* sleep time type */
typedef	int	clock_id_t;			/* clock identification type */
typedef int	clock_flavor_t;		/* clock flavor type */
typedef int	*clock_attr_t;		/* clock attribute type */
typedef int	clock_res_t;		/* clock resolution type */

/*
 * Attribute names.
 */
#define	CLOCK_GET_TIME_RES	1	/* get_time call resolution */
/*							2	 * was map_time call resolution */
#define CLOCK_ALARM_CURRES	3	/* current alarm resolution */
#define CLOCK_ALARM_MINRES	4	/* minimum alarm resolution */
#define CLOCK_ALARM_MAXRES	5	/* maximum alarm resolution */

/*
 * Normal time specification used by the kernel clock facility.
 */
struct mach_timespec {
	unsigned int	tv_sec;			/* seconds */
	clock_res_t		tv_nsec;		/* nanoseconds */
};
typedef struct mach_timespec	mach_timespec_t;

#define NSEC_PER_USEC	1000		/* nanoseconds per microsecond */
#define USEC_PER_SEC	1000000		/* microseconds per second */
#define NSEC_PER_SEC	1000000000	/* nanoseconds per second */

#define BAD_MACH_TIMESPEC(t)						\
	((t)->tv_nsec < 0 || (t)->tv_nsec >= NSEC_PER_SEC)

/* t1 <=> t2, also (t1 - t2) in nsec with max of +- 1 sec */
#define CMP_MACH_TIMESPEC(t1, t2)					\
	((t1)->tv_sec > (t2)->tv_sec ? +NSEC_PER_SEC :	\
	((t1)->tv_sec < (t2)->tv_sec ? -NSEC_PER_SEC :	\
			(t1)->tv_nsec - (t2)->tv_nsec))

/* t1  += t2 */
#define ADD_MACH_TIMESPEC(t1, t2)								\
  do {															\
	if (((t1)->tv_nsec += (t2)->tv_nsec) >= NSEC_PER_SEC) {		\
		(t1)->tv_nsec -= NSEC_PER_SEC;							\
		(t1)->tv_sec  += 1;										\
	}															\
	(t1)->tv_sec += (t2)->tv_sec;								\
  } while (0)

/* t1  -= t2 */
#define SUB_MACH_TIMESPEC(t1, t2)								\
  do {															\
	if (((t1)->tv_nsec -= (t2)->tv_nsec) < 0) {					\
		(t1)->tv_nsec += NSEC_PER_SEC;							\
		(t1)->tv_sec  -= 1;										\
	}															\
	(t1)->tv_sec -= (t2)->tv_sec;								\
  } while (0)

/*
 * Alarm parameter defines.
 */
#define ALRMTYPE			0xff		/* type (8-bit field)	*/
#define TIME_ABSOLUTE		0x00		/* absolute time */
#define	TIME_RELATIVE		0x01		/* relative time */

#define BAD_ALRMTYPE(t)		(((t) &~ TIME_RELATIVE) != 0)

#endif /* _MACH_CLOCK_TYPES_H_ */
Commit	Line	Data
1c79356b A	1	/*
	2	* Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
	3	*
	4	* @APPLE_LICENSE_HEADER_START@
	5	*
	6	* The contents of this file constitute Original Code as defined in and
	7	* are subject to the Apple Public Source License Version 1.1 (the
	8	* "License"). You may not use this file except in compliance with the
	9	* License. Please obtain a copy of the License at
	10	* http://www.apple.com/publicsource and read it before using this file.
	11	*
	12	* This Original Code and all software distributed under the License are
	13	* distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
	14	* EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
	15	* INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
	16	* FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT. Please see the
	17	* License for the specific language governing rights and limitations
	18	* under the License.
	19	*
	20	* @APPLE_LICENSE_HEADER_END@
	21	*/
	22	/*
	23	* @OSF_COPYRIGHT@
	24	*/
	25	/*
	26	* File: clock_types.h
	27	* Purpose: Clock facility header definitions. These
	28	* definitons are needed by both kernel and
	29	* user-level software.
	30	*/
	31
	32	/*
	33	* N.B. This interface has been deprecated and the contents
	34	* of this file should be considered obsolete.
	35	*/
	36
	37	#ifndef _MACH_CLOCK_TYPES_H_
	38	#define _MACH_CLOCK_TYPES_H_
	39
	40	#include <mach/time_value.h>
	41
	42	/*
	43	* Reserved clock id values for default clocks.
	44	*/
	45	#define SYSTEM_CLOCK 0 /* advances monotonically and
	46	* uniformly; set to zero at boot */
	47	#define CALENDAR_CLOCK 1 /* 'wall' clock; effectively
	48	* synchronized to UTC */
	49
	50	#define REALTIME_CLOCK 0 /* obsolete; use SYSTEM or CALENDAR
	51	* clock depending on particular
	52	* requirements */
	53
	54	/*
	55	* Type definitions.
	56	*/
	57	typedef int alarm_type_t; /* alarm time type */
	58	typedef int sleep_type_t; /* sleep time type */
	59	typedef int clock_id_t; /* clock identification type */
	60	typedef int clock_flavor_t; /* clock flavor type */
	61	typedef int clock_attr_t; / clock attribute type */
	62	typedef int clock_res_t; /* clock resolution type */
	63
	64	/*
65	* Attribute names.
66	*/
67	#define CLOCK_GET_TIME_RES 1 /* get_time call resolution */
68	/* 2 * was map_time call resolution */
69	#define CLOCK_ALARM_CURRES 3 /* current alarm resolution */
70	#define CLOCK_ALARM_MINRES 4 /* minimum alarm resolution */
71	#define CLOCK_ALARM_MAXRES 5 /* maximum alarm resolution */
72
73	/*
74	* Normal time specification used by the kernel clock facility.
75	*/
76	struct mach_timespec {
77	unsigned int tv_sec; /* seconds */
78	clock_res_t tv_nsec; /* nanoseconds */
79	};
80	typedef struct mach_timespec mach_timespec_t;
81
82	#define NSEC_PER_USEC 1000 /* nanoseconds per microsecond */
83	#define USEC_PER_SEC 1000000 /* microseconds per second */
84	#define NSEC_PER_SEC 1000000000 /* nanoseconds per second */
85
86	#define BAD_MACH_TIMESPEC(t) \
87	((t)->tv_nsec < 0 \|\| (t)->tv_nsec >= NSEC_PER_SEC)
88
89	/* t1 <=> t2, also (t1 - t2) in nsec with max of +- 1 sec */
90	#define CMP_MACH_TIMESPEC(t1, t2) \
91	((t1)->tv_sec > (t2)->tv_sec ? +NSEC_PER_SEC : \
92	((t1)->tv_sec < (t2)->tv_sec ? -NSEC_PER_SEC : \
93	(t1)->tv_nsec - (t2)->tv_nsec))
94
95	/* t1 += t2 */
96	#define ADD_MACH_TIMESPEC(t1, t2) \
97	do { \
98	if (((t1)->tv_nsec += (t2)->tv_nsec) >= NSEC_PER_SEC) { \
99	(t1)->tv_nsec -= NSEC_PER_SEC; \
100	(t1)->tv_sec += 1; \
101	} \
102	(t1)->tv_sec += (t2)->tv_sec; \
103	} while (0)
104
105	/* t1 -= t2 */
106	#define SUB_MACH_TIMESPEC(t1, t2) \
107	do { \
108	if (((t1)->tv_nsec -= (t2)->tv_nsec) < 0) { \
109	(t1)->tv_nsec += NSEC_PER_SEC; \
110	(t1)->tv_sec -= 1; \
111	} \
112	(t1)->tv_sec -= (t2)->tv_sec; \
113	} while (0)
114
115	/*
116	* Alarm parameter defines.
117	*/
118	#define ALRMTYPE 0xff /* type (8-bit field) */
119	#define TIME_ABSOLUTE 0x00 /* absolute time */
120	#define TIME_RELATIVE 0x01 /* relative time */
121
122	#define BAD_ALRMTYPE(t) (((t) &~ TIME_RELATIVE) != 0)
123
124	#endif /* _MACH_CLOCK_TYPES_H_ */