BSD 4_4 development

[unix-history] / usr / share / man / cat3 / vtimes.0

VTIMES(3)                   BSD Programmer's Manual                  VTIMES(3)

N\bNA\bAM\bME\bE
     v\bvt\bti\bim\bme\bes\bs - get information about resource utilization

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     #\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<s\bsy\bys\bs/\b/v\bvt\bti\bim\bme\bes\bs.\b.h\bh>\b>

     v\bvt\bti\bim\bme\bes\bs(_\bs_\bt_\br_\bu_\bc_\bt _\bv_\bt_\bi_\bm_\be_\bs _\b*_\bp_\ba_\br_\b__\bv_\bm, _\bs_\bt_\br_\bu_\bc_\bt _\bv_\bt_\bi_\bm_\be_\bs _\b*_\bc_\bh_\b__\bv_\bm);

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     T\bTh\bhi\bis\bs i\bin\bnt\bte\ber\brf\bfa\bac\bce\be i\bis\bs o\bob\bbs\bso\bol\ble\bet\bte\bed\bd b\bby\by g\bge\bet\btr\bru\bus\bsa\bag\bge\be(\b(2\b2)\b).\b.  I\bIt\bt i\bis\bs a\bav\bva\bai\bil\bla\bab\bbl\ble\be f\bfr\bro\bom\bm t\bth\bhe\be
     c\bco\bom\bmp\bpa\bat\bti\bib\bbi\bil\bli\bit\bty\by l\bli\bib\bbr\bra\bar\bry\by,\b, l\bli\bib\bbc\bco\bom\bmp\bpa\bat\bt.\b.

     The v\bvt\bti\bim\bme\bes\bs() function returns accounting information for the current pro-
     cess and for the terminated child processes of the current process.  Ei-
     ther _\bp_\ba_\br_\b__\bv_\bm or _\bc_\bh_\b__\bv_\bm 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 con-
     tents of the include file _\b/_\bu_\bs_\br_\b/_\bi_\bn_\bc_\bl_\bu_\bd_\be_\b/_\bs_\by_\bs_\b/_\bv_\bt_\bi_\bm_\be_\bs_\b._\bh:

           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 _\bv_\bm_\b__\bu_\bt_\bi_\bm_\be and _\bv_\bm_\b__\bs_\bt_\bi_\bm_\be fields give the user and system time respec-
     tively in 60ths of a second (or 50ths if that is the frequency of wall
     current in your locality.) The _\bv_\bm_\b__\bi_\bd_\br_\bs_\bs and _\bv_\bm_\b__\bi_\bx_\br_\bs_\bs measure memory us-
     age.  They are computed 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 _\bv_\bm_\b__\bi_\bd_\bs_\br_\bs_\bs would have the value 5*60, where _\bv_\bm_\b__\bu_\bt_\bi_\bm_\be_\b+_\bv_\bm_\b__\bs_\bt_\bi_\bm_\be
     would be the 60.  The _\bV_\bm_\b__\bi_\bd_\bs_\br_\bs_\bs argument integrates data and stack seg-
     ment usage, while _\bv_\bm_\b__\bi_\bx_\br_\bs_\bs integrates text segment usage.  The _\bV_\bm_\b__\bm_\ba_\bx_\br_\bs_\bs
     function reports the maximum instantaneous sum of the text+data+stack
     core-resident page count.

     The _\bv_\bm_\b__\bm_\ba_\bj_\bf_\bl_\bt field gives the number of page faults which resulted in
     disk activity; the _\bv_\bm_\b__\bm_\bi_\bn_\bf_\bl_\bt field gives the number of page faults in-
     curred in simulation of reference bits; _\bv_\bm_\b__\bn_\bs_\bw_\ba_\bp is the number of swaps
     which occurred.  The number of file system input/output events are re-
     ported in _\bv_\bm_\b__\bi_\bn_\bb_\bl_\bk and _\bv_\bm_\b__\bo_\bu_\bb_\bl_\bk These numbers account only for real I/O;
     data supplied by the caching mechanism is charged only to the first pro-
     cess to read or write the data.

S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     time(2),  wait3(2),  getrusage(2)

H\bHI\bIS\bST\bTO\bOR\bRY\bY
     The v\bvl\bli\bim\bmi\bit\bt() function appeared in 4.2BSD.

4th Berkeley Distribution        June 4, 1993                                1