NAME

getrusage, vtimes − Gets information about resource utilization

LIBRARY

Berkeley  Compatibility  Library  (libbsd.a), vtimes() only

SYNOPSIS

#include <sys/time.h>
#include <sys/resource.h> int getrusage (
int who,
struct rusage ∗r_usage ); #include <sys/vtimes.h> vtimes (
struct vtimes ∗par_vm,
struct vtimes ch_vm );

PARAMETERS

whoSpecifies one of the following:

RUSAGE_SELF
Retrieve information about resources used by the current process.

RUSAGE_CHILDREN
Retrieve information about resources used by child processes of the current process.

r_usagePoints to a buffer that will be filled in as described in the sys/resource.h header file. 

DESCRIPTION

The getrusage() function returns information describing the resources utilized by the current process or its terminated child processes. 

NOTES

The numbers the ru_inblock and ru_outblock fields of the rusage structure 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. 

The vtimes() function is supported to provide compatibility with older programs.  It is superseded by the getrusage() function. 

The vtimes() function returns accounting information for the current process and for the terminated child processes of the current process.  Either par_vm or ch_vm or both may be zero, in which case only the information for the pointers which are nonzero are returned. 

After the call, each buffer contains information as defined by the contents of the sys/vtimes.h include file. 

RETURN VALUES

Upon successful completion, the getrusage(), function returns 0 (zero).  Otherwise, -1 is returned and errno is set to indicate the error. 

ERRORS

If the getrusage() function fails, errno may be set to one of the following values:

[EINVAL]The who parameter is not a valid value. 

[EFAULT]The address specified for r_usage is not valid. 

RELATED INFORMATION

Functions: gettimer(3), time(3), times(3), wait(2)