74 lines
2.1 KiB
HTML
74 lines
2.1 KiB
HTML
<HTML>
|
|
<HEAD>
|
|
<TITLE>times(2)</TITLE>
|
|
</HEAD>
|
|
<BODY>
|
|
<H1>times(2)</H1>
|
|
<HR>
|
|
<PRE>
|
|
|
|
</PRE>
|
|
<H2>NAME</H2><PRE>
|
|
times - get process times
|
|
|
|
|
|
</PRE>
|
|
<H2>SYNOPSIS</H2><PRE>
|
|
<STRONG>#include</STRONG> <STRONG><sys/types.h></STRONG>
|
|
<STRONG>#include</STRONG> <STRONG><sys/times.h></STRONG>
|
|
<STRONG>#include</STRONG> <STRONG><time.h></STRONG>
|
|
|
|
<STRONG>int</STRONG> <STRONG>times(struct</STRONG> <STRONG>tms</STRONG> <STRONG>*</STRONG><EM>buffer</EM><STRONG>)</STRONG>
|
|
|
|
|
|
</PRE>
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
<STRONG>Times</STRONG> 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 <STRONG>times</STRONG>:
|
|
|
|
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.
|
|
|
|
|
|
</PRE>
|
|
<H2>RETURN</H2><PRE>
|
|
<STRONG>Times</STRONG> returns 0 on success, otherwise -1 with the error code stored into
|
|
the global variable <STRONG>errno</STRONG>.
|
|
|
|
|
|
</PRE>
|
|
<H2>ERRORS</H2><PRE>
|
|
The following error code may be set in <STRONG>errno</STRONG>:
|
|
|
|
[EFAULT] The address specified by the <EM>buffer</EM> parameter is not in a
|
|
valid part of the process address space.
|
|
|
|
|
|
</PRE>
|
|
<H2>SEE ALSO</H2><PRE>
|
|
<STRONG><A HREF="../man1/time.1.html">time(1)</A></STRONG>, <STRONG><A HREF="../man2/wait.2.html">wait(2)</A></STRONG>, <STRONG><A HREF="../man2/time.2.html">time(2)</A></STRONG>.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
</BODY>
|
|
</HTML>
|