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

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

[Sven Hoexter]

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

Signed-off-by: Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/4f9A@public.gmane.org>
---
 man5/proc.5 | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/man5/proc.5 b/man5/proc.5
index 96077d0..b16f2a7 100644
--- a/man5/proc.5
+++ b/man5/proc.5
@@ -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 *
-- 
2.1.3

--
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] proc.5: Add "VmSwap" to /proc/[pid]/status

[Michael Kerrisk (man-pages)]

Sven,

On 12/14/2014 03:20 PM, Sven Hoexter wrote:
> Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.
> 
> Signed-off-by: Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/4f9A@public.gmane.org>
> ---
>  man5/proc.5 | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/man5/proc.5 b/man5/proc.5
> index 96077d0..b16f2a7 100644
> --- a/man5/proc.5
> +++ b/man5/proc.5
> @@ -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 *

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



-- 
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] proc.5: Add "VmSwap" to /proc/[pid]/status

[Sven Hoexter]

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

Hi,

> On 12/14/2014 03:20 PM, Sven Hoexter wrote:
> > Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.
> > 
> > Signed-off-by: Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/4f9A@public.gmane.org>
> > ---
> >  man5/proc.5 | 4 ++++
> >  1 file changed, 4 insertions(+)
> > 
> > diff --git a/man5/proc.5 b/man5/proc.5
> > index 96077d0..b16f2a7 100644
> > --- a/man5/proc.5
> > +++ b/man5/proc.5
> > @@ -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 *
> 
> 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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

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

[Michael Kerrisk (man-pages)]

On 12/24/2014 01:24 AM, Sven Hoexter wrote:
> On Tue, Dec 23, 2014 at 04:06:33PM +0100, Michael Kerrisk (man-pages) wrote:
> 
> Hi,
> 
>> On 12/14/2014 03:20 PM, Sven Hoexter wrote:
>>> Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.
>>>
>>> Signed-off-by: Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/4f9A@public.gmane.org>
>>> ---
>>>  man5/proc.5 | 4 ++++
>>>  1 file changed, 4 insertions(+)
>>>
>>> diff --git a/man5/proc.5 b/man5/proc.5
>>> index 96077d0..b16f2a7 100644
>>> --- a/man5/proc.5
>>> +++ b/man5/proc.5
>>> @@ -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 *
>>
>> 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.

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

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] proc.5: Add "VmSwap" to /proc/[pid]/status

[Kamezawa Hiroyuki]

On 2014/12/24 23:26, Michael Kerrisk (man-pages) wrote:
> On 12/24/2014 01:24 AM, Sven Hoexter wrote:
>> On Tue, Dec 23, 2014 at 04:06:33PM +0100, Michael Kerrisk (man-pages) wrote:
>>
>> Hi,
>>
>>> On 12/14/2014 03:20 PM, Sven Hoexter wrote:
>>>> Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.
>>>>
>>>> Signed-off-by: Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/4f9A@public.gmane.org>
>>>> ---
>>>>   man5/proc.5 | 4 ++++
>>>>   1 file changed, 4 insertions(+)
>>>>
>>>> diff --git a/man5/proc.5 b/man5/proc.5
>>>> index 96077d0..b16f2a7 100644
>>>> --- a/man5/proc.5
>>>> +++ b/man5/proc.5
>>>> @@ -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 *
>>>
>>> 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.
>
> 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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

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

[Michael Kerrisk (man-pages)]

Hello Kame,

On Thu, Dec 25, 2014 at 1:15 AM, Kamezawa Hiroyuki
<kamezawa.hiroyu-+CUm20s59erQFUHtdCDX3A@public.gmane.org> wrote:
> On 2014/12/24 23:26, Michael Kerrisk (man-pages) wrote:
>>
>> On 12/24/2014 01:24 AM, Sven Hoexter wrote:
>>>
>>> On Tue, Dec 23, 2014 at 04:06:33PM +0100, Michael Kerrisk (man-pages)
>>> wrote:
>>>
>>> Hi,
>>>
>>>> On 12/14/2014 03:20 PM, Sven Hoexter wrote:
>>>>>
>>>>> Documented as is in Documentation/filesystems/proc.txt of Linux 3.18.
>>>>>
>>>>> Signed-off-by: Sven Hoexter <sven-jJOYKVDXsn5H4x6Dk/4f9A@public.gmane.org>
>>>>> ---
>>>>>   man5/proc.5 | 4 ++++
>>>>>   1 file changed, 4 insertions(+)
>>>>>
>>>>> diff --git a/man5/proc.5 b/man5/proc.5
>>>>> index 96077d0..b16f2a7 100644
>>>>> --- a/man5/proc.5
>>>>> +++ b/man5/proc.5
>>>>> @@ -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 *
>>>>
>>>>
>>>> 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.
>>
>>
>> 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"  ?


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 majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html