time(2)                                                   time(2)



     NAME
          time - get time

     SYNOPSIS
          #include <time.h>

          time_t time((long*)0)

          time_t time(tloc)
          time_t *tloc;

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

          If tloc (taken as an integer) is nonzero, the return value
          is also stored in the location to which tloc points.

     RETURN VALUE
          On successful completion, time returns the value of time.
          Otherwise, a value of -1 is returned and errno is set to in-
          dicate the error.

     ERRORS
          time will fail if the following is true

          [EFAULT]  tloc points to an illegal address.

     SEE ALSO
          date(1), gettimeofday(2), stime(2), ctime(3).

























     April, 1990                                                     1