Hash :
7933a2a4
Author :
Date :
2024-07-20T13:44:43
doc: Update status of functions that are removed from POSIX:2024. * doc/pastposix-functions/_longjmp.texi: Moved here fromdoc/posix-functions/. * doc/pastposix-functions/_setjmp.texi: Likewise. * doc/pastposix-functions/_tolower.texi: Likewise. * doc/pastposix-functions/_toupper.texi: Likewise. * doc/pastposix-functions/fattach.texi: Likewise. * doc/pastposix-functions/fdetach.texi: Likewise. * doc/pastposix-functions/ftw.texi: Likewise. * doc/pastposix-functions/getitimer.texi: Likewise. * doc/pastposix-functions/getmsg.texi: Likewise. * doc/pastposix-functions/getpmsg.texi: Likewise. * doc/pastposix-functions/gets.texi: Likewise. * doc/pastposix-functions/gettimeofday.texi: Likewise. * doc/pastposix-functions/ioctl.texi: Likewise. * doc/pastposix-functions/isascii.texi: Likewise. * doc/pastposix-functions/isastream.texi: Likewise. * doc/pastposix-functions/posix_trace_*.texi: Likewise. * doc/pastposix-functions/pthread_getconcurrency.texi: Likewise. * doc/pastposix-functions/pthread_setconcurrency.texi: Likewise. * doc/pastposix-functions/putmsg.texi: Likewise. * doc/pastposix-functions/putpmsg.texi: Likewise. * doc/pastposix-functions/setitimer.texi: Likewise. * doc/pastposix-functions/setpgrp.texi: Likewise. * doc/pastposix-functions/sighold.texi: Likewise. * doc/pastposix-functions/sigignore.texi: Likewise. * doc/pastposix-functions/siginterrupt.texi: Likewise. * doc/pastposix-functions/sigpause.texi: Likewise. * doc/pastposix-functions/sigrelse.texi: Likewise. * doc/pastposix-functions/sigset.texi: Likewise. * doc/pastposix-functions/tempnam.texi: Likewise. * doc/pastposix-functions/toascii.texi: Likewise. * doc/pastposix-functions/ulimit.texi: Likewise. * doc/pastposix-functions/utime.texi: Likewise. * doc/gnulib.texi (Function Substitutes): Don't include them here. (Legacy Function Substitutes): Include them here.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42
@node gettimeofday
@section @code{gettimeofday}
@findex gettimeofday
Removed in POSIX.1-2024.
POSIX.1-2017 specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/gettimeofday.html}
Gnulib module: gettimeofday
Portability problems fixed by Gnulib:
@itemize
@item
This function is missing on some platforms:
MSVC 14.
@item
This function is declared with a nonstandard function prototype (only one
argument, or ``...'' after the first argument) on some platforms.
@item
On some platforms, the second argument has type @code{struct
timezone*} rather than @code{void *}, making it an error to redeclare
the function with the POSIX signature:
glibc.
However, rather than penalize these systems with a replacement
function, gnulib defines @code{GETTIMEOFDAY_TIMEZONE} to the
appropriate type for use in avoiding a compiler warning if assigning
@code{gettimeofday} to a function pointer.
@item
This function has only a precision of 15.6 milliseconds on some platforms:
mingw.
@end itemize
Portability problems not fixed by Gnulib:
@itemize
@item
Behavior is non-portable if the second argument to @code{gettimeofday}
is not @code{NULL}.
@item
This function is removed in POSIX.1-2024.
Use the Gnulib module @code{gettime} or @code{timespec_get} instead.
(POSIX recommends to use the function @code{clock_gettime}, but there is
no corresponding Gnulib module for it yet.)
@end itemize