vtimes(3C)                     DG/UX R4.11MU05                    vtimes(3C)


NAME
       vtimes - get information about resource usage

SYNOPSIS
       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.  parvm,
       chvm, 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  vmutime;      /* user time (*HZ) */
            int  vmstime;      /* system time (*HZ) */

            /* divide next two by utime+stime to get averages */

            unsigned vmidsrss;      /* integral of d+s rss */
            unsigned vmixrss;       /* integral of text rss */
            int  vmmaxrss;          /* maximum rss */
            int  vmmajflt;          /* major page faults */
            int  vmminflt;          /* minor page faults */
            int  vmnswap;      /* number of swaps */
            int  vminblk;      /* block reads */
            int  vmoublk;      /* block writes */
       };

       The vmutime and vmstime fields give the user and system time,
       respectively, in 100ths of a second.  The vmidrss and vmixrss
       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 vmidsrss would have the value
       5*100, where vmutime+vmstime would be the 100.  vmidsrss
       integrates data and stack segment usage, while vmixrss integrates
       text segment usage.  vmmaxrss reports the maximum instantaneous sum
       of the text+data+stack core-resident page count.

       The vmmajflt field gives the number of page faults that resulted in
       disk activity; the vmminflt field gives the number of page faults
       incurred in simulation of reference bits; vmnswap is the number of
       swaps that occurred.  The number of file system input/output events
       are reported in vminblk and vmoublk.  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.

SEE ALSO
       time(2), wait3(2), ftime(3C).


Licensed material--property of copyright holder(s)