TIME(2)              INTERACTIVE UNIX System              TIME(2)



          NAME
               time - get time

          SYNOPSIS
               #include <sys/types.h>

               time_t time (tloc)
               long *tloc;

          DESCRIPTION
               The time system call returns the value of time in seconds
               since 00:00:00 Greenwich Mean Time (GMT), January 1, 1970.

               If tloc is non-zero, the return value is also stored in the
               location to which tloc points.

          SEE ALSO
               stime(2).

          DIAGNOSTICS
               Upon successful completion, time returns the value of time.
               Otherwise, a value of -1 is returned, and errno is set to
               indicate the error.

          WARNING
               The time system call fails and its actions are undefined if
               tloc points to an illegal address.




























          Rev. C Software Development Set                            Page 1