Skip to contentSkip to conversation

Correct description of SwapFree in Documentation/filesystems/proc.txt

PATCH In review Michael Kerrisk 4 participants 5 messages Nov 16, 2012 – Nov 19, 2012

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Correct description of SwapFree in Documentation/filesystems/proc.txt

After migrating most of the information in Documentation/filesystems/proc.txt to the proc(5) man page, Jim Paris pointed out to me that the description of SwapFree in the man page seemed wrong. I think Jim is right, but am given pause by fact that that text has been in Documentation/filesystems/proc.txt since at least 2.6.0. Anyway, I believe that the patch below fixes things.

Documentation/filesystems/proc.txt +1 -2
index a1793d6..cf4260f 100644
@@ -778,8 +778,7 @@ AnonHugePages:   49152 kB
               other things, it is where everything from the Slab is
               allocated.  Bad things happen when you're out of lowmem.
    SwapTotal: total amount of swap space available
-    SwapFree: Memory which has been evicted from RAM, and is temporarily
-              on the disk
+    SwapFree: Amount of swap space that is currently unused.
        Dirty: Memory which is waiting to get written back to the disk
    Writeback: Memory which is actively being written back to the disk
    AnonPages: Non-file backed pages mapped into userspace page tables

--
To unsubscribe, send a message with 'unsubscribe linux-mm' in the body to [email protected]. For more info on Linux MM,
see: http://www.linux-mm.org/ .
Don't email: <a href=mailto:"[email protected]"> [email protected] </a>

Reviewed-by on v1 1/1
#1 lore raw
Quoted 7 lines · Michael Kerrisk

After migrating most of the information in Documentation/filesystems/proc.txt to the proc(5) man page, Jim Paris pointed out to me that the description of SwapFree in the man page seemed wrong. I think Jim is right, but am given pause by fact that that text has been in Documentation/filesystems/proc.txt since at least 2.6.0. Anyway, I believe that the patch below fixes things.

Yes, this goes back to 2003 when the /proc/meminfo doc has been added.

Quoted 2 lines
Quoted 20 lines
Documentation/filesystems/proc.txt +1 -3
index a1793d6..cf4260f 100644
@@ -778,8 +778,7 @@ AnonHugePages:   49152 kB
               other things, it is where everything from the Slab is
               allocated.  Bad things happen when you're out of lowmem.
    SwapTotal: total amount of swap space available
-    SwapFree: Memory which has been evicted from RAM, and is temporarily
-              on the disk
+    SwapFree: Amount of swap space that is currently unused.
        Dirty: Memory which is waiting to get written back to the disk
    Writeback: Memory which is actively being written back to the disk
    AnonPages: Non-file backed pages mapped into userspace page tables
 
--

To unsubscribe, send a message with 'unsubscribe linux-mm' in the body to [email protected]. For more info on Linux MM,
see: http://www.linux-mm.org/ .
Don't email: <a href=mailto:"[email protected]"> [email protected] </a>

Signature · 8 lines
Michal Hocko
SUSE Labs

--
To unsubscribe, send a message with 'unsubscribe linux-mm' in
the body to [email protected].  For more info on Linux MM,
see: http://www.linux-mm.org/ .
Don't email: <a href=mailto:"[email protected]"> [email protected] </a>
Acked-by on v1 1/1
#2 lore raw
In reply to Michael Kerrisk
Quoted 10 lines · Michael Kerrisk

After migrating most of the information in Documentation/filesystems/proc.txt to the proc(5) man page, Jim Paris pointed out to me that the description of SwapFree in the man page seemed wrong. I think Jim is right, but am given pause by fact that that text has been in Documentation/filesystems/proc.txt since at least 2.6.0. Anyway, I believe that the patch below fixes things.

Quoted 16 lines
Documentation/filesystems/proc.txt +1 -3
index a1793d6..cf4260f 100644
@@ -778,8 +778,7 @@ AnonHugePages:   49152 kB
                other things, it is where everything from the Slab is
                allocated.  Bad things happen when you're out of lowmem.
     SwapTotal: total amount of swap space available
-    SwapFree: Memory which has been evicted from RAM, and is temporarily
-              on the disk
+    SwapFree: Amount of swap space that is currently unused.
         Dirty: Memory which is waiting to get written back to the disk
     Writeback: Memory which is actively being written back to the disk
     AnonPages: Non-file backed pages mapped into userspace page tables
--
Quoted 5 lines

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

--
To unsubscribe, send a message with 'unsubscribe linux-mm' in the body to [email protected]. For more info on Linux MM,
see: http://www.linux-mm.org/ .
Don't email: <a href=mailto:"[email protected]"> [email protected] </a>

Acked-by on v1 1/1
#3 lore raw
In reply to Michael Kerrisk
Quoted 9 lines · Michael Kerrisk

After migrating most of the information in Documentation/filesystems/proc.txt to the proc(5) man page, Jim Paris pointed out to me that the description of SwapFree in the man page seemed wrong. I think Jim is right, but am given pause by fact that that text has been in Documentation/filesystems/proc.txt since at least 2.6.0. Anyway, I believe that the patch below fixes things.

Want me to forward it on? (Lots of documentation stuff gets grabbed by whoever maintains what it's documenting, this looks like it might fall through the cracks...)

Rob
--
To unsubscribe, send a message with 'unsubscribe linux-mm' in the body to [email protected]. For more info on Linux MM,
see: http://www.linux-mm.org/ .
Don't email: <a href=mailto:"[email protected]"> [email protected] </a>

#4 lore raw

Rob,

Quoted 10 lines · Rob Landley
Quoted 9 lines · Michael Kerrisk

After migrating most of the information in Documentation/filesystems/proc.txt to the proc(5) man page, Jim Paris pointed out to me that the description of SwapFree in the man page seemed wrong. I think Jim is right, but am given pause by fact that that text has been in Documentation/filesystems/proc.txt since at least 2.6.0. Anyway, I believe that the patch below fixes things.

Quoted 8 lines
Quoted 1 line

Want me to forward it on? (Lots of documentation stuff gets grabbed by whoever maintains what it's documenting, this looks like it might fall through the cracks...)

That would be great.

Thanks,

Michael

Signature · 9 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/

--
To unsubscribe, send a message with 'unsubscribe linux-mm' in
the body to [email protected].  For more info on Linux MM,
see: http://www.linux-mm.org/ .
Don't email: <a href=mailto:"[email protected]"> [email protected] </a>