times(2)                         UNIX System V                         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.  (On a 3B2
      Computer clock ticks occur 100 times per second.)

      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., 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


10/89                                                                    Page 1

times(2)                         UNIX System V                         times(2)


      indicate the error.





















































Page 2                                                                    10/89