diff --git a/man2/getrusage.2 b/man2/getrusage.2 index 4cafdd7ee..0e5bc0a34 100644 --- a/man2/getrusage.2 +++ b/man2/getrusage.2 @@ -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