Sync usage with man page.
[netbsd-mini2440.git] / include / time.h
blob2115ff2739a291704b70e59401a7ff3d556868bd
1 /* $NetBSD: time.h,v 1.38 2009/01/11 03:04:12 christos Exp $ */
3 /*
4 * Copyright (c) 1989, 1993
5 * The Regents of the University of California. All rights reserved.
6 * (c) UNIX System Laboratories, Inc.
7 * All or some portions of this file are derived from material licensed
8 * to the University of California by American Telephone and Telegraph
9 * Co. or Unix System Laboratories, Inc. and are reproduced herein with
10 * the permission of UNIX System Laboratories, Inc.
12 * Redistribution and use in source and binary forms, with or without
13 * modification, are permitted provided that the following conditions
14 * are met:
15 * 1. Redistributions of source code must retain the above copyright
16 * notice, this list of conditions and the following disclaimer.
17 * 2. Redistributions in binary form must reproduce the above copyright
18 * notice, this list of conditions and the following disclaimer in the
19 * documentation and/or other materials provided with the distribution.
20 * 3. Neither the name of the University nor the names of its contributors
21 * may be used to endorse or promote products derived from this software
22 * without specific prior written permission.
24 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
25 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
28 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 * SUCH DAMAGE.
36 * @(#)time.h 8.3 (Berkeley) 1/21/94
39 #ifndef _TIME_H_
40 #define _TIME_H_
42 #include <sys/cdefs.h>
43 #include <sys/featuretest.h>
44 #include <machine/ansi.h>
46 #include <sys/null.h>
48 #ifdef _BSD_CLOCK_T_
49 typedef _BSD_CLOCK_T_ clock_t;
50 #undef _BSD_CLOCK_T_
51 #endif
53 #ifdef _BSD_TIME_T_
54 typedef _BSD_TIME_T_ time_t;
55 #undef _BSD_TIME_T_
56 #endif
58 #ifdef _BSD_SIZE_T_
59 typedef _BSD_SIZE_T_ size_t;
60 #undef _BSD_SIZE_T_
61 #endif
63 #ifdef _BSD_CLOCKID_T_
64 typedef _BSD_CLOCKID_T_ clockid_t;
65 #undef _BSD_CLOCKID_T_
66 #endif
68 #ifdef _BSD_TIMER_T_
69 typedef _BSD_TIMER_T_ timer_t;
70 #undef _BSD_TIMER_T_
71 #endif
73 #define CLOCKS_PER_SEC 100
75 struct tm {
76 int tm_sec; /* seconds after the minute [0-61] */
77 int tm_min; /* minutes after the hour [0-59] */
78 int tm_hour; /* hours since midnight [0-23] */
79 int tm_mday; /* day of the month [1-31] */
80 int tm_mon; /* months since January [0-11] */
81 int tm_year; /* years since 1900 */
82 int tm_wday; /* days since Sunday [0-6] */
83 int tm_yday; /* days since January 1 [0-365] */
84 int tm_isdst; /* Daylight Savings Time flag */
85 long tm_gmtoff; /* offset from UTC in seconds */
86 __aconst char *tm_zone; /* timezone abbreviation */
89 __BEGIN_DECLS
90 char *asctime(const struct tm *);
91 clock_t clock(void);
92 #ifndef __LIBC12_SOURCE__
93 char *ctime(const time_t *) __RENAME(__ctime50);
94 double difftime(time_t, time_t) __RENAME(__difftime50);
95 struct tm *gmtime(const time_t *) __RENAME(__gmtime50);
96 struct tm *localtime(const time_t *) __RENAME(__locatime50);
97 time_t time(time_t *) __RENAME(__time50);
98 time_t mktime(struct tm *) __RENAME(__mktime50);
99 #endif
100 size_t strftime(char * __restrict, size_t, const char * __restrict,
101 const struct tm * __restrict)
102 __attribute__((__format__(__strftime__, 3, 0)));
104 #if defined(_POSIX_C_SOURCE) || defined(_XOPEN_SOURCE) || \
105 defined(_NETBSD_SOURCE)
106 #ifndef __LIBC12_SOURCE__
108 * CLK_TCK uses libc's internal __sysconf() to retrieve the machine's
109 * HZ. The value of _SC_CLK_TCK is 39 -- we hard code it so we do not
110 * need to include unistd.h
112 long __sysconf(int);
113 #define CLK_TCK (__sysconf(39))
114 #endif
115 #endif
117 extern __aconst char *tzname[2];
118 #ifndef __LIBC12_SOURCE__
119 void tzset(void) __RENAME(__tzset50);
120 #endif
123 * X/Open Portability Guide >= Issue 4
125 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
126 extern int daylight;
127 #ifndef __LIBC12_SOURCE__
128 extern long int timezone __RENAME(__timezone13);
129 #endif
130 char *strptime(const char * __restrict, const char * __restrict,
131 struct tm * __restrict);
132 #endif
134 #if (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
135 defined(_NETBSD_SOURCE)
136 struct tm *getdate(const char *);
137 extern int getdate_err;
138 #endif
140 #if (_POSIX_C_SOURCE - 0) >= 199309L || (_XOPEN_SOURCE - 0) >= 500 || \
141 defined(_NETBSD_SOURCE)
142 #include <sys/time.h> /* XXX for struct timespec */
143 struct sigevent;
144 struct itimerspec;
145 #ifndef __LIBC12_SOURCE__
146 int clock_getres(clockid_t, struct timespec *)
147 __RENAME(__clock_getres50);
148 int clock_gettime(clockid_t, struct timespec *)
149 __RENAME(__clock_gettime50);
150 int clock_settime(clockid_t, const struct timespec *)
151 __RENAME(__clock_settime50);
152 int nanosleep(const struct timespec *, struct timespec *)
153 __RENAME(__nanosleep50);
154 int timer_gettime(timer_t, struct itimerspec *) __RENAME(__timer_gettime50);
155 int timer_settime(timer_t, int, const struct itimerspec * __restrict,
156 struct itimerspec * __restrict) __RENAME(__timer_settime50);
157 #endif
158 int timer_create(clockid_t, struct sigevent * __restrict,
159 timer_t * __restrict);
160 int timer_delete(timer_t);
161 int timer_getoverrun(timer_t);
162 #endif /* _POSIX_C_SOURCE >= 199309 || _XOPEN_SOURCE >= 500 || ... */
164 #if (_POSIX_C_SOURCE - 0) >= 199506L || (_XOPEN_SOURCE - 0) >= 500 || \
165 defined(_REENTRANT) || defined(_NETBSD_SOURCE)
166 char *asctime_r(const struct tm * __restrict, char * __restrict);
167 #ifndef __LIBC12_SOURCE__
168 char *ctime_r(const time_t *, char *) __RENAME(__ctime_r50);
169 struct tm *gmtime_r(const time_t * __restrict, struct tm * __restrict)
170 __RENAME(__gmtime_r50);
171 struct tm *localtime_r(const time_t * __restrict, struct tm * __restrict)
172 __RENAME(__localtime_r50);
173 #endif
174 #endif
176 #if defined(_NETBSD_SOURCE)
177 #ifndef __LIBC12_SOURCE__
178 time_t time2posix(time_t) __RENAME(__time2posix50);
179 time_t posix2time(time_t) __RENAME(__posix2time50);
180 time_t timegm(struct tm *) __RENAME(__timegm50);
181 time_t timeoff(struct tm *, long) __RENAME(__timeoff50);
182 time_t timelocal(struct tm *) __RENAME(__timelocal50);
183 struct tm *offtime(const time_t *, long) __RENAME(__offtime50);
184 #endif
185 #ifndef __LIBC12_SOURCE__
186 void tzsetwall(void) __RENAME(__tzsetwall50);
187 #endif
188 #endif /* _NETBSD_SOURCE */
190 __END_DECLS
192 #endif /* !_TIME_H_ */