TIME(2,L)                   AIX Technical Reference                   TIME(2,L)



-------------------------------------------------------------------------------
time



PURPOSE

Gets the time.

SYNTAX

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




                time_t time ((time_t *) 0)  time_t time (tloc)
                                            time_t *tloc;



DESCRIPTION

The time system call returns the current time in seconds since 00:00:00 GMT,
January 1, 1970.

If the tloc parameter is nonzero, the time is also stored in the location to
which the tloc parameter points.

RETURN VALUE

Upon successful completion, the current time is returned.  If the time system
call fails, a -1 is returned and errno is set to indicate the error.

ERROR CONDITIONS

EFAULT  The tloc parameter points to a location outside of the process's
        allocated address space.

RELATED INFORMATION

In this book:  "stime."












Processed November 7, 1990         TIME(2,L)                                  1