The times
function returns information about a process'
consumption of processor time in a struct tms
object, in
addition to the process' CPU time. See section Time Basics. You should
include the header file `sys/times.h' to use this facility.
tms
structure is used to return information about process
times. It contains at least the following members:
clock_t tms_utime
clock_t tms_stime
clock_t tms_cutime
tms_utime
values and the tms_cutime
values of all terminated child processes of the calling process, whose
status has been reported to the parent process by wait
or
waitpid
; see section 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 wait
or
waitpid
.
clock_t tms_cstime
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 section Creating a Process.
times
function stores the processor time information for
the calling process in buffer.
The return value is the calling process' CPU time (the same value you
get from clock()
. times
returns (clock_t)(-1)
to
indicate failure.
Portability Note: The clock
function described in
section CPU Time Inquiry is specified by the ISO C standard. The
times
function is a feature of POSIX.1. In the GNU system, the
CPU time is defined to be equivalent to the sum of the tms_utime
and tms_stime
fields returned by times
.
Go to the first, previous, next, last section, table of contents.