NAME
	  getrusage, vtimes - Gets information about resource utiliza-
	  tion

     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
	  who  Specifies 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_usage
	       Points 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 superceded 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)