times(2)                         DG/UX 5.4.2                        times(2)


NAME
       times - get process and child process times

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

       clockt   times (buffer)
       struct tms  * buffer;

   where:
       buffer    The address of a structure into which the times are to be
                 put

DESCRIPTION
       The times system call fills in the structure pointed to by buffer
       with time accounting information for the calling process and each of
       its terminated child processes for which it has executed a wait.

       All times are defined in units of 1/{CLK_TCK} of a second.  See
       sysconf(2).

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

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

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

       The value of tmssutime is the sum of the tmsstime and tmscstime of
       the child processes.

ACCESS CONTROL
       The argument buffer must point to an area of the calling process's
       address space that is valid and has write access.

RETURN VALUE
       Upon successful completion, times returns the elapsed real-time, in
       [CLK_TCK]ths of a second, since an arbitrary point in the past (e.g.,
       system start-up time).  This point does not change from one
       invocation of times to another.  Hence, a single value returned from
       this call is not meaningful; only the difference between values
       returned at different times is meaningful.

       If an error occurs, -1 is returned and errno is set to indicate the
       error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EFAULT    Buffer points to an illegal address.




Licensed material--property of copyright holder(s)                         1

times(2)                         DG/UX 5.4.2                        times(2)


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























































Licensed material--property of copyright holder(s)                         2