TIMES(2)							System Calls Manual							  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).

4th Berkeley Distribution					    May 9, 1985 							  TIMES(2)