Return to vtimes.3c CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man3

Annotation of cci/usr/src/man/man3/vtimes.3c, revision 1.1.1.1

1.1       root        1: .TH VTIMES 3C "13 June 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: vtimes \- get information about resource utilization
                      5: .SH SYNOPSIS
                      6: .nf
                      7: .B "vtimes(par_vm, ch_vm)"
                      8: .B "struct vtimes *par_vm, *ch_vm;"
                      9: .fi
                     10: .SH DESCRIPTION
                     11: .ft B
                     12: This facility is superseded by getrusage(2).
                     13: .ft R
                     14: .PP
                     15: .I Vtimes
                     16: returns accounting information for the current process and for
                     17: the terminated child processes of the current
                     18: process.  Either
                     19: .I par_vm
                     20: or 
                     21: .I ch_vm
                     22: or both may be 0, in which case only the information for the pointers
                     23: which are non-zero is returned.
                     24: .PP
                     25: After the call, each buffer contains information as defined by the
                     26: contents of the include file
                     27: .I /usr/include/sys/vtimes.h:
                     28: .LP
                     29: .nf
                     30: struct vtimes {
                     31:        int     vm_utime;               /* user time (*HZ) */
                     32:        int     vm_stime;               /* system time (*HZ) */
                     33:        /* divide next two by utime+stime to get averages */
                     34:        unsigned vm_idsrss;             /* integral of d+s rss */
                     35:        unsigned vm_ixrss;              /* integral of text rss */
                     36:        int     vm_maxrss;              /* maximum rss */
                     37:        int     vm_majflt;              /* major page faults */
                     38:        int     vm_minflt;              /* minor page faults */
                     39:        int     vm_nswap;               /* number of swaps */
                     40:        int     vm_inblk;               /* block reads */
                     41:        int     vm_oublk;               /* block writes */
                     42: };
                     43: .fi
                     44: .PP
                     45: The
                     46: .I vm_utime
                     47: and
                     48: .I vm_stime
                     49: fields give the user and system
                     50: time respectively in 60ths of a second (or 50ths if that
                     51: is the frequency of wall current in your locality.) The
                     52: .I vm_idrss
                     53: and
                     54: .I vm_ixrss
                     55: measure memory usage.  They are computed by integrating the number of
                     56: memory pages in use each
                     57: over cpu time.  They are reported as though computed
                     58: discretely, adding the current memory usage (in 512 byte
                     59: pages) each time the clock ticks.  If a process used 5 core
                     60: pages over 1 cpu-second for its data and stack, then
                     61: .I vm_idsrss
                     62: would have the value 5*60, where
                     63: .I vm_utime+vm_stime
                     64: would be the 60.  
                     65: .I Vm_idsrss
                     66: integrates data and stack segment
                     67: usage, while
                     68: .I vm_ixrss
                     69: integrates text segment usage.
                     70: .I Vm_maxrss
                     71: reports the maximum instantaneous sum of the
                     72: text+data+stack core-resident page count.
                     73: .PP
                     74: The 
                     75: .I vm_majflt
                     76: field gives the number of page faults which
                     77: resulted in disk activity; the
                     78: .I vm_minflt
                     79: field gives the
                     80: number of page faults incurred in simulation of reference
                     81: bits;
                     82: .I vm_nswap
                     83: is the number of swaps which occurred.  The
                     84: number of file system input/output events are reported in
                     85: .I vm_inblk
                     86: and
                     87: .I vm_oublk
                     88: These numbers account only for real
                     89: i/o; data supplied by the caching mechanism is charged only
                     90: to the first process to read or write the data.
                     91: .SH SEE ALSO
                     92: time(2), wait3(2)
                     93: .SH BUGS
                     94: This call is peculiar to this version of UNIX.
                     95: The options and specifications of this system call are subject to change.
                     96: It may be extended to include additional information
                     97: in future versions of the system.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.