NAME

times − get process times

SYNTAX

#include <sys/types.h>
#include <sys/times.h>

clock_t
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 equivalent to 60.

The following structure is 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. 

RETURN VALUE

If successful, the function times returns 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 returns −1

SEE ALSO

time(1), getrusage(2), wait3(2), time(3)

Subroutines