Return to vtimes.3 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libcompat / 4.1

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