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 ter-
     minated 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.

     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.

RESULT
     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 indicate the error.

SEE ALSO
     time(1), timex(1), exec(2), fork(2), time(2), wait(2), waitid(2).




Page 1                       Reliant UNIX 5.44                Printed 11/98