Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754128Ab2E1OX6 (ORCPT ); Mon, 28 May 2012 10:23:58 -0400 Received: from mga09.intel.com ([134.134.136.24]:19181 "EHLO mga09.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751899Ab2E1OX5 (ORCPT ); Mon, 28 May 2012 10:23:57 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.67,351,1309762800"; d="scan'208";a="149269805" Message-ID: <4FC38A77.8090700@intel.com> Date: Mon, 28 May 2012 22:23:51 +0800 From: Alex Shi User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:9.0) Gecko/20111229 Thunderbird/9.0 MIME-Version: 1.0 To: "Srivatsa S. Bhat" CC: rusty@rustcorp.com.au, akpm@linux-foundation.org, paul.gortmaker@windriver.com, kosaki.motohiro@jp.fujitsu.com, linux-kernel@vger.kernel.org Subject: Re: [PATCH] cpumask: add a few comments of cpumask functions References: <1338195748-18934-1-git-send-email-alex.shi@intel.com> <4FC373D9.7040109@linux.vnet.ibm.com> <4FC38277.2030500@intel.com> In-Reply-To: <4FC38277.2030500@intel.com> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3332 Lines: 88 > > Thanks for all comments, I updated the patch according to your some suggestion. > Anyway, I don't mind if the patch is picked up. Maybe there is only one stupid > guy in the world. :) > ---------- Sorry, missed 's' for verb's singular form in third personal. --- >From e33d4fb4a6730832c08979f2cfdf65795cefd08a Mon Sep 17 00:00:00 2001 From: Alex Shi Date: Mon, 28 May 2012 15:53:51 +0800 Subject: [PATCH] cpumask: add a few comments of cpumask functions Current few cpumask functions' purposes are not quite clear. Stupid user like myself need to dig into details for clear function purpose and return value. Add few explanation for them is helpful. Signed-off-by: Alex Shi --- include/linux/cpumask.h | 6 ++++++ 1 files changed, 6 insertions(+), 0 deletions(-) diff --git a/include/linux/cpumask.h b/include/linux/cpumask.h index a2c819d..7fb07ac 100644 --- a/include/linux/cpumask.h +++ b/include/linux/cpumask.h @@ -271,6 +271,7 @@ static inline void cpumask_clear_cpu(int cpu, struct cpumask *dstp) * cpumask_test_cpu - test for a cpu in a cpumask * @cpu: cpu number (< nr_cpu_ids) * @cpumask: the cpumask pointer + * Returns 1 if the 'cpu' is in the old bitmap of 'cpumask', otherwise returns 0 * * No static inline type checking - see Subtlety (1) above. */ @@ -281,6 +282,7 @@ static inline void cpumask_clear_cpu(int cpu, struct cpumask *dstp) * cpumask_test_and_set_cpu - atomically test and set a cpu in a cpumask * @cpu: cpu number (< nr_cpu_ids) * @cpumask: the cpumask pointer + * Returns 1 if the 'cpu' is in the old bitmap of 'cpumask', otherwise returns 0 * * test_and_set_bit wrapper for cpumasks. */ @@ -293,6 +295,7 @@ static inline int cpumask_test_and_set_cpu(int cpu, struct cpumask *cpumask) * cpumask_test_and_clear_cpu - atomically test and clear a cpu in a cpumask * @cpu: cpu number (< nr_cpu_ids) * @cpumask: the cpumask pointer + * Returns 1 if the 'cpu' is in the old bitmap of 'cpumask', otherwise returns 0 * * test_and_clear_bit wrapper for cpumasks. */ @@ -324,6 +327,7 @@ static inline void cpumask_clear(struct cpumask *dstp) * @dstp: the cpumask result * @src1p: the first input * @src2p: the second input + * If *dstp is empty, returns 0, otherwise returns 1 */ static inline int cpumask_and(struct cpumask *dstp, const struct cpumask *src1p, @@ -365,6 +369,7 @@ static inline void cpumask_xor(struct cpumask *dstp, * @dstp: the cpumask result * @src1p: the first input * @src2p: the second input + * If *dstp is empty, returns 0, otherwise returns 1 */ static inline int cpumask_andnot(struct cpumask *dstp, const struct cpumask *src1p, @@ -414,6 +419,7 @@ static inline bool cpumask_intersects(const struct cpumask *src1p, * cpumask_subset - (*src1p & ~*src2p) == 0 * @src1p: the first input * @src2p: the second input + * Returns 1 if the *src1p is the subset of *src2p, otherwise returns 0 */ static inline int cpumask_subset(const struct cpumask *src1p, const struct cpumask *src2p) -- 1.7.5.4 -- 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/