times(3)
NAME
times − get process times
SYNTAX
#include <sys/types.h>
#include <sys/times.h>
times(buffer)
struct tms *buffer;
DESCRIPTION
The times subroutine 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_t tms_utime; /* user time */
time_t tms_stime; /* system time */
time_t tms_cutime; /* user time, children */
time_t tms_cstime; /* system time, children */
};
The children times are the sum of the children’s process times and their children’s times.
ENVIRONMENT
When your program is compiled using the System V environment, a value of type long is returned. If successful, the function times will return the elapsed time since 00:00:00 GMT, January 1, 1970 in units of 1/60’s of a second. When the function times fails, it will return −1