Index: lib/libc/gen/time.3 =================================================================== --- lib/libc/gen/time.3 +++ lib/libc/gen/time.3 @@ -32,7 +32,7 @@ .\" @(#)time.3 8.1 (Berkeley) 6/4/93 .\" $FreeBSD$ .\" -.Dd March 4, 2022 +.Dd April 2, 2022 .Dt TIME 3 .Os .Sh NAME @@ -49,7 +49,7 @@ .Fn time function returns the value of time in seconds since 0 hours, 0 minutes, -0 seconds, January 1, 1970, Coordinated Universal Time. +0 seconds, January 1, 1970, Coordinated Universal Timei (UTC). If an error occurs, .Fn time returns the value @@ -73,12 +73,23 @@ The .Nm function conforms to -.St -p1003.1-2001 . +.St -p1003.1-2008 . .Sh HISTORY A .Fn time -function appeared in -.At v6 . +system call first appeared in +.At v1 . +That version counted time in sixtieths of a second with a 32-bit return value, +ensuring an integer overflow crisis every 2.26 years. +In +.At v6 +the granularity of the return value was reduced to whole seconds, +delaying the aforementioned crisis until 2038. +In +.Bx 4.1c +the function was moved out of the kernel into the C standard library and +reimplemented with +.Xr gettimeofday 2 . .Sh BUGS Neither .St -isoC-99