TIMES(3)                 BSD Library Functions Manual                 TIMES(3)

NAME
     times -- process times

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     ##include <>

     clockt
     times(struct tms *tp);

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

     The times() function returns the value of time in CLKTCK'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
     information.

     The tms structure is defined as follows:

           struct tms {
                   clockt tmsutime;
                   clockt tmsstime;
                   clockt tmscutime;
                   clockt tmscstime;
           };

     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 tmsutimes and tmscutimes of the child pro-
                 cesses.

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

     All times are in CLKTCK'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
     error occurs, times() returns the value ((clockt)-1), and sets errno to
     indicate the error.

ERORS
     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), clocks(7)

STANDARDS
     The times() function conforms to IE Std 1003.1-1988 (``POSIX.1'').

BSD                              June 4, 1993                              BSD