proc.5: Add "VmSwap" to /proc/[pid]/status

PATCH In review Sven Hoexter 3 participants 6 messages Dec 14, 2014 – Dec 26, 2014 5 messages not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore

Share & tools

lore

Sven Hoexter

author

2014-12-14 14:20 UTC #0 lore raw

PATCH 1/1 proc.5: Add "VmSwap" to /proc/[pid]/status

Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.

Signed-off-by Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/[email protected]>

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

man5/proc.5 +4 -0

index 96077d0..b16f2a7 100644
@@ -1587,6 +1587,7 @@ VmStk:        88 kB
 VmExe:       572 kB
 VmLib:      1708 kB
 VmPTE:        20 kB
+VmSwap:        0 kB
 Threads:        1
 SigQ:   0/3067
 SigPnd: 0000000000000000

@@ -1672,6 +1673,9 @@ Shared library code size.
 .IR VmPTE :
 Page table entries size (since Linux 2.6.10).
 .IP *
+.IR VmSwap :
+Size of swap usage (the number of referred swapents).
+.IP *
 .IR Threads :
 Number of threads in process containing this thread.
 .IP *

Signature · 6 lines

2.1.3

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

2014-12-23 15:06 UTC #2 lore raw

Sven,

Quoted 20 lines · Sven Hoexter

Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.
Signed-off-by Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/[email protected]>
---
 man5/proc.5 | 4 ++++
 1 file changed, 4 insertions(+)
man5/proc.5 +1 -0
index 96077d0..b16f2a7 100644
@@ -1587,6 +1587,7 @@ VmStk:        88 kB
 VmExe:       572 kB
 VmLib:      1708 kB
 VmPTE:        20 kB
+VmSwap:        0 kB
 Threads:        1
 SigQ:   0/3067
 SigPnd: 0000000000000000

man5/proc.5 Shared library code size. · line 1681

Quoted 9 lines

man5/proc.5 +3 -0

@@ -1672,6 +1673,9 @@ Shared library code size.
 .IR VmPTE :
 Page table entries size (since Linux 2.6.10).
 .IP *
+.IR VmSwap :
+Size of swap usage (the number of referred swapents).
+.IP *
 .IR Threads :
 Number of threads in process containing this thread.
 .IP *

Thanks for this patch. I've applied, and added text that the field appeared in Linux 2.6.34. However, I have a question: what does the text "(the number of referred swapents)" mean? Is this field not just reporting a value in kB (i.e., the number of kB across all swap entries)?

Cheers,

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

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

Sven Hoexter

author

2014-12-24 00:24 UTC #4 lore raw

On Tue, Dec 23, 2014 at 04:06:33PM +0100, Michael Kerrisk (man-pages) wrote:

Hi,

Quoted 28 lines · Sven Hoexter

Quoted 27 lines

Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.

Signed-off-by Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/[email protected]>

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

man5/proc.5 +4 -0

index 96077d0..b16f2a7 100644
@@ -1587,6 +1587,7 @@ VmStk:        88 kB
 VmExe:       572 kB
 VmLib:      1708 kB
 VmPTE:        20 kB
+VmSwap:        0 kB
 Threads:        1
 SigQ:   0/3067
 SigPnd: 0000000000000000

@@ -1672,6 +1673,9 @@ Shared library code size.
 .IR VmPTE :
 Page table entries size (since Linux 2.6.10).
 .IP *
+.IR VmSwap :
+Size of swap usage (the number of referred swapents).
+.IP *
 .IR Threads :

Quoted 8 lines

man5/proc.5 Shared library code size. · line 1681
Quoted 2 lines
man5/proc.5 +0 -0
 Number of threads in process containing this thread.
 .IP *
Thanks for this patch. I've applied, and added text that the field appeared in Linux 2.6.34. However, I have a question: what does the text "(the number of referred swapents)" mean? Is this field not just reporting a value in kB (i.e., the number of kB across all swap entries)?

