NAME    [Toc]    [Back]

     time - get time of day

SYNOPSIS    [Toc]    [Back]

     #include <time.h>

     time_t
     time(time_t *tloc);

DESCRIPTION    [Toc]    [Back]

     The time() function returns the value  of  time  in  seconds
since 0 hours, 0
     minutes,  0  seconds, January 1, 1970, Coordinated Universal
Time (UTC).

     A copy of the time value may be saved to the area  indicated
by the pointer
 tloc.  If tloc is a null pointer, no value is stored.

     Upon  successful  completion,  time()  returns  the value of
time.  Otherwise
     a value of (time_t)-1 is returned and  the  global  variable
errno is set to
     indicate the error.

ERRORS    [Toc]    [Back]

     The following error codes may be set in errno:

     [EFAULT]      An argument address referenced invalid memory.

SEE ALSO    [Toc]    [Back]

     gettimeofday(2), ctime(3)

HISTORY    [Toc]    [Back]

     A time() function appeared in Version 2 AT&T UNIX  and  used
to return time
     in  sixtieths of a second in 32 bits, which was to guarantee
a crisis every
 2.26 years.  Since the Version 6 AT&T UNIX time()  scale
was changed
     to  seconds extending the pre-crisis stagnation period up to
a total of 68
     years.

OpenBSD      3.6                           June      4,      1993