osfmk/mach/clock_types.h

   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_ */