time(2)								       time(2)

NAME    [Toc]    [Back]

     time - get	time

SYNOPSIS    [Toc]    [Back]

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

     time_t time(time_t	*tloc);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

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

NOTES    [Toc]    [Back]

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

DIAGNOSTICS    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111