Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753585Ab0BII3W (ORCPT ); Tue, 9 Feb 2010 03:29:22 -0500 Received: from e28smtp03.in.ibm.com ([122.248.162.3]:46334 "EHLO e28smtp03.in.ibm.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751762Ab0BII3U (ORCPT ); Tue, 9 Feb 2010 03:29:20 -0500 Date: Tue, 9 Feb 2010 13:59:14 +0530 From: Arun R Bharadwaj To: Peter Zijlstra , Benjamin Herrenschmidt , Ingo Molnar , Vaidyanathan Srinivasan , Dipankar Sarma , Balbir Singh , Venkatesh Pallipadi Cc: linux-kernel@vger.kernel.org, Arun Bharadwaj Subject: [v11 PATCH 1/9]: cpuidle: Design documentation patch Message-ID: <20100209082914.GB29988@linux.vnet.ibm.com> Reply-To: arun@linux.vnet.ibm.com References: <20100209082815.GA29988@linux.vnet.ibm.com> MIME-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Disposition: inline In-Reply-To: <20100209082815.GA29988@linux.vnet.ibm.com> User-Agent: Mutt/1.5.20 (2009-06-14) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2464 Lines: 58 * Arun R Bharadwaj [2010-02-09 13:58:16]: This patch adds a little information about the redesigned cpuidle infrastructure in Documentation/cpuidle/core.txt Signed-off-by: Arun R Bharadwaj --- Documentation/cpuidle/core.txt | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) Index: linux.trees.git/Documentation/cpuidle/core.txt =================================================================== --- linux.trees.git.orig/Documentation/cpuidle/core.txt +++ linux.trees.git/Documentation/cpuidle/core.txt @@ -21,3 +21,38 @@ which can be used to switch governors at is meant for developer testing only. In normal usage, kernel picks the best governor based on governor ratings. SEE ALSO: sysfs.txt in this directory. + +Design: + +Cpuidle allows for registration of multiple sets of idle routines. +The latest registered set is used by cpuidle governors as the current +active set to choose the right idle state. This set is managed as a +list and each time the newly registered set is added to the head of the +list and made the current active set. + +An example of how this would work on x86 is shown below. + +----------------- ----------------- +| | | | +| choose b/w | mwait is chosen | mwait | +| mwait, poll, |-------------------------------------> |(current active| +| default, c1e | register to cpuidle | set) | +| | with mwait as the idle routine | | +----------------- ----------------- + + +----------------- ----------------- +| | | c1, c2, c3 | +| ACPI | register to cpuidle | (current) | +| discovery |-------------------------------------> |---------------| +| | with c1, c2, c3 | mwait | +| | as set of idle routines | | +----------------- ----------------- + +With this mechanism, a module can register and unregister its set of +idle routines at run time in a clean manner. + +The main idle routine called inside cpu_idle() of every arch is defined in +driver/cpuidle/cpuidle.c which would in turn call the idle routine selected +by the governor. If the CONFIG_CPU_IDLE is disabled, the arch needs to +provide an alternate definition for cpuidle_idle_call(). -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/