


      TIMES(2)                    (UNIX 5.0)                   TIMES(2)



      NAME
           times - get process and child process times

      SYNTAX
           #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 is this contents of
           the 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 of
           its terminated child processes for which it has executed a
           wait.  All times are milliseconds (thousandths of a second).

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

           Tms_stime is the CPU time used by the associated User
           Monitor process on behalf of the calling process, not whole
           operating system time.

           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.

           If buffer points to an illegal address, times fails and
           returns error 14 (EFAULT - bad address).  [DEFAULT]

      RETURN VALUE
           Upon successful completion, times returns the elapsed real
           time, in milliseconds, 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 error.







      Page 1                                         (73 A2 02MTA REV1)



