tags 741360 fixed-upstream
thanks
Hello Zefram,
On 11 March 2014 at 16:48, Zefram <zef...@fysh.org> wrote:
> Package: manpages
> Version: 3.44-1
> Severity: minor
>
> proc(5) says:
>
> /proc/[pid]/statm
> Provides information about memory usage, measured in pages. The
> columns are:
>
> size total program size
> (same as VmSize in /proc/[pid]/status)
> resident resident set size
> (same as VmRSS in /proc/[pid]/status)
> share shared pages (from shared mappings)
>
> Actually the "share" value doesn't count all shared pages mapped by the
> process: it only counts *resident* shared pages. It should be documented
> as such. The current documentation makes it look as though one can
> subtract share from size to find out how much unshared memory the process
> uses, but actually doing so gives a bogus figure. I'm currently debugging
> some code (the Perl module Apache::SizeLimit) that makes that mistake.
Thanks for the report. I've applied the patch below for upstream man-pages.
Cheers,
Michael
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -2003,7 +2003,8 @@ size (1) total program size
(same as VmSize in \fI/proc/[pid]/status\fP)
resident (2) resident set size
(same as VmRSS in \fI/proc/[pid]/status\fP)
-shared (3) shared pages (i.e., backed by a file)
+shared (3) number of resident shared pages (i.e., backed by a file)
+ (same as RssFile+RssShmem in \fI/proc/[pid]/status\fP)
text (4) text (code)
.\" (not including libs; broken, includes data segment)
lib (5) library (unused in Linux 2.6)
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
