times function returns information about a process'
consumption of processor time in a
struct tms object, in
addition to the process' CPU time. See Time Basics. You should
include the header file sys/times.h to use this facility.
tmsstructure is used to return information about process times. It contains at least the following members:
- This is the total processor time the calling process has used in executing the instructions of its program.
- This is the processor time the system has used on behalf of the calling process.
- This is the sum of the
tms_utimevalues and the
tms_cutimevalues of all terminated child processes of the calling process, whose status has been reported to the parent process by
waitpid; see Process Completion. In other words, it represents the total processor time used in executing the instructions of all the terminated child processes of the calling process, excluding child processes which have not yet been reported by
- This is similar to
tms_cutime, but represents the total processor time system has used on behalf of all the terminated child processes of the calling process.
All of the times are given in numbers of clock ticks. Unlike CPU time, these are the actual amounts of time; not relative to any event. See Creating a Process.
This is an obsolete name for the number of clock ticks per second. Use
timesfunction stores the processor time information for the calling process in buffer.
The return value is the number of clock ticks since an arbitrary point in the past, e.g. since system start-up.
(clock_t)(-1)to indicate failure.
Portability Note: The
clock function described in
CPU Time is specified by the ISO C standard. The
times function is a feature of POSIX.1. On GNU systems, the
CPU time is defined to be equivalent to the sum of the
tms_stime fields returned by