TIME(2)                              SysV                              TIME(2)



NAME
     time - Get time

SYNOPSIS
     #include <time.h>

     time_t time (tloc)
     time_t *tloc;

DESCRIPTION
     The time function returns the time in seconds since the epoch. The epoch
     is referenced to 00:00:00 1 Jan 1970 UTC (Coordinated Universal Time).

     tloc points to the location where the return value is stored. When this
     argument is a null pointer, no value is stored.

WARNING
     time fails and its actions are undefined if tloc points to an illegal
     address.

DIAGNOSTICS
     Upon successful completion, the time function returns the value of time
     in seconds since the epoch.  Otherwise, the value ((time_t) - 1) is
     returned.

SEE ALSO
     clock(3C), gettimeofday(2), stime(2)