4.3BSD-UWisc/man/cat3/vtimes.3c

VTIMES(3C)          UNIX Programmer's Manual           VTIMES(3C)



NAME
     vtimes - get information about resource utilization

SYNOPSIS
     #include <sys/vtimes.h>

     vtimes(par_vm, ch_vm)
     struct vtimes *par_vm, *ch_vm;

DESCRIPTION
     This facility is superseded by getrusage(2).

     _V_t_i_m_e_s returns accounting information for the current pro-
     cess and for the terminated child processes of the current
     process.  Either _p_a_r__v_m or _c_h__v_m 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
     /_u_s_r/_i_n_c_l_u_d_e/_s_y_s/_v_t_i_m_e_s._h:

     struct vtimes {
          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 */
     };

     The _v_m__u_t_i_m_e and _v_m__s_t_i_m_e 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
     _v_m__i_d_r_s_s and _v_m__i_x_r_s_s measure memory usage.  They are com-
     puted by integrating the number of memory pages in use each
     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
     _v_m__i_d_s_r_s_s would have the value 5*60, where _v_m__u_t_i_m_e+_v_m__s_t_i_m_e
     would be the 60. _V_m__i_d_s_r_s_s integrates data and stack segment
     usage, while _v_m__i_x_r_s_s integrates text segment usage.
     _V_m__m_a_x_r_s_s reports the maximum instantaneous sum of the
     text+data+stack core-resident page count.





Printed 12/27/86          May 12, 1986                          1






VTIMES(3C)          UNIX Programmer's Manual           VTIMES(3C)



     The _v_m__m_a_j_f_l_t field gives the number of page faults which
     resulted in disk activity; the _v_m__m_i_n_f_l_t field gives the
     number of page faults incurred in simulation of reference
     bits; _v_m__n_s_w_a_p is the number of swaps which occurred.  The
     number of file system input/output events are reported in
     _v_m__i_n_b_l_k and _v_m__o_u_b_l_k 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.

SEE ALSO
     time(2), wait3(2), getrusage(2)












































Printed 12/27/86          May 12, 1986                          2