TIMES(3)                    BSD Programmer's Manual                   TIMES(3)

NAME
     times - process times

SYNOPSIS
     #include <sys/times.h>

     clockt
     times(struct tms *tp)

DESCRIPTION
     This interface is obsoleted by getrusage(2) and gettimeofday(3).

     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 Univer-
     sal Time.

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

     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:

     tmsutime   The CPU time charged for the execution of user instructions.

     tmsstime   The CPU time charged for execution by the system on behalf of
                 the process.

     tmscutime  The sum of the tmsutime s and tmscutime s of the child pro-
                 cesses.

     tmscstime  The sum of the tmsstimes and tmscstimes of the child pro-
                 cesses.

     All times are in CLK_TCK's of a second.

     The times of a terminated child process are included in the tmscutime
     and tmscstime elements of the parent when one of the wait(2) functions
     returns the process ID of the terminated child to the parent.  If an er-
     ror 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
     gettimeofday(2).

SEE ALSO
     time(1),  getrusage(2),  gettimeofday(2),  wait(2)

STANDARDS
     The times() function conforms to IEEE Std1003.1-1988 (``POSIX'').

4th Berkeley Distribution       March 26, 1993                               1