epoc32/include/stdapis/sys/time.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
parent 2 2fe1408b6811
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h)
This is the epoc32/include tree with the "platform" subtrees removed, and
all but a selected few mbg and rsg files removed.
williamr@2
     1
/*-
williamr@2
     2
 * Copyright (c) 1982, 1986, 1993
williamr@2
     3
 *	The Regents of the University of California.  All rights reserved.
williamr@2
     4
 *
williamr@2
     5
 * Redistribution and use in source and binary forms, with or without
williamr@2
     6
 * modification, are permitted provided that the following conditions
williamr@2
     7
 * are met:
williamr@2
     8
 * 1. Redistributions of source code must retain the above copyright
williamr@2
     9
 *    notice, this list of conditions and the following disclaimer.
williamr@2
    10
 * 2. Redistributions in binary form must reproduce the above copyright
williamr@2
    11
 *    notice, this list of conditions and the following disclaimer in the
williamr@2
    12
 *    documentation and/or other materials provided with the distribution.
williamr@2
    13
 * 4. Neither the name of the University nor the names of its contributors
williamr@2
    14
 *    may be used to endorse or promote products derived from this software
williamr@2
    15
 *    without specific prior written permission.
williamr@2
    16
 *
williamr@2
    17
 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
williamr@2
    18
 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
williamr@2
    19
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
williamr@2
    20
 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
williamr@2
    21
 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
williamr@2
    22
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
williamr@2
    23
 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
williamr@2
    24
 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
williamr@2
    25
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
williamr@2
    26
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
williamr@2
    27
 * SUCH DAMAGE.
williamr@4
    28
 * © * Portions Copyright (c) 2007 Nokia Corporation and/or its subsidiary(-ies). All rights reserved.
williamr@2
    29
 *	@(#)time.h	8.5 (Berkeley) 5/4/95
williamr@2
    30
 * $FreeBSD: src/sys/sys/time.h,v 1.69 2005/04/02 12:33:27 das Exp $
williamr@2
    31
 */
williamr@2
    32
williamr@2
    33
#ifndef _SYS_TIME_H_
williamr@2
    34
#define _SYS_TIME_H_
williamr@2
    35
williamr@2
    36
#include <sys/_timeval.h>
williamr@2
    37
#include <sys/types.h>
williamr@2
    38
#include <sys/timespec.h>
williamr@2
    39
williamr@2
    40
struct timezone {
williamr@2
    41
	int	tz_minuteswest;	/* minutes west of Greenwich */
williamr@2
    42
	int	tz_dsttime;	/* type of dst correction */
williamr@2
    43
};
williamr@2
    44
#define	DST_NONE	0	/* not on dst */
williamr@2
    45
#define	DST_USA		1	/* USA style dst */
williamr@2
    46
#define	DST_AUST	2	/* Australian style dst */
williamr@2
    47
#define	DST_WET		3	/* Western European dst */
williamr@2
    48
#define	DST_MET		4	/* Middle European dst */
williamr@2
    49
#define	DST_EET		5	/* Eastern European dst */
williamr@2
    50
#define	DST_CAN		6	/* Canada */
williamr@2
    51
williamr@2
    52
#if __BSD_VISIBLE
williamr@2
    53
struct bintime {
williamr@2
    54
	time_t	sec;
williamr@2
    55
	uint64_t frac;
williamr@2
    56
};
williamr@2
    57
williamr@2
    58
static __inline void
williamr@2
    59
bintime_addx(struct bintime *bt, uint64_t x)
williamr@2
    60
{
williamr@2
    61
	uint64_t u;
williamr@2
    62
williamr@2
    63
	u = bt->frac;
williamr@2
    64
	bt->frac += x;
williamr@2
    65
	if (u > bt->frac)
williamr@2
    66
		bt->sec++;
williamr@2
    67
}
williamr@2
    68
williamr@2
    69
static __inline void
williamr@2
    70
bintime_add(struct bintime *bt, const struct bintime *bt2)
williamr@2
    71
{
williamr@2
    72
	uint64_t u;
williamr@2
    73
williamr@2
    74
	u = bt->frac;
williamr@2
    75
	bt->frac += bt2->frac;
williamr@2
    76
	if (u > bt->frac)
williamr@2
    77
		bt->sec++;
williamr@2
    78
	bt->sec += bt2->sec;
williamr@2
    79
}
williamr@2
    80
williamr@2
    81
static __inline void
williamr@2
    82
bintime_sub(struct bintime *bt, const struct bintime *bt2)
williamr@2
    83
{
williamr@2
    84
	uint64_t u;
williamr@2
    85
williamr@2
    86
	u = bt->frac;
williamr@2
    87
	bt->frac -= bt2->frac;
williamr@2
    88
	if (u < bt->frac)
williamr@2
    89
		bt->sec--;
williamr@2
    90
	bt->sec -= bt2->sec;
williamr@2
    91
}
williamr@2
    92
