LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity

getrusage.2: Replace text describing unused fields 

An earlier patch attempted to describe how the unused rusage
fields are used on other systems. But, Mark Hills notes that
that is likely to cause confusion. So, replace that text with
a general statement about why the unused fields are present.

Reported-by: Mark Hills <mark@pogo.org.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk 2010-06-14 04:30:17 +02:00
parent 87f8e275ae
commit 14f1e036e1
1 changed files with 26 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

41
man2/getrusage.2
View File

@ -36,7 +36,7 @@
.\" document ru_maxrss
.\" 2010-05-24, mtk, enhanced description of various fields
.\"
.TH GETRUSAGE 2 2010-05-24 "Linux" "Linux Programmer's Manual"
.TH GETRUSAGE 2 2010-06-14 "Linux" "Linux Programmer's Manual"
.SH NAME
getrusage \- get resource usage
.SH SYNOPSIS
@ -93,8 +93,11 @@ struct rusage {
.fi
.in
.PP
Not all fields are completed; unmaintained fields are set to zero by
the kernel. The fields are interpreted as follows:
Not all fields are completed;
unmaintained fields are set to zero by the kernel.
(The unmaintained fields are provided for compatibility with other systems,
and because they may one day be supported on Linux.)
The fields are interpreted as follows:
.TP
.I ru_utime
This is the total amount of time spent executing in user mode,
@ -115,16 +118,20 @@ this is the resident set size of the largest child, not the maximum
resident set size of the process tree.
.TP
.IR ru_ixrss " (unmaintained)"
On some systems, this is the integral of the text segment memory consumption,
expressed in kilobyte-seconds.
This field is currently unused on Linux.
.\" On some systems,
.\" this is the integral of the text segment memory consumption,
.\" expressed in kilobyte-seconds.
.TP
.IR ru_idrss " (unmaintained)"
On some systems, this is the integral of the data segment memory consumption,
expressed in kilobyte-seconds.
This field is currently unused on Linux.
.\" On some systems, this is the integral of the data segment memory consumption,
.\" expressed in kilobyte-seconds.
.TP
.IR ru_isrss " (unmaintained)"
On some systems, this is the integral of the stack memory consumption,
expressed in kilobyte-seconds.
This field is currently unused on Linux.
.\" On some systems, this is the integral of the stack memory consumption,
.\" expressed in kilobyte-seconds.
.TP
.I ru_minflt
The number of page faults serviced without any I/O activity; here
@ -135,7 +142,8 @@ the list of pages awaiting reallocation.
The number of page faults serviced that required I/O activity.
.TP
.IR ru_nswap " (unmaintained)"
On some systems, this is the number of swaps out of physical memory.
This field is currently unused on Linux.
.\" On some systems, this is the number of swaps out of physical memory.
.TP
.IR ru_inblock " (since Linux 2.6.22)"
The number of times the file system had to perform input.
@ -144,17 +152,20 @@ The number of times the file system had to perform input.
The number of times the file system had to perform output.
.TP
.IR ru_msgsnd " (unmaintained)"
This field is currently unused on Linux.
.\" On FreeBSD 6.2, this appears to measure messages sent over sockets
On some systems,
this field records the number of messages sent over sockets.
.\" On some systems,
.\" this field records the number of messages sent over sockets.
.TP
.IR ru_msgrcv " (unmaintained)"
This field is currently unused on Linux.
.\" On FreeBSD 6.2, this appears to measure messages received over sockets
On some systems,
this field records the number of messages received over sockets.
.\" On some systems,
.\" this field records the number of messages received over sockets.
.TP
.IR ru_nsignals " (unmaintained)"
On some systems, this field records the number of signals received.
This field is currently unused on Linux.
.\" On some systems, this field records the number of signals received.
.TP
.IR ru_nvcsw " (since Linux 2.6)"
The number of times a context switch resulted due to a process