.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved. The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\" @(#)vtimes.3 6.3 (Berkeley) %G%
vtimes \- get information about resource utilization
.B "#include <sys/vtimes.h>"
.B "vtimes(par_vm, ch_vm)"
.B "struct vtimes *par_vm, *ch_vm;"
This facility is superseded by getrusage(2).
returns accounting information for the current process and for
the terminated child processes of the current
or both may be 0, in which case only the information for the pointers
which are non-zero is returned.
After the call, each buffer contains information as defined by the
contents of the include file
.I /usr/include/sys/vtimes.h:
int vm_utime; /* user time (*HZ) */
int vm_stime; /* system time (*HZ) */
/* divide next two by utime+stime to get averages */
unsigned vm_idsrss; /* integral of d+s rss */
unsigned vm_ixrss; /* integral of text rss */
int vm_maxrss; /* maximum rss */
int vm_majflt; /* major page faults */
int vm_minflt; /* minor page faults */
int vm_nswap; /* number of swaps */
int vm_inblk; /* block reads */
int vm_oublk; /* block writes */
fields give the user and system
time respectively in 60ths of a second (or 50ths if that
is the frequency of wall current in your locality.) The
measure memory usage. They are computed by integrating the number of
over cpu time. They are reported as though computed
discretely, adding the current memory usage (in 512 byte
pages) each time the clock ticks. If a process used 5 core
pages over 1 cpu-second for its data and stack, then
would have the value 5*60, where
integrates data and stack segment
integrates text segment usage.
reports the maximum instantaneous sum of the
text+data+stack core-resident page count.
field gives the number of page faults which
resulted in disk activity; the
number of page faults incurred in simulation of reference
is the number of swaps which occurred. The
number of file system input/output events are reported in
These numbers account only for real
i/o; data supplied by the caching mechanism is charged only
to the first process to read or write the data.
time(2), wait3(2), getrusage(2)