RepoMirrors
/
musl
mirror of git://git.musl-libc.org/musl
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
musl/include/time.h

167 lines
4.3 KiB
C
Raw Normal View History

initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#ifndef _TIME_H
#define _TIME_H
#ifdef __cplusplus
extern "C" {
#endif
default features: make musl usable without feature test macros the old behavior of exposing nothing except plain ISO C can be obtained by defining __STRICT_ANSI__ or using a compiler option (such as -std=c99) that predefines it. the new default featureset is POSIX with XSI plus _BSD_SOURCE. any explicit feature test macros will inhibit the default. installation docs have also been updated to reflect this change.
2012-09-08 03:13:55 +00:00
#include <features.h>
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
restore type of NULL to void * except when used in C++ programs unfortunately this eliminates the ability of the compiler to diagnose some dangerous/incorrect usage, but POSIX requires (as an extension to the C language, i.e. CX shaded) that NULL have type void *. plain C allows it to be defined as any null pointer constant. the definition 0L is preserved for C++ rather than reverting to plain 0 to avoid dangerous behavior in non-conforming programs which use NULL as a variadic sentinel. (it's impossible to use (void *)0 for C++ since C++ lacks the proper implicit pointer conversions, and other popular alternatives like the GCC __null extension seem non-conforming to the standard's requirements.)
2013-11-25 02:42:55 +00:00
#ifdef __cplusplus
use a common definition of NULL as 0L for C and C++ the historical mess of having different definitions for C and C++ comes from the historical C definition as (void *)0 and the fact that (void *)0 can't be used in C++ because it does not convert to other pointer types implicitly. however, using plain 0 in C++ exposed bugs in C++ programs that call variadic functions with NULL as an argument and (wrongly; this is UB) expect it to arrive as a null pointer. on 64-bit machines, the high bits end up containing junk. glibc dodges the issue by using a GCC extension __null to define NULL; this is observably non-conforming because a conforming application could observe the definition of NULL via stringizing and see that it is neither an integer constant expression with value zero nor such an expression cast to void. switching to 0L eliminates the issue and provides compatibility with broken applications, since on all musl targets, long and pointers have the same size, representation, and argument-passing convention. we could maintain separate C and C++ definitions of NULL (i.e. just use 0L on C++ and use (void *)0 on C) but after careful analysis, it seems extremely difficult for a C program to even determine whether NULL has integer or pointer type, much less depend in subtle, unintentional ways, on whether it does. C89 seems to have no way to make the distinction. on C99, the fact that (int)(void *)0 is not an integer constant expression, along with subtle VLA/sizeof semantics, can be used to make the distinction, but many compilers are non-conforming and give the wrong result to this test anyway. on C11, _Generic can trivially make the distinction, but it seems unlikely that code targetting C11 would be so backwards in caring which definition of NULL an implementation uses. as such, the simplest path of using the same definition for NULL in both C and C++ was chosen. the #undef directive was also removed so that the compiler can catch and give a warning or error on redefinition if buggy programs have defined their own versions of NULL prior to inclusion of standard headers.
2013-01-19 01:35:26 +00:00
#define NULL 0L
restore type of NULL to void * except when used in C++ programs unfortunately this eliminates the ability of the compiler to diagnose some dangerous/incorrect usage, but POSIX requires (as an extension to the C language, i.e. CX shaded) that NULL have type void *. plain C allows it to be defined as any null pointer constant. the definition 0L is preserved for C++ rather than reverting to plain 0 to avoid dangerous behavior in non-conforming programs which use NULL as a variadic sentinel. (it's impossible to use (void *)0 for C++ since C++ lacks the proper implicit pointer conversions, and other popular alternatives like the GCC __null extension seem non-conforming to the standard's requirements.)
2013-11-25 02:42:55 +00:00
#else
#define NULL ((void*)0)
#endif
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
fix another error from header cleanup, missing size_t in time.h
2011-02-15 20:25:31 +00:00
#define __NEED_size_t
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#define __NEED_time_t
#define __NEED_clock_t
add C11 timespec_get function, with associated time.h changes for C11 based on patch by Jens Gustedt for inclusion with C11 threads implementation, but committed separately since it's independent of threads.
2014-09-06 16:58:09 +00:00
#define __NEED_struct_timespec
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
#if defined(_POSIX_SOURCE) || defined(_POSIX_C_SOURCE) \
support _BSD_SOURCE feature test macro patch by Isaac Dunham. matched closely (maybe not exact) to glibc's idea of what _BSD_SOURCE should make visible.
2012-05-23 01:52:08 +00:00
|| defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) \
|| defined(_BSD_SOURCE)
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#define __NEED_clockid_t
#define __NEED_timer_t
#define __NEED_pid_t
more locale_t interfaces (string stuff) and header updates this should be everything except for some functions where the non-_l version isn't even implemented yet (mainly some non-ISO-C wcs* functions).
2012-02-07 02:51:02 +00:00
#define __NEED_locale_t
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
#endif
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#include <bits/alltypes.h>
improve handling of nonstandard fields in struct tm defining tm_gmtoff and tm_zone as macros was breaking some application code that used these names for its own purposes.
2013-06-07 13:54:45 +00:00
#if defined(_BSD_SOURCE) || defined(_GNU_SOURCE)
#define __tm_gmtoff tm_gmtoff
#define __tm_zone tm_zone
#endif
make brace placement in public header struct definitions consistent placing the opening brace on the same line as the struct keyword/tag is the style I prefer and seems to be the prevailing practice in more recent additions. these changes were generated by the command: find include/ arch/*/bits -name '*.h' \ -exec sed -i '/^struct [^;{]*$/{N;s/\n/ /;}' {} + and subsequently checked by hand to ensure that the regex did not pick up any false positives.
2016-07-03 18:40:11 +00:00
struct tm {
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
int tm_sec;
int tm_min;
int tm_hour;
int tm_mday;
int tm_mon;
int tm_year;
int tm_wday;
int tm_yday;
int tm_isdst;
long __tm_gmtoff;
const char *__tm_zone;
};
clock_t clock (void);
time_t time (time_t *);
double difftime (time_t, time_t);
time_t mktime (struct tm *);
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
size_t strftime (char *__restrict, size_t, const char *__restrict, const struct tm *__restrict);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
struct tm *gmtime (const time_t *);
struct tm *localtime (const time_t *);
char *asctime (const struct tm *);
char *ctime (const time_t *);
add C11 timespec_get function, with associated time.h changes for C11 based on patch by Jens Gustedt for inclusion with C11 threads implementation, but committed separately since it's independent of threads.
2014-09-06 16:58:09 +00:00
int timespec_get(struct timespec *, int);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
fix the type of CLOCKS_PER_SEC to match new clock_t type originally it was right on 32-bit archs and wrong on 64-bit, but after recent changes it was wrong everywhere. with this commit, it's now right everywhere.
2013-06-08 15:40:27 +00:00
#define CLOCKS_PER_SEC 1000000L
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
add C11 timespec_get function, with associated time.h changes for C11 based on patch by Jens Gustedt for inclusion with C11 threads implementation, but committed separately since it's independent of threads.
2014-09-06 16:58:09 +00:00
#define TIME_UTC 1
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
#if defined(_POSIX_SOURCE) || defined(_POSIX_C_SOURCE) \
support _BSD_SOURCE feature test macro patch by Isaac Dunham. matched closely (maybe not exact) to glibc's idea of what _BSD_SOURCE should make visible.
2012-05-23 01:52:08 +00:00
|| defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) \
|| defined(_BSD_SOURCE)
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
size_t strftime_l (char * __restrict, size_t, const char * __restrict, const struct tm * __restrict, locale_t);
more locale_t interfaces (string stuff) and header updates this should be everything except for some functions where the non-_l version isn't even implemented yet (mainly some non-ISO-C wcs* functions).
2012-02-07 02:51:02 +00:00
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
struct tm *gmtime_r (const time_t *__restrict, struct tm *__restrict);
struct tm *localtime_r (const time_t *__restrict, struct tm *__restrict);
char *asctime_r (const struct tm *__restrict, char *__restrict);
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
char *ctime_r (const time_t *, char *);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
void tzset (void);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
make brace placement in public header struct definitions consistent placing the opening brace on the same line as the struct keyword/tag is the style I prefer and seems to be the prevailing practice in more recent additions. these changes were generated by the command: find include/ arch/*/bits -name '*.h' \ -exec sed -i '/^struct [^;{]*$/{N;s/\n/ /;}' {} + and subsequently checked by hand to ensure that the regex did not pick up any false positives.
2016-07-03 18:40:11 +00:00
struct itimerspec {
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
struct timespec it_interval;
struct timespec it_value;
};
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
#define CLOCK_REALTIME 0
#define CLOCK_MONOTONIC 1
#define CLOCK_PROCESS_CPUTIME_ID 2
#define CLOCK_THREAD_CPUTIME_ID 3
add clock id macros for a number of new(ish) Linux-specific clocks arguably CLOCK_MONOTONIC should be redirected to CLOCK_BOOTTIME with a fallback for old kernels that don't support it, since Linux's CLOCK_BOOTTIME semantics seem to match the spirit of the POSIX requirements for CLOCK_MONOTONIC better than Linux's version of CLOCK_MONOTONIC does. however, this is a change that would require further discussion and research, so for now, I'm simply making them all available.
2013-06-08 15:42:52 +00:00
#define CLOCK_MONOTONIC_RAW 4
fix clockid macro names in time.h, reported by Paul Schutte
2013-10-07 13:28:03 +00:00
#define CLOCK_REALTIME_COARSE 5
#define CLOCK_MONOTONIC_COARSE 6
add clock id macros for a number of new(ish) Linux-specific clocks arguably CLOCK_MONOTONIC should be redirected to CLOCK_BOOTTIME with a fallback for old kernels that don't support it, since Linux's CLOCK_BOOTTIME semantics seem to match the spirit of the POSIX requirements for CLOCK_MONOTONIC better than Linux's version of CLOCK_MONOTONIC does. however, this is a change that would require further discussion and research, so for now, I'm simply making them all available.
2013-06-08 15:42:52 +00:00
#define CLOCK_BOOTTIME 7
#define CLOCK_REALTIME_ALARM 8
#define CLOCK_BOOTTIME_ALARM 9
add CLOCK_TAI (and CLOCK_SGI_CYCLE) clock ids to time.h added in linux-v3.10 commit 1ff3c9677bff7e468e0c487d0ffefe4e901d33f4
2013-07-24 21:29:17 +00:00
#define CLOCK_SGI_CYCLE 10
#define CLOCK_TAI 11
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
#define TIMER_ABSTIME 1
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
int nanosleep (const struct timespec *, struct timespec *);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
int clock_getres (clockid_t, struct timespec *);
int clock_gettime (clockid_t, struct timespec *);
int clock_settime (clockid_t, const struct timespec *);
int clock_nanosleep (clockid_t, int, const struct timespec *, struct timespec *);
int clock_getcpuclockid (pid_t, clockid_t *);
struct sigevent;
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
int timer_create (clockid_t, struct sigevent *__restrict, timer_t *__restrict);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
int timer_delete (timer_t);
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
int timer_settime (timer_t, int, const struct itimerspec *__restrict, struct itimerspec *__restrict);
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
int timer_gettime (timer_t, struct itimerspec *);
int timer_getoverrun (timer_t);
fix various header namespace issues under feature-test-macro control reported and changes suggested by Daniel Sabogal.
2016-10-20 21:20:01 +00:00
extern char *tzname[2];
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
#endif
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
fix places where _BSD_SOURCE failed to yield a superset of _XOPEN_SOURCE the vast majority of these failures seem to have been oversights at the time _BSD_SOURCE was added, or perhaps shortly afterward. the one which may have had some reason behind it is omission of setpgrp from the _BSD_SOURCE feature profile, since the standard setpgrp interface conflicts with a legacy (pre-POSIX) BSD interface by the same name. however, such omission is not aligned with our general policy in this area (for example, handling of similar _GNU_SOURCE cases) and should not be preserved.
2014-09-10 16:27:33 +00:00
#if defined(_XOPEN_SOURCE) || defined(_BSD_SOURCE) || defined(_GNU_SOURCE)
use restrict everywhere it's required by c99 and/or posix 2008 to deal with the fact that the public headers may be used with pre-c99 compilers, __restrict is used in place of restrict, and defined appropriately for any supported compiler. we also avoid the form [restrict] since older versions of gcc rejected it due to a bug in the original c99 standard, and instead use the form *restrict.
2012-09-07 02:44:55 +00:00
char *strptime (const char *__restrict, const char *__restrict, struct tm *__restrict);
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
extern int daylight;
extern long timezone;
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
extern int getdate_err;
fix various errors in function signatures/prototypes found by nsz
2011-09-14 01:09:35 +00:00
struct tm *getdate (const char *);
more header cleanup and conformance fixes - locale.h, time.h
2011-02-15 01:45:37 +00:00
#endif
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
fix feature test macros in time.h stime is not _XOPEN_SOURCE, and some functions were missing with _BSD_SOURCE..
2012-06-13 18:43:16 +00:00
#if defined(_GNU_SOURCE) || defined(_BSD_SOURCE)
fix const-correctness of argument to stime it's unclear what the historical signature for this function was, but semantically, the argument should be a pointer to const, and this is what glibc uses. correct programs should not be using this function anyway, so it's unlikely to matter.
2014-01-07 08:02:14 +00:00
int stime(const time_t *);
add timegm function (inverse of gmtime), nonstandard
2012-06-13 18:41:52 +00:00
time_t timegm(struct tm *);
#endif
legacy junk compatibility grab-bag - add the rest of the junk traditionally in sys/param.h - add prototypes for some nonstandard functions - add _GNU_SOURCE to their source files so the compiler can check proto
2012-04-18 16:22:24 +00:00
add time64 symbol name redirects to public headers, under arch control a _REDIR_TIME64 macro is introduced, which the arch's alltypes.h is expected to define, to control redirection of symbol names for interfaces that involve time_t and derived types. this ensures that object files will only be linked to libc interfaces matching the ABI whose headers they were compiled against. along with time32 compat shims, which will be introduced separately, the redirection also makes it possible for a single libc (static or shared) to be used with object files produced with either the old (32-bit time_t) headers or the new ones after 64-bit time_t switchover takes place. mixing of such object files (or shared libraries) in the same program will also be possible, but must be done with care; ABI between libc and a consumer of the libc interfaces is guaranteed to match by the the symbol name redirection, but pairwise ABI between consumers of libc that define interfaces between each other in terms of time_t is not guaranteed to match. this change adds a dependency on an additional "GNU C" feature to the public headers for existing 32-bit archs, which is generally undesirable; however, the feature is one which glibc has depended on for a long time, and thus which any viable alternative compiler is going to need to provide. 64-bit archs are not affected, nor will future 32-bit archs be, regardless of whether they are "new" on the kernel side (e.g. riscv32) or just newly-added (e.g. a new sparc or xtensa port). the same applies to newly-added ABIs for existing machine-level archs.
2019-07-31 19:24:58 +00:00
#if _REDIR_TIME64
__REDIR(time, __time64);
__REDIR(difftime, __difftime64);
__REDIR(mktime, __mktime64);
__REDIR(gmtime, __gmtime64);
__REDIR(localtime, __localtime64);
__REDIR(ctime, __ctime64);
__REDIR(timespec_get, __timespec_get_time64);
#if defined(_POSIX_SOURCE) || defined(_POSIX_C_SOURCE) \
|| defined(_XOPEN_SOURCE) || defined(_GNU_SOURCE) \
|| defined(_BSD_SOURCE)
__REDIR(gmtime_r, __gmtime64_r);
__REDIR(localtime_r, __localtime64_r);
__REDIR(ctime_r, __ctime64_r);
__REDIR(nanosleep, __nanosleep_time64);
__REDIR(clock_getres, __clock_getres_time64);
__REDIR(clock_gettime, __clock_gettime64);
__REDIR(clock_settime, __clock_settime64);
__REDIR(clock_nanosleep, __clock_nanosleep_time64);
__REDIR(timer_settime, __timer_settime64);
__REDIR(timer_gettime, __timer_gettime64);
#endif
#if defined(_GNU_SOURCE) || defined(_BSD_SOURCE)
__REDIR(stime, __stime64);
__REDIR(timegm, __timegm_time64);
#endif
#endif
initial check-in, version 0.5.0
2011-02-12 05:22:29 +00:00
#ifdef __cplusplus
}
#endif
#endif