williamr@2
    93
/*-
williamr@2
    94
 * Background information:
williamr@2
    95
 *
williamr@2
    96
 * When converting between timestamps on parallel timescales of differing
williamr@2
    97
 * resolutions it is historical and scientific practice to round down rather
williamr@2
    98
 * than doing 4/5 rounding.
williamr@2
    99
 *
williamr@2
   100
 *   The date changes at midnight, not at noon.
williamr@2
   101
 *
williamr@2
   102
 *   Even at 15:59:59.999999999 it's not four'o'clock.
williamr@2
   103
 *
williamr@2
   104
 *   time_second ticks after N.999999999 not after N.4999999999
williamr@2
   105
 */
williamr@2
   106
williamr@2
   107
static __inline void
williamr@2
   108
bintime2timespec(const struct bintime *bt, struct timespec *ts)
williamr@2
   109
{
williamr@2
   110
williamr@2
   111
	ts->tv_sec = bt->sec;
williamr@2
   112
	ts->tv_nsec = ((uint64_t)1000000000 * (uint32_t)(bt->frac >> 32)) >> 32;
williamr@2
   113
}
williamr@2
   114
williamr@2
   115
static __inline void
williamr@2
   116
timespec2bintime(const struct timespec *ts, struct bintime *bt)
williamr@2
   117
{
williamr@2
   118
williamr@2
   119
	bt->sec = ts->tv_sec;
williamr@2
   120
	/* 18446744073 = int(2^64 / 1000000000) */
williamr@2
   121
	bt->frac = ts->tv_nsec * (uint64_t)18446744073LL; 
williamr@2
   122
}
williamr@2
   123
williamr@2
   124
static __inline void
williamr@2
   125
bintime2timeval(const struct bintime *bt, struct timeval *tv)
williamr@2
   126
{
williamr@2
   127
williamr@2
   128
	tv->tv_sec = bt->sec;
williamr@2
   129
	tv->tv_usec = ((uint64_t)1000000 * (uint32_t)(bt->frac >> 32)) >> 32;
williamr@2
   130
}
williamr@2
   131
williamr@2
   132
static __inline void
williamr@2
   133
timeval2bintime(const struct timeval *tv, struct bintime *bt)
williamr@2
   134
{
williamr@2
   135
williamr@2
   136
	bt->sec = tv->tv_sec;
williamr@2
   137
	/* 18446744073709 = int(2^64 / 1000000) */
williamr@2
   138
	bt->frac = tv->tv_usec * (uint64_t)18446744073709LL;
williamr@2
   139
}
williamr@2
   140
#endif /* __BSD_VISIBLE */
williamr@2
   141
williamr@2
   142
/*
williamr@2
   143
 * Names of the interval timers, and structure
williamr@2
   144
 * defining a timer setting.
williamr@2
   145
 */
williamr@2
   146
#define	ITIMER_REAL	0
williamr@2
   147
#define	ITIMER_VIRTUAL	1
williamr@2
   148
#define	ITIMER_PROF	2
williamr@2
   149
williamr@2
   150
struct itimerval {
williamr@2
   151
	struct	timeval it_interval;	/* timer interval */
williamr@2
   152
	struct	timeval it_value;	/* current value */
williamr@2
   153
};
williamr@2
   154
williamr@2
   155
/*
williamr@2
   156
 * Getkerninfo clock information structure
williamr@2
   157
 */
williamr@2
   158
struct clockinfo {
williamr@2
   159
	int	hz;		/* clock frequency */
williamr@2
   160
	int	tick;		/* micro-seconds per hz tick */
williamr@2
   161
	int	spare;
williamr@2
   162
	int	stathz;		/* statistics clock frequency */
williamr@2
   163
	int	profhz;		/* profiling clock frequency */
williamr@2
   164
};
williamr@2
   165
williamr@2
   166
#include <time.h>
williamr@2
   167
williamr@2
   168
#include <sys/cdefs.h>
williamr@2
   169
williamr@2
   170
__BEGIN_DECLS
williamr@2
   171
IMPORT_C int	adjtime(const struct timeval *, struct timeval *);
williamr@2
   172
IMPORT_C int	gettimeofday(struct timeval *, struct timezone *);
williamr@2
   173
int	settimeofday(const struct timeval *, const struct timezone *);
williamr@2
   174
IMPORT_C int	utimes(const char *, const struct timeval *);
williamr@2
   175
__END_DECLS
williamr@2
   176
williamr@2
   177
williamr@2
   178
#endif /* !_SYS_TIME_H_ */