Annotation of kernel/mach/time_value.h, revision 1.1.1.1

1.1       root        1: /*
                      2:  * Copyright (c) 1999 Apple Computer, Inc. All rights reserved.
                      3:  *
                      4:  * @APPLE_LICENSE_HEADER_START@
                      5:  * 
                      6:  * Portions Copyright (c) 1999 Apple Computer, Inc.  All Rights
                      7:  * Reserved.  This file contains Original Code and/or Modifications of
                      8:  * Original Code as defined in and that are subject to the Apple Public
                      9:  * Source License Version 1.1 (the "License").  You may not use this file
                     10:  * except in compliance with the License.  Please obtain a copy of the
                     11:  * License at http://www.apple.com/publicsource and read it before using
                     12:  * this file.
                     13:  * 
                     14:  * The Original Code and all software distributed under the License are
                     15:  * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
                     16:  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
                     17:  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
                     18:  * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
                     19:  * License for the specific language governing rights and limitations
                     20:  * under the License.
                     21:  * 
                     22:  * @APPLE_LICENSE_HEADER_END@
                     23:  */
                     24: 
                     25: /* 
                     26:  * Mach Operating System
                     27:  * Copyright (c) 1991,1990,1989,1988,1987 Carnegie Mellon University
                     28:  * All Rights Reserved.
                     29:  * 
                     30:  * Permission to use, copy, modify and distribute this software and its
                     31:  * documentation is hereby granted, provided that both the copyright
                     32:  * notice and this permission notice appear in all copies of the
                     33:  * software, derivative works or modified versions, and any portions
                     34:  * thereof, and that both notices appear in supporting documentation.
                     35:  * 
                     36:  * CARNEGIE MELLON ALLOWS FREE USE OF THIS SOFTWARE IN ITS "AS IS"
                     37:  * CONDITION.  CARNEGIE MELLON DISCLAIMS ANY LIABILITY OF ANY KIND FOR
                     38:  * ANY DAMAGES WHATSOEVER RESULTING FROM THE USE OF THIS SOFTWARE.
                     39:  * 
                     40:  * Carnegie Mellon requests users of this software to return to
                     41:  * 
                     42:  *  Software Distribution Coordinator  or  [email protected]
                     43:  *  School of Computer Science
                     44:  *  Carnegie Mellon University
                     45:  *  Pittsburgh PA 15213-3890
                     46:  * 
                     47:  * any improvements or extensions that they make and grant Carnegie Mellon
                     48:  * the rights to redistribute these changes.
                     49:  */
                     50: 
                     51: #ifndef        _MACH_TIME_VALUE_H_
                     52: #define        _MACH_TIME_VALUE_H_
                     53: 
                     54: #include <mach/machine/vm_types.h>
                     55: 
                     56: /*
                     57:  *     Time value returned by kernel.
                     58:  */
                     59: 
                     60: struct time_value {
                     61:        integer_t       seconds;
                     62:        integer_t       microseconds;
                     63: };
                     64: typedef        struct time_value       time_value_t;
                     65: 
                     66: /*
                     67:  *     Macros to manipulate time values.  Assume that time values
                     68:  *     are normalized (microseconds <= 999999).
                     69:  */
                     70: #define        TIME_MICROS_MAX (1000000)
                     71: 
                     72: #define        time_value_add_usec(val, micros)        {       \
                     73:        if (((val)->microseconds += (micros))           \
                     74:                >= TIME_MICROS_MAX) {                   \
                     75:            (val)->microseconds -= TIME_MICROS_MAX;     \
                     76:            (val)->seconds++;                           \
                     77:        }                                               \
                     78: }
                     79: 
                     80: #define        time_value_add(result, addend)          {               \
                     81:        (result)->microseconds += (addend)->microseconds;       \
                     82:        (result)->seconds += (addend)->seconds;                 \
                     83:        if ((result)->microseconds >= TIME_MICROS_MAX) {        \
                     84:            (result)->microseconds -= TIME_MICROS_MAX;          \
                     85:            (result)->seconds++;                                \
                     86:        }                                                       \
                     87: }
                     88: 
                     89: /*
                     90:  *     Time value available through the mapped-time interface.
                     91:  *     Read this mapped value with
                     92:  *             do {
                     93:  *                     secs = mtime->seconds;
                     94:  *                     usecs = mtime->microseconds;
                     95:  *             } while (secs != mtime->check_seconds);
                     96:  */
                     97: 
                     98: typedef struct mapped_time_value {
                     99:        integer_t seconds;
                    100:        integer_t microseconds;
                    101:        integer_t check_seconds;
                    102: } mapped_time_value_t;
                    103: 
                    104: #endif /* _MACH_TIME_VALUE_H_ */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.