1 /*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21 /* Copyright (c) 1988 AT&T */
22 /* All Rights Reserved */
23
24
25 /*
26 * Copyright 2007 Sun Microsystems, Inc. All rights reserved.
27 * Use is subject to license terms.
28 */
29 /*
30 * Copyright 2010 Nexenta Systems, Inc. Al rights reserved.
31 * Copyright 2014 Garrett D'Amore <garrett@damore.org>
32 */
33
34 #ifndef _TIME_H
35 #define _TIME_H
36
37 #include <sys/feature_tests.h>
38 #include <iso/time_iso.h>
39 #if (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
40 (_POSIX_C_SOURCE > 2) || defined(__EXTENSIONS__)
41 #include <sys/types.h>
42 #include <sys/time_impl.h>
43 #endif /* (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) ... */
44
45 /*
46 * Allow global visibility for symbols defined in
47 * C++ "std" namespace in <iso/time_iso.h>.
48 */
49 #if __cplusplus >= 199711L
50 using std::size_t;
51 using std::clock_t;
52 using std::time_t;
53 using std::tm;
54 using std::asctime;
55 using std::clock;
56 using std::ctime;
57 using std::difftime;
58 using std::gmtime;
59 using std::localtime;
60 using std::mktime;
61 using std::time;
62 using std::strftime;
63 #endif
64
65 #ifdef __cplusplus
66 extern "C" {
67 #endif
68
69 #ifndef _CLOCKID_T
70 #define _CLOCKID_T
71 typedef int clockid_t;
72 #endif
73
74 #ifndef _TIMER_T
75 #define _TIMER_T
76 typedef int timer_t;
77 #endif
78
79 #if defined(__STDC__)
80
81 #if defined(__EXTENSIONS__) || \
82 (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
83 (_POSIX_C_SOURCE - 0 >= 199506L) || defined(_REENTRANT)
84 extern struct tm *gmtime_r(const time_t *_RESTRICT_KYWD,
85 struct tm *_RESTRICT_KYWD);
86 extern struct tm *localtime_r(const time_t *_RESTRICT_KYWD,
87 struct tm *_RESTRICT_KYWD);
88 #endif
89
90 #if (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
91 defined(_XPG4) || defined(__EXTENSIONS__)
92
93 #ifdef _STRPTIME_DONTZERO
94 #ifdef __PRAGMA_REDEFINE_EXTNAME
95 #pragma redefine_extname strptime __strptime_dontzero
96 #else /* __PRAGMA_REDEFINE_EXTNAME */
97 extern char *__strptime_dontzero(const char *, const char *, struct tm *);
98 #define strptime __strptime_dontzero
99 #endif /* __PRAGMA_REDEFINE_EXTNAME */
100 #endif /* _STRPTIME_DONTZERO */
101
102 extern char *strptime(const char *_RESTRICT_KYWD, const char *_RESTRICT_KYWD,
103 struct tm *_RESTRICT_KYWD);
104
105 #endif /* (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX))... */
106
107 #if (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
108 (_POSIX_C_SOURCE > 2) || defined(__EXTENSIONS__)
109 /*
110 * Neither X/Open nor POSIX allow the inclusion of <signal.h> for the
111 * definition of the sigevent structure. Both require the inclusion
112 * of <signal.h> and <time.h> when using the timer_create() function.
113 * However, X/Open also specifies that the sigevent structure be defined
114 * in <time.h> as described in the header <signal.h>. This prevents
115 * compiler warnings for applications that only include <time.h> and not
116 * also <signal.h>. The sigval union and the sigevent structure is
117 * therefore defined both here and in <sys/siginfo.h> which gets included
118 * via inclusion of <signal.h>.
119 */
120 #ifndef _SIGVAL
121 #define _SIGVAL
122 union sigval {
123 int sival_int; /* integer value */
124 void *sival_ptr; /* pointer value */
125 };
126 #endif /* _SIGVAL */
127
128 #ifndef _SIGEVENT
129 #define _SIGEVENT
130 struct sigevent {
131 int sigev_notify; /* notification mode */
132 int sigev_signo; /* signal number */
133 union sigval sigev_value; /* signal value */
134 void (*sigev_notify_function)(union sigval);
135 pthread_attr_t *sigev_notify_attributes;
136 int __sigev_pad2;
137 };
138 #endif /* _SIGEVENT */
139
140 extern int clock_getres(clockid_t, struct timespec *);
141 extern int clock_gettime(clockid_t, struct timespec *);
142 extern int clock_settime(clockid_t, const struct timespec *);
143 extern int timer_create(clockid_t, struct sigevent *_RESTRICT_KYWD,
144 timer_t *_RESTRICT_KYWD);
145 extern int timer_delete(timer_t);
146 extern int timer_getoverrun(timer_t);
147 extern int timer_gettime(timer_t, struct itimerspec *);
148 extern int timer_settime(timer_t, int, const struct itimerspec *_RESTRICT_KYWD,
149 struct itimerspec *_RESTRICT_KYWD);
150
151 extern int nanosleep(const struct timespec *, struct timespec *);
152 extern int clock_nanosleep(clockid_t, int,
153 const struct timespec *, struct timespec *);
154
155 #endif /* (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX))... */
156
157 #if !defined(_STRICT_STDC) || defined(__XOPEN_OR_POSIX) || \
158 defined(__EXTENSIONS__)
159
160 extern void tzset(void);
161 extern char *tzname[2];
162
163 /* CLK_TCK marked as LEGACY in SUSv2 and removed in SUSv3 */
164 #if !defined(_XPG6) || defined(__EXTENSIONS__)
165 #ifndef CLK_TCK
166 extern long _sysconf(int); /* System Private interface to sysconf() */
167 #define CLK_TCK ((clock_t)_sysconf(3)) /* clock ticks per second */
168 /* 3 is _SC_CLK_TCK */
169 #endif
170 #endif /* !defined(_XPG6) || defined(__EXTENSIONS__) */
171
172 #if (!defined(_STRICT_STDC) && !defined(_POSIX_C_SOURCE)) || \
173 defined(_XOPEN_SOURCE) || defined(__EXTENSIONS__)
174 extern long timezone;
175 extern int daylight;
176 #endif
177
178 #endif /* !defined(_STRICT_STDC) || defined(__XOPEN_OR_POSIX)... */
179
180 #if (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
181 defined(__EXTENSIONS__)
182 extern time_t timegm(struct tm *);
183 extern int cftime(char *, char *, const time_t *);
184 extern int ascftime(char *, const char *, const struct tm *);
185 extern long altzone;
186 #endif
187
188 #if (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
189 defined(_XPG4_2) || defined(__EXTENSIONS__)
190 extern struct tm *getdate(const char *);
191 #ifdef _REENTRANT
192 #undef getdate_err
193 #define getdate_err *(int *)_getdate_err_addr()
194 extern int *_getdate_err_addr(void);
195 #else
196 extern int getdate_err;
197 #endif /* _REENTRANT */
198 #endif /* (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX))... */
199
200 #else /* __STDC__ */
201
202 extern int cftime(), ascftime();
203 extern void tzset();
204 extern time_t timegm();
205
206 #ifdef _STRPTIME_DONTZERO
207 #ifdef __PRAGMA_REDEFINE_EXTNAME
208 #pragma redefine_extname strptime __strptime_dontzero
209 #else /* __PRAGMA_REDEFINE_EXTNAME */
210 extern char *__strptime_dontzero();
211 #define strptime __strptime_dontzero
212 #endif /* __PRAGMA_REDEFINE_EXTNAME */
213 #endif /* _STRPTIME_DONTZERO */
214
215 extern char *strptime();
216
217 #if defined(__EXTENSIONS__) || \
218 (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
219 (_POSIX_C_SOURCE - 0 >= 199506L) || defined(_REENTRANT)
220 extern struct tm *gmtime_r();
221 extern struct tm *localtime_r();
222 #endif
223
224 extern long timezone, altzone;
225 extern int daylight;
226 extern char *tzname[2];
227
228 #if !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2) || defined(__EXTENSIONS__)
229 extern struct tm *getdate();
230 #ifdef _REENTRANT
231 #undef getdate_err
232 #define getdate_err *(int *)_getdate_err_addr()
233 extern int *_getdate_err_addr();
234 #else
235 extern int getdate_err;
236 #endif /* _REENTRANT */
237 #endif /* !defined(__XOPEN_OR_POSIX) || defined(_XPG4_2)... */
238
239 #endif /* __STDC__ */
240
241 /*
242 * ctime_r() & asctime_r() prototypes are defined here.
243 */
244
245 /*
246 * Previous releases of Solaris, starting at 2.3, provided definitions of
247 * various functions as specified in POSIX.1c, Draft 6. For some of these
248 * functions, the final POSIX 1003.1c standard had a different number of
249 * arguments and return values.
250 *
251 * The following segment of this header provides support for the standard
252 * interfaces while supporting applications written under earlier
253 * releases. The application defines appropriate values of the feature
254 * test macros _POSIX_C_SOURCE and _POSIX_PTHREAD_SEMANTICS to indicate
255 * whether it was written to expect the Draft 6 or standard versions of
256 * these interfaces, before including this header. This header then
257 * provides a mapping from the source version of the interface to an
258 * appropriate binary interface. Such mappings permit an application
259 * to be built from libraries and objects which have mixed expectations
260 * of the definitions of these functions.
261 *
262 * For applications using the Draft 6 definitions, the binary symbol is the
263 * same as the source symbol, and no explicit mapping is needed. For the
264 * standard interface, the function func() is mapped to the binary symbol
265 * _posix_func(). The preferred mechanism for the remapping is a compiler
266 * #pragma. If the compiler does not provide such a #pragma, the header file
267 * defines a static function func() which calls the _posix_func() version;
268 * this has to be done instead of #define since POSIX specifies that an
269 * application can #undef the symbol and still be bound to the correct
270 * implementation. Unfortunately, the statics confuse lint so we fallback to
271 * #define in that case.
272 *
273 * NOTE: Support for the Draft 6 definitions is provided for compatibility
274 * only. New applications/libraries should use the standard definitions.
275 */
276
277 #if defined(__EXTENSIONS__) || defined(_REENTRANT) || \
278 (!defined(_STRICT_STDC) && !defined(__XOPEN_OR_POSIX)) || \
279 (_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
280
281 #if defined(__STDC__)
282
283 #if (_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
284
285 #ifdef __PRAGMA_REDEFINE_EXTNAME
286 #pragma redefine_extname ctime_r __posix_ctime_r
287 #pragma redefine_extname asctime_r __posix_asctime_r
288 extern char *asctime_r(const struct tm *_RESTRICT_KYWD, char *_RESTRICT_KYWD);
289 extern char *ctime_r(const time_t *, char *);
290 #else /* __PRAGMA_REDEFINE_EXTNAME */
291
292 extern char *__posix_asctime_r(const struct tm *_RESTRICT_KYWD,
293 char *_RESTRICT_KYWD);
294 extern char *__posix_ctime_r(const time_t *, char *);
295
296 #ifdef __lint
297
298 #define ctime_r __posix_ctime_r
299 #define asctime_r __posix_asctime_r
300
301 #else /* !__lint */
302
303 static char *
304 asctime_r(const struct tm *_RESTRICT_KYWD __tm, char *_RESTRICT_KYWD __buf)
305 {
306 return (__posix_asctime_r(__tm, __buf));
307 }
308
309 static char *
310 ctime_r(const time_t *__time, char *__buf)
311 {
312 return (__posix_ctime_r(__time, __buf));
313 }
314
315 #endif /* !__lint */
316 #endif /* __PRAGMA_REDEFINE_EXTNAME */
317
318 #else /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
319
320 extern char *asctime_r(const struct tm *, char *, int);
321 extern char *ctime_r(const time_t *, char *, int);
322
323 #endif /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
324
325 #else /* __STDC__ */
326
327 #if (_POSIX_C_SOURCE - 0 >= 199506L) || defined(_POSIX_PTHREAD_SEMANTICS)
328
329 #ifdef __PRAGMA_REDEFINE_EXTNAME
330 #pragma redefine_extname asctime_r __posix_asctime_r
331 #pragma redefine_extname ctime_r __posix_ctime_r
332 extern char *asctime_r();
333 extern char *ctime_r();
334 #else /* __PRAGMA_REDEFINE_EXTNAME */
335
336 extern char *__posix_asctime_r();
337 extern char *__posix_ctime_r();
338
339 #ifdef __lint
340
341 #define asctime_r __posix_asctime_r
342 #define ctime_r __posix_ctime_r
343
344 #else /* !__lint */
345
346 static char *
347 asctime_r(__tm, __buf)
348 struct tm *__tm;
349 char *__buf;
350 {
351 return (__posix_asctime_r(__tm, __buf));
352 }
353 static char *
354 ctime_r(__time, __buf)
355 time_t *__time;
356 char *__buf;
357 {
358 return (__posix_ctime_r(__time, __buf));
359 }
360
361 #endif /* !__lint */
362 #endif /* __PRAGMA_REDEFINE_EXTNAME */
363
364 #else /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
365
366 extern char *asctime_r();
367 extern char *ctime_r();
368
369 #endif /* (_POSIX_C_SOURCE - 0 >= 199506L) || ... */
370
371 #endif /* __STDC__ */
372
373 #endif /* defined(__EXTENSIONS__) || defined(_REENTRANT)... */
374
375
376 #if defined(_XPG7) || !defined(_STRICT_SYMBOLS)
377
378 #ifndef _LOCALE_T
379 #define _LOCALE_T
380 typedef struct _locale *locale_t;
381 #endif
382
383 #if defined(__STDC__)
384 extern size_t strftime_l(char *_RESTRICT_KYWD, size_t,
385 const char *_RESTRICT_KYWD, const struct tm *_RESTRICT_KYWD, locale_t);
386 #else /* __STDC__ */
387 extern size_t strftime_l();
388 #endif /* __STDC__ */
389
390 #endif /* defined(_XPG7) || !defined(_STRICT_SYMBOLS) */
391
392 #ifdef __cplusplus
393 }
394 #endif
395
396 #endif /* _TIME_H */