From 39ad46695fb18b00d6164849cc6327e945fc6a93 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Fri, 9 Mar 2018 08:57:45 +0100 Subject: [PATCH] time.7: Mention clock_gettime()/clock_settime() rather than [gs]ettimeofday() gettimeofday() is declared obsolete by POSIX. Mention instead the modern APIs for working with the realtime clock. See https://bugzilla.kernel.org/show_bug.cgi?id=199049 Reported-by: Enrique Garcia Signed-off-by: Michael Kerrisk --- man7/time.7 | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/man7/time.7 b/man7/time.7 index a9282c45b..7b84c2d44 100644 --- a/man7/time.7 +++ b/man7/time.7 @@ -130,15 +130,18 @@ UNIX systems represent time in seconds since the .PP A program can determine the .I "calendar time" -using -.BR gettimeofday (2), -which returns time (in seconds and microseconds) that have +via the +.BR clock_gettime (2) +.BR CLOCK_REALTIME +clock, +which returns time (in seconds and nanoseconds) that have elapsed since the Epoch; .BR time (2) provides similar information, but only with accuracy to the nearest second. The system time can be changed using -.BR settimeofday (2). +.BR clock_settime (2). +.\" .SS Broken-down time Certain library functions use a structure of type