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, Janu-
     ary 1, 1970.

     If tloc is non-zero, the result is also stored in the location to
     which tloc points.

NOTES
     time() fails and its actions are undefined if tloc points to an ille-
     gal address.

RESULT
     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.

SEE ALSO
     stime(2), ctime(3C).




























Page 1                       Reliant UNIX 5.44                Printed 11/98