top: minimal necessary corrections to the man document

After experimenting with those 4.5 kernel enhancements
to /proc/<pid>/status, that newly added overview topic
'Memory Types' was found to be in need of some tweaks.

In addition, the 'DATA' description wasn't quite broad
enough since explicit private file mappings impact it.

( lastly, for the record, the 2nd commit referred to )
( below contained an incorrect reference that should )
( have been the original issue 21 commit. instead it )
( showed an invalid SHA-1 hash. i believe i have now )
( identified a flaw in my workflow that produced it. )

Reference(s):
. original patch responding to issue #21
commit e4bbd3ca1a
. subsequent patch with invalid commit ref
commit 5dcbcd00fe

Signed-off-by: Jim Warner <james.warner@comcast.net>
This commit is contained in:
Jim Warner 2016-04-12 00:00:00 -05:00 committed by Craig Small
parent 5dcbcd00fe
commit dad56cc954

View File

@ -69,7 +69,7 @@
.
.\" Document /////////////////////////////////////////////////////////////
.\" ----------------------------------------------------------------------
.TH TOP 1 "October 2015" "procps-ng" "User Commands"
.TH TOP 1 "April 2016" "procps-ng" "User Commands"
.\" ----------------------------------------------------------------------
.\" ----------------------------------------------------------------------
@ -307,7 +307,7 @@ The memory in quadrant #4, when modified, acts as its own dedicated \*(MS.
\fB1\fR | \fB2\fR
\fBAnonymous\fR . stack |
. malloc() |
. brk()/sbrk() |
. brk()/sbrk() | . POSIX shm*
. mmap(PRIVATE, ANON) | . mmap(SHARED, ANON)
-----------------------+----------------------
. mmap(PRIVATE, fd) | . mmap(SHARED, fd)
@ -317,13 +317,15 @@ The memory in quadrant #4, when modified, acts as its own dedicated \*(MS.
The following may help in interpreting process level memory values displayed
as columns and discussed in topic `3a. DESCRIPTIONS of Fields'.
.nf
%MEM \- simply RES divided by total \*(MP
CODE \- the `pgms' portion of quadrant \fB3\fR
DATA \- the quadrant \fB1\fR portion of VIRT
DATA \- the entire quadrant \fB1\fR portion of VIRT plus all
explicit mmap file-backed pages of quadrant \fB3\fR
RES \- anything occupying \*(MP (all quadrants)
SHR \- subset of RES (excludes \fB1\fR, includes all \fB2\fR & \fB4\fR, some \fB3\fR)
SWAP \- excludes quadrant \fB4\fR
SWAP \- potentially any quadrant except \fB4\fR
USED \- simply the sum of RES and SWAP
VIRT \- everything in-use and/or reserved (all quadrants)
.fi
@ -677,7 +679,7 @@ any truncated data.
.TP 4
6.\fB DATA \*(Em Data + Stack Size (KiB) \fR
The amount of private anonymous memory \fIreserved\fR by a process.
The amount of private memory \fIreserved\fR by a process.
It is also known as the Data Resident Set or DRS.
Such memory may not yet be mapped to \*(MP (RES) but will always be
included in the \*(MV (VIRT) amount.