NAME

times − get process and child process times

SYNOPSIS

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

long times(buffer)
struct tms ∗buffer;

DESCRIPTION

times() returns time-accounting information for the current process and for the terminated child processes of the current process.  All times are in 1/HZ seconds, where HZ is 60. 

This is the structure returned by times:

struct tms {
time_ttms_utime;/∗ user time ∗/
time_ttms_stime;/∗ system time ∗/
time_ttms_cutime;/∗ user time, children ∗/
time_ttms_cstime;/∗ system time, children ∗/
};

This information comes from the calling process and each of its terminated child processes for which it has executed a wait. 

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

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

tms_cutime is the sum of the tms_utimes and tms_cutimes of the child processes. 

tms_cstime is the sum of the tms_stimes and tms_cstimes of the child processes. 

RETURN VALUE

Upon successful completion, times() returns the elapsed real time, in 60ths of a second, since an arbitrary point in the past.  This point does not change from one invocation of times() to another within the same process.  If times() fails, a −1 is returned and errno is set to indicate the error. 

SEE ALSO

time(1V), getrusage(2), wait(2), time(3C)

Sun Release 4.0  —  Last change: 25 March 1989