NAME

time − get time

SYNOPSIS

#include <time.h>

time_t time (tloc)
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. 

ERRORS

­[EFAULT] Time will fail if tloc points to an illegal address.  The reliable detection of this error will be implementation dependent. 

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. 

SEE ALSO

date(1), gettimeofday(2), stime(2), ctime(3C), strftime(3C). 

STANDARDS CONFORMANCE

time: SVID2, XPG2, XPG3, POSIX.1, FIPS 151-1, ANSI C

Hewlett-Packard Company  —  HP-UX Release 7.0: Sept 1989