Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

times(2) [minix man page]

TIMES(2)							System Calls Manual							  TIMES(2)

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)

Check Out this Related Man Page

times(2)							   System Calls 							  times(2)

times - get process and child process times SYNOPSIS
#include <sys/times.h> #include <limits.h> clock_t times(struct tms *buffer); DESCRIPTION
The times() function fills the tms structure pointed to by buffer with time-accounting information. The tms structure, defined in <sys/times.h>, contains the following members: clock_t tms_utime; clock_t tms_stime; clock_t tms_cutime; clock_t tms_cstime; All times are reported in clock ticks. The specific value for a clock tick is defined by the variable CLK_TCK, found in the header <lim- its.h>. The times of a terminated child process are included in the tms_cutime and tms_cstime members of the parent when wait(3C) or waitpid(3C) returns the process ID of this terminated child. If a child process has not waited for its children, their times will not be included in its times. The tms_utime member is the CPU time used while executing instructions in the user space of the calling process. The tms_stime member is the CPU time used by the system on behalf of the calling process. The tms_cutime member is the sum of the tms_utime and the tms_cutime of the child processes. The tms_cstime member is the sum of the tms_stime and the tms_cstime of the child processes. RETURN VALUES
Upon successful completion, times() returns the elapsed real time, in clock ticks, since an arbitrary point in the past (for example, sys- tem start-up time). This point does not change from one invocation of times() within the process to another. The return value may overflow the possible range of type clock_t. If times() fails, (clock_t)-1 is returned and errno is set to indicate the error. ERRORS
The times() function will fail if: EFAULT The buffer argument points to an illegal address. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |Async-Signal-Safe | +-----------------------------+-----------------------------+ SEE ALSO
time(1), timex(1), exec(2), fork(2), time(2), waitid(2), wait(3C), waitpid(3C), attributes(5), standards(5) SunOS 5.11 14 May 1997 times(2)
Man Page