[PATCH 0/4] proc.5: Update pagemap and related documentation

[PATCH 0/4] proc.5: Update pagemap and related documentation

[Oliver Ebert]

Hello,

while debugging some memory mapping issues I noticed that the
/proc/[pid]/pagemap and related documentation in proc.5 is not
up-to-date with the kernel's Documentation/vm/pagemap.txt file.
This series of patches adds the missing pieces.

Oliver Ebert (4):
  proc.5: tfix
  proc.5: Add KPF_BALLOON, KPF_ZERO_PAGE and KPF_IDLE for
    /proc/kpageflags
  proc.5: Add mmap-exclusive bit for /proc/[pid]/pagemap
  proc.5: Document /proc/kpagecgroup

 man5/proc.5 | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

-- 
2.13.5

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 1/4] proc.5: tfix

[Oliver Ebert]

see linux 63f8e8d2a575ef62e5b705516b491a98a60517ff
---
 man5/proc.5 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/man5/proc.5 b/man5/proc.5
index 4d482d3a4..73b51eaca 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -2959,7 +2959,7 @@ The bits are as follows:
     14 - KPF_SWAPBACKED     (since Linux 2.6.31)
     15 - KPF_COMPOUND_HEAD  (since Linux 2.6.31)
     16 - KPF_COMPOUND_TAIL  (since Linux 2.6.31)
-    16 - KPF_HUGE           (since Linux 2.6.31)
+    17 - KPF_HUGE           (since Linux 2.6.31)
     18 - KPF_UNEVICTABLE    (since Linux 2.6.31)
     19 - KPF_HWPOISON       (since Linux 2.6.31)
     20 - KPF_NOPAGE         (since Linux 2.6.31)
-- 
2.13.5

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 2/4] proc.5: Add KPF_BALLOON, KPF_ZERO_PAGE and KPF_IDLE for /proc/kpageflags

[Oliver Ebert]

see linux 56873f43abdcd574b25105867a990f067747b2f4
and linux f074a8f49eb87cde95ac9d040ad5e7ea4f029738
---
 man5/proc.5 | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/man5/proc.5 b/man5/proc.5
index 73b51eaca..f0b84d503 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -2965,6 +2965,9 @@ The bits are as follows:
     20 - KPF_NOPAGE         (since Linux 2.6.31)
     21 - KPF_KSM            (since Linux 2.6.32)
     22 - KPF_THP            (since Linux 3.4)
+    23 - KPF_BALLOON        (since Linux 4.0)
+    24 - KPF_ZERO_PAGE      (since Linux 4.0)
+    25 - KPF_IDLE           (since Linux 4.3)
 .IP
 For further details on the meanings of these bits,
 see the kernel source file
-- 
2.13.5

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 3/4] proc.5: Add mmap-exclusive bit for /proc/[pid]/pagemap

[Oliver Ebert]

see linux 77bb499bb60f4b79cca7d139c8041662860fcf87
and linux 83b4b0bb635eee2b8e075062e4e008d1bc110ed7
---
 man5/proc.5 | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/man5/proc.5 b/man5/proc.5
index f0b84d503..0b31dad2f 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -1490,10 +1490,13 @@ If set, the page is in swap space
 61 (since Linux 3.5)
 The page is a file-mapped page or a shared anonymous page.
 .TP
