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 fills the structure pointed to by buffer with time-accounting information.  The following is the contents of this structure:

structtms {
time_ttms_utime;
time_ttms_stime;
time_ttms_cutime;
time_ttms_cstime;
};

This information comes from the calling process and each of its terminated child processes for which it has executed a wait. All times are in 60ths of a second.

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.

Times will fail if buffer points to an illegal address.  ­[EFAULT]

RETURN VALUE

Upon successful completion, times returns the elapsed real time, in 60ths 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.  If times fails, a −1 is returned and errno is set to indicate the error. 

SEE ALSO

exec(2), fork(2), time(2), wait(2). 

ASSEMBLER

moveq#43,D0
movlbuffer,A0
trap#0

Version 2.1  —  January 02, 1985