69 lines
1.6 KiB
Groff
69 lines
1.6 KiB
Groff
|
.\" Copyright (c) 1980 Regents of the University of California.
|
||
|
|
.\" All rights reserved. The Berkeley software License Agreement
|
||
|
|
.\" specifies the terms and conditions for redistribution.
|
||
|
|
.\"
|
||
|
|
.\" @(#)times.3c 6.1 (Berkeley) 5/9/85
|
||
|
|
.\"
|
||
|
|
.TH TIMES 2 "May 9, 1985"
|
||
|
|
.UC 4
|
||
|
|
.SH NAME
|
||
|
|
times \- get process times
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.nf
|
||
|
|
.ft B
|
||
|
|
#include <sys/types.h>
|
||
|
|
#include <sys/times.h>
|
||
|
|
#include <time.h>
|
||
|
|
|
||
|
|
int times(struct tms *\fIbuffer\fP)
|
||
|
|
.fi
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.B 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.
|
||
|
|
.PP
|
||
|
|
This is the structure returned by
|
||
|
|
.BR times :
|
||
|
|
.PP
|
||
|
|
.RS
|
||
|
|
.nf
|
||
|
|
.ta +0.4i +0.8i +1.2i
|
||
|
|
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 */
|
||
|
|
};
|
||
|
|
.fi
|
||
|
|
.RE
|
||
|
|
.PP
|
||
|
|
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.
|
||
|
|
.PP
|
||
|
|
The children times are the sum
|
||
|
|
of the children's process times and
|
||
|
|
their children's times.
|
||
|
|
.SH RETURN
|
||
|
|
.B Times
|
||
|
|
returns 0 on success, otherwise \-1 with the error code stored into the
|
||
|
|
global variable
|
||
|
|
.BR errno .
|
||
|
|
.SH ERRORS
|
||
|
|
The following error code may be set in
|
||
|
|
.BR errno :
|
||
|
|
.TP 15
|
||
|
|
[EFAULT]
|
||
|
|
The address specified by the
|
||
|
|
.I buffer
|
||
|
|
parameter is not in a valid part of the process address space.
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.BR time (1),
|
||
|
|
.BR wait (2),
|
||
|
|
.BR time (2).
|