-60\(en56 (since Linux 3.11)
+60\(en57 (since Linux 3.11)
 Zero
 .\" Not quite true; see commit 541c237c0923f567c9c4cabb8a81635baadc713f
 .TP
+56 (since Linux 4.2)
+The page is exclusively mapped.
+.TP
 55 (since Linux 3.11)
 PTE is soft-dirty
 (see the kernel source file
-- 
2.13.5

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

[PATCH 4/4] proc.5: Document /proc/kpagecgroup

[Oliver Ebert]

see linux 80ae2fdceba8313b0433f899bdd9c6c463291a17
---
 man5/proc.5 | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/man5/proc.5 b/man5/proc.5
index 0b31dad2f..dd7764d0f 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -2927,6 +2927,18 @@ Information in this file is retrieved with the
 .BR dmesg (1)
 program.
 .TP
+.IR /proc/kpagecgroup " (since Linux 4.3)"
+This file contains a 64-bit inode number of
+the memory cgroup each page is charged to,
+indexed by page frame number (see the discussion of
+.IR /proc/[pid]/pagemap ).
+.IP
+The
+.IR /proc/kpagecgroup
+file is present only if the
+.B CONFIG_MEMCG
+kernel configuration option is enabled.
+.TP
 .IR /proc/kpagecount " (since Linux 2.6.25)"
 This file contains a 64-bit count of the number of
 times each physical page frame is mapped,
-- 
2.13.5

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 1/4] proc.5: tfix

[Michael Kerrisk (man-pages)]

Hello Oliver,

On 09/24/2017 11:41 PM, Oliver Ebert wrote:
> see linux 63f8e8d2a575ef62e5b705516b491a98a60517ff

Thanks. Applied.

Cheers,

Michael


> ---
>  man5/proc.5 | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index 4d482d3a4..73b51eaca 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -2959,7 +2959,7 @@ The bits are as follows:
>      14 - KPF_SWAPBACKED     (since Linux 2.6.31)
>      15 - KPF_COMPOUND_HEAD  (since Linux 2.6.31)
>      16 - KPF_COMPOUND_TAIL  (since Linux 2.6.31)
> -    16 - KPF_HUGE           (since Linux 2.6.31)
> +    17 - KPF_HUGE           (since Linux 2.6.31)
>      18 - KPF_UNEVICTABLE    (since Linux 2.6.31)
>      19 - KPF_HWPOISON       (since Linux 2.6.31)
>      20 - KPF_NOPAGE         (since Linux 2.6.31)
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 2/4] proc.5: Add KPF_BALLOON, KPF_ZERO_PAGE and KPF_IDLE for /proc/kpageflags

[Michael Kerrisk (man-pages)]

Hello Oliver,

On 09/24/2017 11:41 PM, Oliver Ebert wrote:
> see linux 56873f43abdcd574b25105867a990f067747b2f4
> and linux f074a8f49eb87cde95ac9d040ad5e7ea4f029738

Thanks! Applied with the correction noted below.

> ---
>  man5/proc.5 | 3 +++
>  1 file changed, 3 insertions(+)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index 73b51eaca..f0b84d503 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -2965,6 +2965,9 @@ The bits are as follows:
>      20 - KPF_NOPAGE         (since Linux 2.6.31)
>      21 - KPF_KSM            (since Linux 2.6.32)
>      22 - KPF_THP            (since Linux 3.4)
> +    23 - KPF_BALLOON        (since Linux 4.0)

As far as I can see, KPF_BALLOON was added in 
3.18, so I amended the text to say that.

> +    24 - KPF_ZERO_PAGE      (since Linux 4.0)
> +    25 - KPF_IDLE           (since Linux 4.3)
>  .IP
>  For further details on the meanings of these bits,
>  see the kernel source file

Thanks,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 3/4] proc.5: Add mmap-exclusive bit for /proc/[pid]/pagemap

[Michael Kerrisk (man-pages)]

On 09/24/2017 11:41 PM, Oliver Ebert wrote:
> see linux 77bb499bb60f4b79cca7d139c8041662860fcf87
> and linux 83b4b0bb635eee2b8e075062e4e008d1bc110ed7
> ---
>  man5/proc.5 | 5 ++++-
>  1 file changed, 4 insertions(+), 1 deletion(-)

Thanks, Oliver. Applied.

Cheers,

Michael


> diff --git a/man5/proc.5 b/man5/proc.5
> index f0b84d503..0b31dad2f 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -1490,10 +1490,13 @@ If set, the page is in swap space
>  61 (since Linux 3.5)
>  The page is a file-mapped page or a shared anonymous page.
>  .TP
> -60\(en56 (since Linux 3.11)
> +60\(en57 (since Linux 3.11)
>  Zero
>  .\" Not quite true; see commit 541c237c0923f567c9c4cabb8a81635baadc713f
>  .TP
> +56 (since Linux 4.2)
> +The page is exclusively mapped.
> +.TP
>  55 (since Linux 3.11)
>  PTE is soft-dirty
>  (see the kernel source file
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: [PATCH 4/4] proc.5: Document /proc/kpagecgroup

[Michael Kerrisk (man-pages)]

On 09/24/2017 11:41 PM, Oliver Ebert wrote:
> see linux 80ae2fdceba8313b0433f899bdd9c6c463291a17

Thanks, Oliver. Applied.

Cheers,

Michael

> ---
>  man5/proc.5 | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index 0b31dad2f..dd7764d0f 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -2927,6 +2927,18 @@ Information in this file is retrieved with the
>  .BR dmesg (1)
>  program.
>  .TP
> +.IR /proc/kpagecgroup " (since Linux 4.3)"
> +This file contains a 64-bit inode number of
> +the memory cgroup each page is charged to,
> +indexed by page frame number (see the discussion of
> +.IR /proc/[pid]/pagemap ).
> +.IP
> +The
> +.IR /proc/kpagecgroup
> +file is present only if the
> +.B CONFIG_MEMCG
> +kernel configuration option is enabled.
> +.TP
>  .IR /proc/kpagecount " (since Linux 2.6.25)"
>  This file contains a 64-bit count of the number of
>  times each physical page frame is mapped,
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html