This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: The time(2) man page conflicts with glibc
- From: "Michael Kerrisk (man-pages)" <mtk dot manpages at gmail dot com>
- To: Paul Eggert <eggert at cs dot ucla dot edu>, Zack Weinberg <zackw at panix dot com>
- Cc: mtk dot manpages at gmail dot com, "H.J. Lu" <hjl dot tools at gmail dot com>, Andreas Schwab <schwab at suse dot de>, libc-alpha <libc-alpha at sourceware dot org>, linux-man <linux-man at vger dot kernel dot org>, Mike Frysinger <vapier at gentoo dot org>
- Date: Thu, 17 Dec 2015 06:53:17 +0100
- Subject: Re: The time(2) man page conflicts with glibc
- Authentication-results: sourceware.org; auth=none
- References: <CAMe9rOoJLk8VzyJKmkOvbmBxhCj4mVA2huYtHJsdxpatbkgJ1g at mail dot gmail dot com> <mvmegen94qs dot fsf at hawking dot suse dot de> <CAMe9rOr_Ydg5Nr7aV8vS0vYEFehSwFBuxrMAnCFXyyVoTF4vJQ at mail dot gmail dot com> <5671696B dot 3070203 at gmail dot com> <CAMe9rOqsxCEia7OWqzJ-HzZWCra5BTyYqt4japjZTw0pY=fugw at mail dot gmail dot com> <56717032 dot 7000007 at gmail dot com> <CAKCAbMjrKfsT7P=Q=+1zWC68552aK=ciod0HYk3=HWMvkYW26w at mail dot gmail dot com> <5671EE36 dot 1000402 at cs dot ucla dot edu>
Hello Paul,
On 12/17/2015 12:05 AM, Paul Eggert wrote:
> Zack Weinberg wrote:
>> When `t` is NULL, the call cannot fail.
>
> This doesn't make it clear what happens when the time_t values roll around after
> the year 2038, on 32-bit time_t hosts. How about adding some further text along
> the following lines?
>
> In GNU/Linux time(NULL) cannot fail with errno == EOVERFLOW, even on ABIs where
> time_t is a signed 32-bit integer and when the clock ticks past the time 2**31
> (2038-01-19 03:14:08 UTC, ignoring leap seconds). Instead, the behavior is
> undefined when the system time is out of time_t range. Applications intended to
> run after 2038 should use ABIs with time_t wider than 32 bits.
> .
Seems reasonable. I've added something close that. Thanks!
Cheers,
Michael
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/