NAME

time − get time

SYNOPSIS

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

time_t time(time_t ∗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 (time_t)−1 is returned and errno is set to indicate the error.