time(2)                                                             time(2)


   NAME
         time - get time

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

         timet time(timet *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), 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 (timet)-1 is returned and errno is set to
         indicate the error.


























   8/91                                                                 Page 1