time(2)                          DG/UX 5.4.2                         time(2)


NAME
       time - get system time

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

       timet time (tloc)
       timet * tloc;

   where:
       tloc      NULL or address of a timet to be set to the current system
                 time

DESCRIPTION
       Time returns the system's notion of the current Greenwich time as the
       system call's return value.

       If tloc is not NULL, the current time is also stored in the (time_t)
       at the location specified by tloc.

       The time value returned is Greenwich time expressed in seconds since
       midnight January 1, 1970.

ACCESS CONTROL
       None.

RETURN VALUE
       current time   Completed successfully.

       -1             An error occurred.  errno is set to indicate the
                      error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EFAULT    Time will fail if tloc points to an illegal address.

SEE ALSO
       date(1), stime(2).

















Licensed material--property of copyright holder(s)                         1