times(2)



NAME

     times - get process times


SYNOPSIS

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

     int times(struct tms *buffer)


DESCRIPTION

     Times returns time-accounting information for the current process and for
     the  terminated child processes of the current process.  All times are in
     1/CLOCKS_PER_SEC seconds.

     This is the structure returned by times:

          struct tms {
              clock_t   tms_utime;    /* user time for this process */
              clock_t   tms_stime;    /* system time for this process */
              clock_t   tms_cutime;   /* children's user time */
              clock_t   tms_cstime;   /* children's system time */
          };

     The user time is the number of clock ticks used by a process on  its  own
     computations.   The system time is the number of clock ticks spent inside
     the kernel on behalf of a process.  This  does  not  include  time  spent
     waiting for I/O to happen, only actual CPU instruction times.

     The children times are the sum of the children's process times and  their
     children's times.


RETURN

     Times returns 0 on success, otherwise -1 with the error code stored  into
     the global variable errno.


ERRORS

     The following error code may be set in errno:

     [EFAULT]       The address specified by the buffer parameter is not in  a
                    valid part of the process address space.


SEE ALSO

     time(1), wait(2), time(2).