TIMES(2)                         System Calls                         TIMES(2)

NAME

       times - process times

SYNOPSIS

       #include <sys/times.h>

       clock_t times (struct tms *tp);

DESCRIPTION

       The  times  function returns the value of time in CLK_TCK's of a second
       since 0 hours, 0 minutes, 0 seconds, January 1, 1970, Coordinated  Uni‐
       versal Time.

       It  also  fills  in the structure pointed to by tp with time-accounting
       information.

       The tms structure is defined as follows:

       typedef struct {
            clock_t tms_utime;
            clock_t tms_stime;
            clock_t tms_cutime;
            clock_t tms_cstime;
       }

       The elements of this structure are defined as follows:

              tms_utime
                     The CPU time charged for the execution of  user  instruc‐
                     tions.

              tms_stime
                     The  CPU  time charged for execution by the system on be‐
                     half of the process.

              tms_cutime
                     The sum of the tms_utime, and  tms_cutime  of  the  child
                     processes.

              tms_cstime
                     The  sum  of  the  tms_stime, and tms_cstime of the child
                     processes.

       All times are in CLK_TCK's of a second.

       The times of a terminated child process are included in the  tms_cutime
       and tms_cstime elements of the parent when one of the wait(2) functions
       returns the process ID of the terminated child to the  parent.   If  an
       error  occurs,  times  returns the value (clock_t)-1, and sets errno to
       indicate the error.

ERRORS

       The times function may fail and set the global variable errno  for  any
       of  the errors specified for the library routines getrusage(2) and get����
       timeofday(2).

SEE ALSO

       time(1), getrusage(2), gettimeofday(2), wait(2), clocks(7)

STANDARDS

       The times function conforms to POSIX 1003.1-88.



GNO                             16 January 1997                       TIMES(2)