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 contents of this structure
     follow:

     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 calling
          process.

     tms_cutime
          sum of the tms_utime and tms_cutime options of the
          child processes.

     tms_cstime
          sum of the tms_stime and tms_cstime options of the
          child processes.

STATUS MESSAGES AND VALUES
     Upon successful completion, times returns the elapsed real
     time, in 60ths of a second, since an arbitrary point in the
     past (for example, 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.

     The times command will fail if:




January 1992                                                    1

times(2)                                                 times(2)



     [EFAULT]
          buffer points to an illegal address.

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


















































2                                                    January 1992