TIME(2-POSIX)       RISC/os Reference Manual        TIME(2-POSIX)



NAME
     time - get system time

SYNOPSIS
     #include <time.h>

     timet time (tloc)
     timet *tloc;

DESCRIPTION
     time returns the value of time in seconds since the Epoch
     (00:00:00 GMT, January 1, 1970).

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

RETURN VALUES
     Upon successful completion, time returns the value of time.
     Otherwise, a value of ((time_t) -1) is returned.

DIAGNOSTICS
     time will receive a SIGBUS signal if tloc points to an ille-
     gal address.

SEE ALSO
     stime(2).





























                         Printed 1/15/91                   Page 1