Re: [PATCH] memcg: fix a typo in documentation

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



(12/12/11 5:51 AM), Johannes Weiner wrote:
On Fri, Dec 09, 2011 at 04:15:20PM -0800, Ying Han wrote:
A tiny typo on mapped_file stat.

Signed-off-by: Ying Han<yinghan@xxxxxxxxxx>
---
  Documentation/cgroups/memory.txt |    2 +-
  1 files changed, 1 insertions(+), 1 deletions(-)

diff --git a/Documentation/cgroups/memory.txt b/Documentation/cgroups/memory.txt
index 070c016..c0f409e 100644
--- a/Documentation/cgroups/memory.txt
+++ b/Documentation/cgroups/memory.txt
@@ -410,7 +410,7 @@ hierarchical_memsw_limit - # of bytes of memory+swap limit with regard to

  total_cache		- sum of all children's "cache"
  total_rss		- sum of all children's "rss"
-total_mapped_file	- sum of all children's "cache"
+total_mapped_file	- sum of all children's "mapped_file"
  total_mlock		- sum of all children's "mlock"
  total_pgpgin		- sum of all children's "pgpgin"
  total_pgpgout		- sum of all children's "pgpgout"

Your fix obviously makes sense, but the line is still incorrect: it's
not just the sum of all children but that of the full hierarchy
starting with the consulted memcg.  It includes that memcg's local
counter as well.  Aside from that, this all seems awefully redundant.

How about this on top?

---
From: Johannes Weiner<hannes@xxxxxxxxxxx>
Subject: [patch] Documentation: memcg: future proof hierarchical statistics
  documentation

The hierarchical versions of per-memcg counters in memory.stat are all
calculated the same way and are all named total_<counter>.

Documenting the pattern is easier for maintenance than listing each
counter twice.

Signed-off-by: Johannes Weiner<hannes@xxxxxxxxxxx>
---
  Documentation/cgroups/memory.txt |   15 ++++-----------
  1 files changed, 4 insertions(+), 11 deletions(-)

diff --git a/Documentation/cgroups/memory.txt b/Documentation/cgroups/memory.txt
index 06eb6d9..a858675 100644
--- a/Documentation/cgroups/memory.txt
+++ b/Documentation/cgroups/memory.txt
@@ -404,17 +404,10 @@ hierarchical_memory_limit - # of bytes of memory limit with regard to hierarchy
  hierarchical_memsw_limit - # of bytes of memory+swap limit with regard to
  			hierarchy under which memory cgroup is.

-total_cache		- sum of all children's "cache"
-total_rss		- sum of all children's "rss"
-total_mapped_file	- sum of all children's "mapped_file"
-total_pgpgin		- sum of all children's "pgpgin"
-total_pgpgout		- sum of all children's "pgpgout"
-total_swap		- sum of all children's "swap"
-total_inactive_anon	- sum of all children's "inactive_anon"
-total_active_anon	- sum of all children's "active_anon"
-total_inactive_file	- sum of all children's "inactive_file"
-total_active_file	- sum of all children's "active_file"
-total_unevictable	- sum of all children's "unevictable"
+total_<counter>		- # hierarchical version of<counter>, which in
+			addition to the cgroup's own value includes the
+			sum of all hierarchical children's values of
+			<counter>, i.e. total_cache


I like this.
 Acked-by: KOSAKI Motohiro <kosaki.motohiro@xxxxxxxxxxxxxx>




--
To unsubscribe, send a message with 'unsubscribe linux-mm' in
the body to majordomo@xxxxxxxxx.  For more info on Linux MM,
see: http://www.linux-mm.org/ .
Fight unfair telecom internet charges in Canada: sign http://stopthemeter.ca/
Don't email: <a href=mailto:"dont@xxxxxxxxx";> email@xxxxxxxxx </a>


[Index of Archives]     [Linux ARM Kernel]     [Linux ARM]     [Linux Omap]     [Fedora ARM]     [IETF Annouce]     [Bugtraq]     [Linux]     [Linux OMAP]     [Linux MIPS]     [ECOS]     [Asterisk Internet PBX]     [Linux API]