I copied the text verbatim from what I found in the proc.txt documentation. To be honest so far I failed to understand what exactly is counted and did not trust the kB unit at all. (It did not matter for my usecase.)

Maybe KAMEZAWA Hiroyuki can shed some light on what exactly is counted here and if the kB unit makes sense here and why?

Looking at commit b084d4353ff99d824d3bc5a5c2c22c70b1fba722 it seems to be a value incremented/decremented with every page table entry moved to swap/moved out of swap, but I'm far away from claiming that this is stuff I understand.

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

2014-12-24 14:26 UTC #6 lore raw

Quoted 46 lines · Sven Hoexter

On Tue, Dec 23, 2014 at 04:06:33PM +0100, Michael Kerrisk (man-pages) wrote:
Hi,
Quoted 28 lines · Sven Hoexter
Quoted 27 lines
Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.
Signed-off-by Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/[email protected]>
---
 man5/proc.5 | 4 ++++
 1 file changed, 4 insertions(+)
man5/proc.5 +4 -0
index 96077d0..b16f2a7 100644
@@ -1587,6 +1587,7 @@ VmStk:        88 kB
 VmExe:       572 kB
 VmLib:      1708 kB
 VmPTE:        20 kB
+VmSwap:        0 kB
 Threads:        1
 SigQ:   0/3067
 SigPnd: 0000000000000000
@@ -1672,6 +1673,9 @@ Shared library code size.
 .IR VmPTE :
 Page table entries size (since Linux 2.6.10).
 .IP *
+.IR VmSwap :
+Size of swap usage (the number of referred swapents).
+.IP *
 .IR Threads :
Quoted 8 lines
man5/proc.5 Shared library code size. · line 1681
Quoted 2 lines
man5/proc.5 +0 -0
 Number of threads in process containing this thread.
 .IP *
Thanks for this patch. I've applied, and added text that the field appeared in Linux 2.6.34. However, I have a question: what does the text "(the number of referred swapents)" mean? Is this field not just reporting a value in kB (i.e., the number of kB across all swap entries)?
I copied the text verbatim from what I found in the proc.txt documentation. To be honest so far I failed to understand what exactly is counted and did not trust the kB unit at all. (It did not matter for my usecase.)

Quoted 7 lines

Maybe KAMEZAWA Hiroyuki can shed some light on what exactly is counted here and if the kB unit makes sense here and why?
Looking at commit b084d4353ff99d824d3bc5a5c2c22c70b1fba722 it seems to be a value incremented/decremented with every page table entry moved to swap/moved out of swap, but I'm far away from claiming that this is stuff I understand.

Okay. Pending any input from KAMEZAWA Hiroyuki, I have simply removed the text "(the number of referred swapents)".

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

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

Kamezawa Hiroyuki

2014-12-25 00:15 UTC #8 lore raw

Quoted 50 lines · Michael Kerrisk (man-pages)

Quoted 49 lines · Sven Hoexter
On Tue, Dec 23, 2014 at 04:06:33PM +0100, Michael Kerrisk (man-pages) wrote:
Hi,
Quoted 28 lines · Sven Hoexter
Quoted 27 lines
Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.
Signed-off-by Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/[email protected]>
---
  man5/proc.5 | 4 ++++
  1 file changed, 4 insertions(+)
man5/proc.5 +4 -0
index 96077d0..b16f2a7 100644
@@ -1587,6 +1587,7 @@ VmStk:        88 kB
  VmExe:       572 kB
  VmLib:      1708 kB
  VmPTE:        20 kB
+VmSwap:        0 kB
  Threads:        1
  SigQ:   0/3067
  SigPnd: 0000000000000000
@@ -1672,6 +1673,9 @@ Shared library code size.
  .IR VmPTE :
  Page table entries size (since Linux 2.6.10).
  .IP *
+.IR VmSwap :
+Size of swap usage (the number of referred swapents).
+.IP *
  .IR Threads :
Quoted 8 lines
man5/proc.5 Shared library code size. · line 1681
Quoted 2 lines
man5/proc.5 +0 -0
  Number of threads in process containing this thread.
  .IP *
