times(2) — sys5



TIMES(2)        DOMAIN/IX Reference Manual (SYS5)        TIMES(2)



NAME
     times - get process and child process times

USAGE
     #include <sys/types.h>
     #include <sys/times.h>

     long times (buffer)
     struct tms *buffer;

DESCRIPTION
     Times fills the structure pointed to by buffer with time-
     accounting information.  The following are the contents of
     this structure:

     struct    tms {
          time_t      tms_utime;
          time_t      tms_stime;
          time_t      tms_cutime;
          time_t      tms_cstime;
     };

     This information comes from the calling process and each
     terminated child process for which it has executed a wait.
     All times are in 1/60ths of a second.

     Tms_utime is the amount of CPU time used while executing
     instructions in the user space of the calling process.

     Tms_stime is the amount of CPU time used by the system on
     behalf of the calling process.

     Tms_cutime is the sum of the tms_utimes and tms_cutimes of
     the child processes.

     Tms_cstime is the sum of the tms_stimes and tms_cstimes of
     the child processes.

     System time is not differentiated from user time on the
     DOMAIN/IX system, because of the embedded nature of the ker-
     nel.  System time is reported as zero.

RETURN VALUE
     Upon successful completion, times returns the elapsed real
     time, in 1/60ths of a second, since an arbitrary point in
     the past (e.g., system start-up time).  This point does not
     change from one invocation of times to another.  If times
     fails, it returns -1 and sets errno to indicate the error.

ERRORS
     [EFAULT]  Times will fail if buffer points to an illegal
               address.



Printed 5/10/85                                           TIMES-1



TIMES(2)        DOMAIN/IX Reference Manual (SYS5)        TIMES(2)



RELATED INFORMATION
     exec(2), fork(2), time(2), wait(2)





















































TIMES-2                                           Printed 5/10/85

Museum