SYNOPSIS
#include <time.h>
time_t time(time_t *tloc);
DESCRIPTION
time()
returns the value of time in seconds since the Epoch.
If
tloc
is not a null pointer,
the return value is also assigned to the object to which it points.
RETURN VALUE
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.
ERRORS
- [EFAULT]
time()
fails if
tloc
points to an illegal address.
The reliable detection of this error is implementation dependent.
STANDARDS CONFORMANCE
time(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C