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  *      All interfaces defined here are obsolete.
  34  */
  35
  36 #ifndef _MACH_CLOCK_TYPES_H_
  37 #define _MACH_CLOCK_TYPES_H_
  38
  39 #include <stdint.h>
  40 #include <mach/time_value.h>
  41
  42 /*
  43  * Type definitions.
  44  */
  45 typedef int     alarm_type_t;           /* alarm time type */
  46 typedef int     sleep_type_t;           /* sleep time type */
  47 typedef int     clock_id_t;                     /* clock identification type */
  48 typedef int     clock_flavor_t;         /* clock flavor type */
  49 typedef int     *clock_attr_t;          /* clock attribute type */
  50 typedef int     clock_res_t;            /* clock resolution type */
  51
  52 /*
  53  * Normal time specification used by the kernel clock facility.
  54  */
  55 struct mach_timespec {
  56         unsigned int    tv_sec;                 /* seconds */
  57         clock_res_t             tv_nsec;                /* nanoseconds */
  58 };
  59 typedef struct mach_timespec    mach_timespec_t;
  60
  61 /*
  62  * Reserved clock id values for default clocks.
  63  */
  64 #define SYSTEM_CLOCK            0
  65 #define CALENDAR_CLOCK          1
  66
  67 #define REALTIME_CLOCK          0
  68
  69 /*
  70  * Attribute names.
  71  */
  72 #define CLOCK_GET_TIME_RES      1       /* get_time call resolution */
  73 /*                                                      2        * was map_time call resolution */
  74 #define CLOCK_ALARM_CURRES      3       /* current alarm resolution */
  75 #define CLOCK_ALARM_MINRES      4       /* minimum alarm resolution */
  76 #define CLOCK_ALARM_MAXRES      5       /* maximum alarm resolution */
  77
  78 #define NSEC_PER_USEC   1000            /* nanoseconds per microsecond */
  79 #define USEC_PER_SEC    1000000         /* microseconds per second */
  80 #define NSEC_PER_SEC    1000000000      /* nanoseconds per second */
  81
  82 #define BAD_MACH_TIMESPEC(t)                                            \
  83         ((t)->tv_nsec < 0 || (t)->tv_nsec >= NSEC_PER_SEC)
  84
  85 /* t1 <=> t2, also (t1 - t2) in nsec with max of +- 1 sec */
  86 #define CMP_MACH_TIMESPEC(t1, t2)                                       \
  87         ((t1)->tv_sec > (t2)->tv_sec ? +NSEC_PER_SEC :  \
  88         ((t1)->tv_sec < (t2)->tv_sec ? -NSEC_PER_SEC :  \
  89                         (t1)->tv_nsec - (t2)->tv_nsec))
  90
  91 /* t1  += t2 */
  92 #define ADD_MACH_TIMESPEC(t1, t2)                                                               \
  93   do {                                                                                                                  \
  94         if (((t1)->tv_nsec += (t2)->tv_nsec) >= NSEC_PER_SEC) {         \
  95                 (t1)->tv_nsec -= NSEC_PER_SEC;                                                  \
  96                 (t1)->tv_sec  += 1;                                                                             \
  97         }                                                                                                                       \
  98         (t1)->tv_sec += (t2)->tv_sec;                                                           \
  99   } while (0)
 100
 101 /* t1  -= t2 */
 102 #define SUB_MACH_TIMESPEC(t1, t2)                                                               \
 103   do {                                                                                                                  \
 104         if (((t1)->tv_nsec -= (t2)->tv_nsec) < 0) {                                     \
 105                 (t1)->tv_nsec += NSEC_PER_SEC;                                                  \
 106                 (t1)->tv_sec  -= 1;                                                                             \
 107         }                                                                                                                       \
 108         (t1)->tv_sec -= (t2)->tv_sec;                                                           \
 109   } while (0)
 110
 111 /*
 112  * Alarm parameter defines.
 113  */
 114 #define ALRMTYPE                        0xff            /* type (8-bit field)   */
 115 #define TIME_ABSOLUTE           0x00            /* absolute time */
 116 #define TIME_RELATIVE           0x01            /* relative time */
 117
 118 #define BAD_ALRMTYPE(t)         (((t) &~ TIME_RELATIVE) != 0)
 119
 120 #endif /* _MACH_CLOCK_TYPES_H_ */