TIME(2) System Calls TIME(2)
NAME
time - get time
SYNOPSIS
#include <sys/types.h>
#include <time.h>
time_t time(
time_t *tloc);
DESCRIPTION
The
time() function 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. If
tloc points to an illegal address,
time() fails and its actions are undefined.
RETURN VALUES
Upon successful completion,
time() returns the value of time.
Otherwise,
(time_t)-1 is returned and
errno is set to indicate the
error.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------+
|Interface Stability | Standard |
+--------------------+-------------------+
|MT-Level | Async-Signal-Safe |
+--------------------+-------------------+
SEE ALSO
stime(2),
ctime(3C),
attributes(7),
standards(7) December 28, 1996 TIME(2)
