From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from d01relay02.pok.ibm.com (d01relay02.pok.ibm.com [9.56.227.234]) by e4.ny.us.ibm.com (8.13.8/8.13.8) with ESMTP id mA1ImWur024462 for ; Sat, 1 Nov 2008 14:48:32 -0400 Received: from d01av04.pok.ibm.com (d01av04.pok.ibm.com [9.56.224.64]) by d01relay02.pok.ibm.com (8.13.8/8.13.8/NCO v9.1) with ESMTP id mA1ImWSO107910 for ; Sat, 1 Nov 2008 14:48:32 -0400 Received: from d01av04.pok.ibm.com (loopback [127.0.0.1]) by d01av04.pok.ibm.com (8.12.11.20060308/8.13.3) with ESMTP id mA1ImWHY001517 for ; Sat, 1 Nov 2008 14:48:32 -0400 From: Balbir Singh Date: Sun, 02 Nov 2008 00:18:24 +0530 Message-Id: <20081101184824.2575.5935.sendpatchset@balbir-laptop> In-Reply-To: <20081101184812.2575.68112.sendpatchset@balbir-laptop> References: <20081101184812.2575.68112.sendpatchset@balbir-laptop> Subject: [mm] [PATCH 1/4] Memory cgroup hierarchy documentation Sender: owner-linux-mm@kvack.org Return-Path: To: linux-mm@kvack.org Cc: YAMAMOTO Takashi , Paul Menage , lizf@cn.fujitsu.com, linux-kernel@vger.kernel.org, Nick Piggin , David Rientjes , Pavel Emelianov , Dhaval Giani , Balbir Singh , Andrew Morton , KAMEZAWA Hiroyuki List-ID: Documentation updates for hierarchy support Signed-off-by: Balbir Singh --- Documentation/controllers/memory.txt | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff -puN Documentation/controllers/memory.txt~memcg-hierarchy-documentation Documentation/controllers/memory.txt --- linux-2.6.28-rc2/Documentation/controllers/memory.txt~memcg-hierarchy-documentation 2008-11-02 00:14:54.000000000 +0530 +++ linux-2.6.28-rc2-balbir/Documentation/controllers/memory.txt 2008-11-02 00:14:54.000000000 +0530 @@ -245,6 +245,40 @@ cgroup might have some charge associated tasks have migrated away from it. Such charges are automatically dropped at rmdir() if there are no tasks. +5. Hierarchy support + +The memory controller supports a deep hierarchy and hierarchical accounting. +The hierarchy is created by creating the appropriate cgroups in the +cgroup filesystem. Consider for example, the following cgroup filesystem +hierarchy + + root + / | \ + / | \ + a b c + | \ + | \ + d e + +In the diagram above, with hierarchical accounting enabled, all memory +usage of e, is accounted to its ancestors up until the root (i.e, c and root). +If one of the ancestors goes over its limit, the reclaim algorithm reclaims +from the tasks in the ancestor and the children of the ancestor. + +5.1 Enabling hierarchical accounting and reclaim + +The memory controller by default disables the hierarchy feature. Support +can be enabled by writing 1 to memory.features file of the root cgroup + +# echo 1 > memory.features + +The feature can be disabled by + +# echo 0 > memory.features + +NOTE: Enabling/disabling will fail if the root cgroup already has other +cgroups created below it. + 5. TODO 1. Add support for accounting huge pages (as a separate controller) _ -- Balbir -- To unsubscribe, send a message with 'unsubscribe linux-mm' in the body to majordomo@kvack.org. For more info on Linux MM, see: http://www.linux-mm.org/ . Don't email: email@kvack.org