Thanks for this patch. I've applied, and added text that the field appeared in Linux 2.6.34. However, I have a question: what does the text "(the number of referred swapents)" mean? Is this field not just reporting a value in kB (i.e., the number of kB across all swap entries)?
I copied the text verbatim from what I found in the proc.txt documentation. To be honest so far I failed to understand what exactly is counted and did not trust the kB unit at all. (It did not matter for my usecase.)
Maybe KAMEZAWA Hiroyuki can shed some light on what exactly is counted here and if the kB unit makes sense here and why?

Quoted 8 lines

Quoted 4 lines
Looking at commit b084d4353ff99d824d3bc5a5c2c22c70b1fba722 it seems to be a value incremented/decremented with every page table entry moved to swap/moved out of swap, but I'm far away from claiming that this is stuff I understand.
Okay. Pending any input from KAMEZAWA Hiroyuki, I have simply removed the text "(the number of referred swapents)".

The counter is

+1 when a page table entry is modified to refer a swap.
-1 when a page table entry, which referes swap, is modified to some other.

Then, proc.text says "the number of referred swapents". But this may not be suitable for man pages.

How about, "swapped-out virtual memory size" ?

Regards,
-Kame

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

2014-12-26 06:20 UTC #10 lore raw

Hello Kame,

Quoted 69 lines · Kamezawa Hiroyuki

Quoted 56 lines · Michael Kerrisk (man-pages)
Quoted 54 lines · Sven Hoexter
On Tue, Dec 23, 2014 at 04:06:33PM +0100, Michael Kerrisk (man-pages) wrote:
Hi,
Quoted 30 lines · Sven Hoexter
Quoted 29 lines
Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.
Signed-off-by Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/[email protected]>
---
  man5/proc.5 | 4 ++++
  1 file changed, 4 insertions(+)
man5/proc.5 +4 -0
index 96077d0..b16f2a7 100644
@@ -1587,6 +1587,7 @@ VmStk:        88 kB
  VmExe:       572 kB
  VmLib:      1708 kB
  VmPTE:        20 kB
+VmSwap:        0 kB
  Threads:        1
  SigQ:   0/3067
  SigPnd: 0000000000000000
@@ -1672,6 +1673,9 @@ Shared library code size.
  .IR VmPTE :
  Page table entries size (since Linux 2.6.10).
  .IP *
+.IR VmSwap :
+Size of swap usage (the number of referred swapents).
+.IP *
  .IR Threads :
  Number of threads in process containing this thread.
Quoted 8 lines
man5/proc.5 Shared library code size. · line 1681
Quoted 1 line
man5/proc.5 +0 -0
  .IP *
Thanks for this patch. I've applied, and added text that the field appeared in Linux 2.6.34. However, I have a question: what does the text "(the number of referred swapents)" mean? Is this field not just reporting a value in kB (i.e., the number of kB across all swap entries)?
I copied the text verbatim from what I found in the proc.txt documentation. To be honest so far I failed to understand what exactly is counted and did not trust the kB unit at all. (It did not matter for my usecase.)
Maybe KAMEZAWA Hiroyuki can shed some light on what exactly is counted here and if the kB unit makes sense here and why?
Quoted 9 lines
Quoted 4 lines
Looking at commit b084d4353ff99d824d3bc5a5c2c22c70b1fba722 it seems to be a value incremented/decremented with every page table entry moved to swap/moved out of swap, but I'm far away from claiming that this is stuff I understand.
Okay. Pending any input from KAMEZAWA Hiroyuki, I have simply removed the text "(the number of referred swapents)".
The counter is

Quoted 7 lines

+1 when a page table entry is modified to refer a swap.
-1 when a page table entry, which referes swap, is modified to some other.
Then, proc.text says "the number of referred swapents". But this may not be suitable for man pages.
How about, "swapped-out virtual memory size" ?

Thanks. Amended as you suggest.

Cheers,

Michael
--
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