NAME
times - get process times
SYNOPSIS
#include <sys/types.h>
#include <sys/times.h>
#include <time.h>
int times(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/CLOCKS_PER_SEC seconds.
This is the structure returned by times:
struct tms {
clock_t tms_utime; /* user time for this process */
clock_t tms_stime; /* system time for this process */
clock_t tms_cutime; /* children's user time */
clock_t tms_cstime; /* children's system time */
};
The user time is the number of clock ticks used by a process
on its own computations. The system time is the number of
clock ticks spent inside the kernel on behalf of a process.
This does not include time spent waiting for I/O to happen,
only actual CPU instruction times.
The children times are the sum of the children's process
times and their children's times.
RETURN
Times returns 0 on success, otherwise -1 with the error code
stored into the global variable errno.
ERRORS
The following error code may be set in errno:
[EFAULT] The address specified by the buffer parameter
is not in a valid part of the process address
space.
SEE ALSO
time(1), wait(2), time(2).