proc.5: Update pagemap and related documentation

PATCH Applied Oliver Ebert 2 participants 9 messages Sep 24, 2017 – Sep 25, 2017 5 messages not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore

Share & tools

lore

Oliver Ebert

author

2017-09-24 21:41 UTC #0 lore raw

cover proc.5: Update pagemap and related documentation

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(-)

Signature · 6 lines

2.13.5

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

Oliver Ebert

author

2017-09-24 21:41 UTC #2 lore raw

PATCH 1/4 proc.5: tfix

see linux 63f8e8d2a575ef62e5b705516b491a98a60517ff

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

man5/proc.5 +1 -1

index 4d482d3a4..73b51eaca 100644
@@ -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)

Signature · 6 lines

2.13.5

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

Michael Kerrisk (man-pages)

2017-09-25 06:18 UTC #4 lore raw

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

Hello Oliver,

Quoted 1 line · Oliver Ebert

see linux 63f8e8d2a575ef62e5b705516b491a98a60517ff

Thanks. Applied.

Cheers,

Michael

Quoted 18 lines

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

man5/proc.5 +1 -1

index 4d482d3a4..73b51eaca 100644
@@ -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)

Signature · 7 lines

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 [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Oliver Ebert

author

2017-09-24 21:41 UTC #5 lore raw

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

In reply to a message not in the archive

see linux 56873f43abdcd574b25105867a990f067747b2f4 and linux f074a8f49eb87cde95ac9d040ad5e7ea4f029738

---
 man5/proc.5 | 3 +++
 1 file changed, 3 insertions(+)

man5/proc.5 +3 -0

index 73b51eaca..f0b84d503 100644
@@ -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

Signature · 6 lines

2.13.5

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

Michael Kerrisk (man-pages)

Applied

2017-09-25 06:42 UTC #7 lore raw

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

Hello Oliver,

Quoted 2 lines · Oliver Ebert

see linux 56873f43abdcd574b25105867a990f067747b2f4 and linux f074a8f49eb87cde95ac9d040ad5e7ea4f029738

Thanks! Applied with the correction noted below.

man5/proc.5 The bits are as follows: · line 2968

Quoted 13 lines

---
 man5/proc.5 | 3 +++
 1 file changed, 3 insertions(+)

man5/proc.5 +1 -0

index 73b51eaca..f0b84d503 100644
@@ -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.

man5/proc.5 The bits are as follows: · line 2973

Quoted 5 lines

man5/proc.5 +2 -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

Thanks,

Michael

Signature · 7 lines

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 [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Oliver Ebert

author

2017-09-24 21:41 UTC #8 lore raw

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

In reply to a message not in the archive

see linux 77bb499bb60f4b79cca7d139c8041662860fcf87 and linux 83b4b0bb635eee2b8e075062e4e008d1bc110ed7

---
 man5/proc.5 | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

man5/proc.5 +4 -1

index f0b84d503..0b31dad2f 100644
@@ -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

Signature · 6 lines

2.13.5

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

Michael Kerrisk (man-pages)

2017-09-25 07:16 UTC #10 lore raw

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

Quoted 5 lines · Oliver Ebert

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

Thanks, Oliver. Applied.

Cheers,

Michael

Quoted 20 lines

man5/proc.5 +4 -1

index f0b84d503..0b31dad2f 100644
@@ -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

Signature · 7 lines

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 [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Oliver Ebert

author

2017-09-24 21:41 UTC #11 lore raw

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

In reply to a message not in the archive

see linux 80ae2fdceba8313b0433f899bdd9c6c463291a17

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

man5/proc.5 +12 -0

index 0b31dad2f..dd7764d0f 100644
@@ -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,

Signature · 6 lines

2.13.5

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

Michael Kerrisk (man-pages)

2017-09-25 07:26 UTC #13 lore raw

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

Quoted 1 line · Oliver Ebert

see linux 80ae2fdceba8313b0433f899bdd9c6c463291a17

Thanks, Oliver. Applied.

Cheers,

Michael

Quoted 28 lines

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

man5/proc.5 +12 -0

index 0b31dad2f..dd7764d0f 100644
@@ -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,

Signature · 7 lines

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 [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html