time(2)                          UNIX System V                          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.




























10/89                                                                    Page 1