times(2)                                                 times(2)



     NAME
          times - get process and child process times

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

          clock_t 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 {
                 clock_t    tms_utime;
                 clock_t    tms_stime;
                 clock_t    tms_cutime;
                 clock_t    tms_cstime;
          };

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

          tms_utime CPU time used while executing instructions in the
                    user space of the calling process.

          tms_stime CPU time used by the system on behalf of the cal-
                    ling process.

          tms_cutime
                    sum of the tms_utimes and tms_cutimes of the child
                    processes.

          tms_cstime
                    sum of the tms_stimes and tms_cstimes of the child
                    processes.

     RETURN VALUE
          Upon successful completion, times returns the elapsed real
          time, in 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, a -1 is returned and errno is set to indicate the er-
          ror.

     ERRORS
          times will fail if

          [EFAULT]  buffer points to an illegal address.



     April, 1990                                                     1

     times(2)                                                 times(2)



     SEE ALSO
          exec(2), fork(2), time(2), wait(2).





















































     2                                                     April, 1990