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     ! 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.