time.2 (2010 09)

t
time(2) time(2)
NAME
time - get time
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)−1is
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.
SEE ALSO
date(1), gettimeofday(2), stime(2), ctime(3C), strftime(3C).
STANDARDS CONFORMANCE
time(): AES, SVID2, SVID3, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1