times(2)                                                           times(2)


   NAME
         times - get process and child process times

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

         clockt times(struct tms *buffer);

   DESCRIPTION
         times fills the tms structure pointed to by buffer with time-
         accounting information.  The tms structure is defined in
         <sys/times.h> as follows:

               struct    tms {
                    clockt    tmsutime;
                    clockt    tmsstime;
                    clockt    tmscutime;
                    clockt    tmscstime;
               };

         This information comes from the calling process and each of its
         terminated child processes for which it has executed a wait routine.
         All times are reported in clock ticks per second.  Clock ticks are a
         system-dependent parameter.  The specific value for an implementation
         is defined by the variable CLKTCK, found in the include file
         limits.h.

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

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

         tmscutime is the sum of the tmsutime and the tmscutime of the
         child processes.

         tmscstime is the sum of the tmsstime and the tmscstime of the
         child processes.

         times fails if:

         EFAULT        buffer points to an illegal address.

   SEE ALSO
         exec(2), fork(2), time(2), wait(2), waitid(2), waitpid(3C).
         time(1), timex(1) in the User's Reference Manual.

   DIAGNOSTICS
         Upon successful completion, times returns the elapsed real time, in
         clock ticks per second, from an arbitrary point in the past (e.g.,


   8/91                                                                 Page 1

   times(2)                                                           times(2)


         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 2                                                                 8/91