time(2)

NAME

     time, stime - get/set date and time

SYNOPSIS

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

     time_t time(time_t *tp)
     int stime(time_t *tp)

DESCRIPTION

     The system's notion of the current Greenwich time is  obtained  with  the
     time call, and set with the stime call.  The time is expressed in seconds
     since midnight (0 hour), January 1, 1970.  The time is both  returned  by
     time  and  stored  in the variable pointed to by tp unless tp is the null
     pointer.

     Stime obtains the time to set from the variable pointed to by tp.

     Only the super-user may set the time of day.

RETURN

     A 0 return value from stime indicates  that  the  call  succeeded.   Time
     returns  the  current  time  on  success.  A -1 return value indicates an
     error occurred, and in this case an error code is stored into the  global
     variable errno.

ERRORS

     The following error codes may be set in errno:

     [EFAULT]       The tp address referenced invalid memory.

     [EPERM]        A user other than the  super-user  attempted  to  set  the
                    time.

SEE ALSO

     date(1), ctime(3).