From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-13.8 required=3.0 tests=BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_CR_TRAILER,INCLUDES_PATCH, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 9FCE4C433DB for ; Fri, 22 Jan 2021 00:58:09 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 30A2822CAE for ; Fri, 22 Jan 2021 00:58:08 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 30A2822CAE Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=intel.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id 5B7D46B0006; Thu, 21 Jan 2021 19:58:08 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 567306B0007; Thu, 21 Jan 2021 19:58:08 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 47ED66B0008; Thu, 21 Jan 2021 19:58:08 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0118.hostedemail.com [216.40.44.118]) by kanga.kvack.org (Postfix) with ESMTP id 2E83A6B0006 for ; Thu, 21 Jan 2021 19:58:08 -0500 (EST) Received: from smtpin10.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay03.hostedemail.com (Postfix) with ESMTP id E2366824999B for ; Fri, 22 Jan 2021 00:58:07 +0000 (UTC) X-FDA: 77731599414.10.burn31_2905bdb27567 Received: from filter.hostedemail.com (10.5.16.251.rfc1918.com [10.5.16.251]) by smtpin10.hostedemail.com (Postfix) with ESMTP id C442416A4BD for ; Fri, 22 Jan 2021 00:58:07 +0000 (UTC) X-HE-Tag: burn31_2905bdb27567 X-Filterd-Recvd-Size: 4469 Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by imf19.hostedemail.com (Postfix) with ESMTP for ; Fri, 22 Jan 2021 00:58:06 +0000 (UTC) IronPort-SDR: bmUN71fgOasFRyzSasCHVFBwCYrh051pHv7PiGxsob4rLiQJvwNaHNL2+re5ay2pN7Wu4toL74 ZV+tQonXV6jg== X-IronPort-AV: E=McAfee;i="6000,8403,9871"; a="175860480" X-IronPort-AV: E=Sophos;i="5.79,365,1602572400"; d="scan'208";a="175860480" Received: from orsmga008.jf.intel.com ([10.7.209.65]) by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 21 Jan 2021 16:58:03 -0800 IronPort-SDR: AomqZirfBYVX2dVA+TNPs283Zma2HyLlHIIDH5aGMH8DRj3N5ZLC8croTmaYD2XAlL90zvzOOO 5c0JzNFGWyyQ== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.79,365,1602572400"; d="scan'208";a="385547697" Received: from yhuang-dev.sh.intel.com (HELO yhuang-dev) ([10.239.159.145]) by orsmga008.jf.intel.com with ESMTP; 21 Jan 2021 16:58:01 -0800 From: "Huang\, Ying" To: "Alejandro Colomar \(man-pages\)" Cc: Andrew Morton , Mel Gorman , "Michael Kerrisk \(man-pages\)" , linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH -V9 2/3] NOT kernel/man2/set_mempolicy.2: Add mode flag MPOL_F_NUMA_BALANCING References: <20210120061235.148637-1-ying.huang@intel.com> <20210120061235.148637-3-ying.huang@intel.com> <99b71573-714f-5ec6-37e5-3e6e080432fc@gmail.com> Date: Fri, 22 Jan 2021 08:58:00 +0800 In-Reply-To: <99b71573-714f-5ec6-37e5-3e6e080432fc@gmail.com> (Alejandro Colomar's message of "Thu, 21 Jan 2021 21:39:40 +0100") Message-ID: <87lfclss87.fsf@yhuang-dev.intel.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: "Alejandro Colomar (man-pages)" writes: > Hi Huang Ying, > > On 1/20/21 7:12 AM, Huang Ying wrote: >> Signed-off-by: "Huang, Ying" >> Cc: "Alejandro Colomar" > > Sorry, for the confusion. > I have a different email for reading lists. > I use alx.manpages@ for everything, > and alx.mailinglists@ just for reading lists, but sometimes, > when I answer emails not sent to me, > I forget to change the reply address, > and you see that address (which I intended to be readonly). > > Please, use alx.manpages@gmail.com, > or your mail might get lost between many list emails ;) Got it! >> --- >> man2/set_mempolicy.2 | 22 ++++++++++++++++++++++ >> 1 file changed, 22 insertions(+) >>=20 >> diff --git a/man2/set_mempolicy.2 b/man2/set_mempolicy.2 >> index 68011eecb..fa64a1820 100644 >> --- a/man2/set_mempolicy.2 >> +++ b/man2/set_mempolicy.2 >> @@ -113,6 +113,22 @@ A nonempty >> .I nodemask >> specifies node IDs that are relative to the set of >> node IDs allowed by the process's current cpuset. >> +.TP >> +.BR MPOL_F_NUMA_BALANCING " (since Linux 5.12)" >> +When >> +.I mode >> +is >> +.BR MPOL_BIND , >> +enable the kernel NUMA balancing for the task if it is supported by >> +the kernel. >> +If the flag isn't supported by the kernel, or is used with >> +.I mode >> +other than >> +.BR MPOL_BIND , >> +return \-1 and >> +.I errno >> +is set to >> +.BR EINVAL . > > The wording here is a bit weird: > [return // is set]. It would be better as > [return // set] or [returns // sets] or [is returned // is set]. > > The same page, has: > > [ > RETURN VALUE > On success, set_mempolicy() returns 0; on error, -1 is re=E2=80= =90 > turned and errno is set to indicate the error. > ] > > so I'd use the latter for consistency. Sure. Will change this. Thanks for comments! Best Regards, Huang, Ying >> .PP >> .I nodemask >> points to a bit mask of node IDs that contains up to >> @@ -293,6 +309,12 @@ argument specified both >> .B MPOL_F_STATIC_NODES >> and >> .BR MPOL_F_RELATIVE_NODES . >> +Or, the >> +.B MPOL_F_NUMA_BALANCING >> +isn't supported by the kernel, or is used with >> +.I mode >> +other than >> +.BR MPOL_BIND . >> .TP >> .B ENOMEM >> Insufficient kernel memory was available. >>=20 > > Other than that, it's good for me. > > Thanks, > > Alex > > Just a reminder for myself (please ignore it): > - Break EINVAL into multiple paragraphs. > - (Maybe) reorder lists to be in alphabetical order.