time(2)                    DG/UX 4.30                     time(2)



     NAME
          time - Get system time.

     SYNOPSIS
          #include <sys/types.h>

          time_t   time  (tloc)
          time_t *                tloc;

     PARAMETERS
          tloc           (time_t) NULL or address of a time_t 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.

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


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

     SEE ALSO
          The related manual section:  stime(2).













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