Return to vtimes.3 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man3

Annotation of 43BSDTahoe/man/man3/vtimes.3, revision 1.1.1.1

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

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