Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ vtimes(3c) — DG/UX 4.00

Media Vault

Software Library

Restoration Projects

Artifacts Sought



                                                               vtimes(3c)



        _________________________________________________________________
        vtimes
        get information about resource usage
        _________________________________________________________________


        SYNTAX

        vtimes(parvm, chvm)
        struct vtimes *parvm, *chvm;


        DESCRIPTION

        Vtimes returns accounting information for the current process and
        for the terminated child processes of the current process.
        Par_vm, ch_vm, or both may be 0, in which case only the
        information for non-zero pointers is returned.

        After the call, each buffer contains information as defined by
        the contents of the include file /usr/include/sys/vtimes.h:

        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 vm_utime and vm_stime fields give the user and system time,
        respectively, in 100ths of a second.  The vm_idrss and vm_ixrss
        measure memory usage.  They are computed by integrating the
        number of memory pages in use over CPU time.  They are reported
        as though computed discretely, adding the current memory usage
        (in 2048 byte pages) each time the clock ticks.

        For example, if a process used five main memory pages over one
        CPU-second for its data and stack, then vm_idsrss would have the
        value 5*100, where vm_utime+vm_stime would be the 100.  Vm_idsrss
        integrates data and stack segment usage, while vm_ixrss
        integrates text segment usage.  Vm_maxrss reports the maximum
        instantaneous sum of the text+data+stack core-resident page



        DG/UX 4.00                                                 Page 1
               Licensed material--property of copyright holder(s)





                                                               vtimes(3c)



        count.

        The vm_majflt field gives the number of page faults that resulted
        in disk activity; the vm_minflt field gives the number of page
        faults incurred in simulation of reference bits; vm_nswap is the
        number of swaps that occurred.  The number of file system
        input/output events are reported in vm_inblk and vm_oublk.  These
        numbers account only for real I/O; data supplied by the caching
        mechanism is charged only to the first process to read or write
        the data.


        FILES

             /usr/lib/libproto/lib3c.a


        SEE ALSO

        time(2), ftime(3C), wait3(2)


































        DG/UX 4.00                                                 Page 2
               Licensed material--property of copyright holder(s)



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026