time(2)                                                                time(2)


NAME
     time - get time

SYNOPSIS
     #include <sys/types.h>
     #include <time.h>

     time_t time(time_t *tloc);

DESCRIPTION
     time returns the value of time in seconds since 00:00:00 UTC, January 1,
     1970.

     If tloc is non-zero, the return value is also stored in the location to
     which tloc points.

SEE ALSO
     stime(2), gettimeofday(3B), ctime(3C)

NOTES
     time fails and its actions are undefined if tloc points to an illegal
     address.

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


                                                                        Page 1