time(2) 							   System Calls 							   time(2)

NAME

       time - get time

SYNOPSIS

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

       time_t time(time_t *tloc);

DESCRIPTION

       The time() function 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. If tloc points to an illegal address, time()
       fails and its actions are undefined.

RETURN VALUES

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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Async-Signal-Safe 	   |
       +-----------------------------+-----------------------------+

SEE ALSO

       stime(2), ctime(3C), attributes(5), standards(5)

SunOS 5.10							    28 Dec 1996 							   time(2)