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

DIAGNOSTICS
     Upon successful completion, times returns the elapsed real time, in clock
     ticks, 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 indicate the error.




                                                                        Page 1

times(2)                                                              times(2)























































                                                                        Page 2