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 Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 8E44BC5AD4C for ; Thu, 23 Nov 2023 06:39:53 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 18E806B064C; Thu, 23 Nov 2023 01:39:53 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 13E6E6B064D; Thu, 23 Nov 2023 01:39:53 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 02CEF6B064E; Thu, 23 Nov 2023 01:39:52 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0013.hostedemail.com [216.40.44.13]) by kanga.kvack.org (Postfix) with ESMTP id E387C6B064C for ; Thu, 23 Nov 2023 01:39:52 -0500 (EST) Received: from smtpin18.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay05.hostedemail.com (Postfix) with ESMTP id BB1B94023B for ; Thu, 23 Nov 2023 06:39:52 +0000 (UTC) X-FDA: 81488268624.18.F3EC446 Received: from mgamail.intel.com (mgamail.intel.com [134.134.136.31]) by imf25.hostedemail.com (Postfix) with ESMTP id ADDE7A0015 for ; Thu, 23 Nov 2023 06:39:50 +0000 (UTC) Authentication-Results: imf25.hostedemail.com; dkim=pass header.d=intel.com header.s=Intel header.b=E54Rc0DF; spf=pass (imf25.hostedemail.com: domain of ying.huang@intel.com designates 134.134.136.31 as permitted sender) smtp.mailfrom=ying.huang@intel.com; dmarc=pass (policy=none) header.from=intel.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1700721590; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=CXPaUVGSZ66+l5RzESr5VqqZ8X3dK9lmbLNxe60wWbE=; b=Zdu7I3HVx5i5TfaeAnLuzYmMgAJO5e3/w2gjz5k+UfkGtIG7turvez52JH/NtwhSDNTHBq XGwVjW2XspPZ6mbyJj6LBRo0NOyCxvyLkY5aGh2aJkmmH/e7LweLtBM9SCD1AV5FPl2kpT MOwezYBpv8GWvNRbasJSPFDdmoEuuJ8= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1700721590; a=rsa-sha256; cv=none; b=LF/XWhg9F9XAdKjWYAVE75cc2r2BZRy1Lg2L5hqg4eIlssouuYAWJq95KkEykTlY6Wj8Sd fQYjCtuqNwn6TXXXOXI5Nu9UKJhPKDP0DhmIG01mReIa2U9clGeci7JyP84gG2Yt07z2wY fHCgWjA7uekY9GXMO1iFf2OeSw9Uv9w= ARC-Authentication-Results: i=1; imf25.hostedemail.com; dkim=pass header.d=intel.com header.s=Intel header.b=E54Rc0DF; spf=pass (imf25.hostedemail.com: domain of ying.huang@intel.com designates 134.134.136.31 as permitted sender) smtp.mailfrom=ying.huang@intel.com; dmarc=pass (policy=none) header.from=intel.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1700721590; x=1732257590; h=from:to:cc:subject:in-reply-to:references:date: message-id:mime-version; bh=sNJFJlh3rji6zudwDz3TzUsgtizbU6T+kzRcilJIPLk=; b=E54Rc0DFgbn8lGZBk7GcFCC/uTQwbxLXJZsxCdmW0d8f33+D3X3vtVp6 5OAMwdEL4j4DOxKKsqfo3cwilBln7Q/sP8vx/4TwSGBPJgCgjLsnPJ04a hZUDQcGFnq6ZSGaq1AQnyBces4YVadcgmh70jwrCyJYvO8QtoEbQPkJEe YpCZSMll0NfIFAEGq6BNN8VJTACFhjKifRgqEzBlC+TR60SjsGELqTrqT /tE52A0cEk5iq+iYnZRPM9fJhSHdUFIWzp4E0BuOXwyChFxrqaZpTnaP1 dNjHuEAt8C1wJUshSz5JGTMuvbPdODTkiAPv56LCh0T7FC4tG9A2JhTRz Q==; X-IronPort-AV: E=McAfee;i="6600,9927,10902"; a="456542541" X-IronPort-AV: E=Sophos;i="6.04,220,1695711600"; d="scan'208";a="456542541" Received: from fmviesa002.fm.intel.com ([10.60.135.142]) by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 Nov 2023 22:39:49 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.04,220,1695711600"; d="scan'208";a="8751510" Received: from yhuang6-desk2.sh.intel.com (HELO yhuang6-desk2.ccr.corp.intel.com) ([10.238.208.55]) by fmviesa002-auth.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 Nov 2023 22:39:47 -0800 From: "Huang, Ying" To: Yafang Shao Cc: akpm@linux-foundation.org, paul@paul-moore.com, jmorris@namei.org, serge@hallyn.com, omosnace@redhat.com, mhocko@suse.com, linux-mm@kvack.org, linux-security-module@vger.kernel.org, bpf@vger.kernel.org, ligang.bdlg@bytedance.com Subject: Re: [RFC PATCH v2 1/6] mm, doc: Add doc for MPOL_F_NUMA_BALANCING In-Reply-To: <20231122141559.4228-2-laoar.shao@gmail.com> (Yafang Shao's message of "Wed, 22 Nov 2023 14:15:54 +0000") References: <20231122141559.4228-1-laoar.shao@gmail.com> <20231122141559.4228-2-laoar.shao@gmail.com> Date: Thu, 23 Nov 2023 14:37:45 +0800 Message-ID: <87edgh7z5y.fsf@yhuang6-desk2.ccr.corp.intel.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=ascii X-Stat-Signature: np5op8spkyqrrmfps4j749mhohhciwgx X-Rspamd-Server: rspam10 X-Rspamd-Queue-Id: ADDE7A0015 X-Rspam-User: X-HE-Tag: 1700721590-760547 X-HE-Meta: U2FsdGVkX1/s1iXn26BJd41UkEHAkIU+WBb3CKHo72n00HNwErkEYYK6zt0QZq613uLECvWcNdfaezCxI12kIMJwJnks/uK/6KqrpuHR+TctRbJfeJmdYTT+ZIrKlhSno+Cryc0939pDeQddET0ydNFHOviCduUL36wthVk5jaqlJzLsw0vgM5dDIX/06Btl4l0xTzn53Kt5Ua2OzncskS34pnOjXEDQogwuNScr7Itmltajx3eZe6xgTE1892zjQmoJTcyIr2O/ghFQMcnF9KakDsc7PKX4OzKBBuEwStq2ayAT4wKLMAnM3yxhTfyQmI0mEE5mjblmvh32qkmp7+0WI9A45JS6oafnFH93uX7zZtKxWWwMuaMyKVE905Fy3cXte34C4J80X9bBkGgkfBGc7EvVmVEVFfFwsAmKEsy5No7WGPoWMmMSZC+lJRKIsIi0HdQet/EWkzHPnoTLbCeoxjw6G9RLGwcP5hIHV/71Ml5Hvb2hd+ZI/sCs+iS6CGd90JRgF2ArWt7z/PuPocet1dXOACFckGp6rDDut4W3efMI7UK1Zwu+NRX2OSA7QPLfgkzffie9YD45Zkt2xITFAYdk+ftWXpxakuggPzftc/IpAAACwmhFoV3WUtBZnilB18B1/g0tHBhn97H7s45PCiLfva+g9brtum9rsC5JlTXIFwkH0rs5tK8wXKluY06EH6A16IGCJfPho0JhXg7GaFD0+HCEK+7f1vm3gpdTOV16fm0OU9KdS1R0/ZOKW5D8yBA4pwWwaFGDAXUPQ9HafV9s14px6ghqX5SQv6LO4+9FWnVD/BlNcWV8CJDG6X4MLEufOOacYp8gR258U2WUTNWkK7WS34F3v/xau8KXZChc7C6bZYEpD6DzrXAzEzNCwT/dZWoJb2zLQdA37/Rrr0rgA+RYyxTrN/mCDN0VggQPXBdZyqr7DO6I5ymIeYg5pkpac2641173CCY MN+gff6a 2vYeTvrRsWX1Qj1WHh/Gz4Gw+2mLSTVd5ZzTp3b+QbjZ6VsLWi2+3ypbIhXlqimUSEugAV2tY/wt7El0hJdKKJSmvWKU/OxRnDq2R95WxsCbJMdAv+w6XgViNX2m9xKpKAf6dXZUHakplyOU4RqjnkrOjeC0jjqwYkkP3VXEdH/2IoLSGuWWnzTq3jGJh9Edy2HDHn1OYkKQFe/F2rC95X5vKHPhxPXR8zd7QaOxST0Bgk+7i++XqnXZFr8XjVFPVrODjL5u4lbN7mXjsbLM1ZKjNpNxR1BqcbG51FVSz4/+PNxA/Ckv32Gg8ig== 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: List-Subscribe: List-Unsubscribe: Yafang Shao writes: > The document on MPOL_F_NUMA_BALANCING was missed in the initial commit > The MPOL_F_NUMA_BALANCING document was inadvertently omitted from the > initial commit bda420b98505 ("numa balancing: migrate on fault among > multiple bound nodes") > > Let's ensure its inclusion. > > Signed-off-by: Yafang Shao > Cc: "Huang, Ying" LGTM, Thanks! Reviewed-by: "Huang, Ying" > --- > .../admin-guide/mm/numa_memory_policy.rst | 27 +++++++++++++++++++ > 1 file changed, 27 insertions(+) > > diff --git a/Documentation/admin-guide/mm/numa_memory_policy.rst b/Documentation/admin-guide/mm/numa_memory_policy.rst > index eca38fa81e0f..19071b71979c 100644 > --- a/Documentation/admin-guide/mm/numa_memory_policy.rst > +++ b/Documentation/admin-guide/mm/numa_memory_policy.rst > @@ -332,6 +332,33 @@ MPOL_F_RELATIVE_NODES > MPOL_PREFERRED policies that were created with an empty nodemask > (local allocation). > > +MPOL_F_NUMA_BALANCING (since Linux 5.12) > + When operating in MPOL_BIND mode, enables NUMA balancing for tasks, > + contingent upon kernel support. This feature optimizes page > + placement within the confines of the specified memory binding > + policy. The addition of the MPOL_F_NUMA_BALANCING flag augments the > + control mechanism for NUMA balancing: > + > + - The sysctl knob numa_balancing governs global activation or > + deactivation of NUMA balancing. > + > + - Even if sysctl numa_balancing is enabled, NUMA balancing remains > + disabled by default for memory areas or applications utilizing > + explicit memory policies. > + > + - The MPOL_F_NUMA_BALANCING flag facilitates NUMA balancing > + activation for applications employing explicit memory policies > + (MPOL_BIND). > + > + This flags enables various optimizations for page placement through > + NUMA balancing. For instance, when an application's memory is bound > + to multiple nodes (MPOL_BIND), the hint page fault handler attempts > + to migrate accessed pages to reduce cross-node access if the > + accessing node aligns with the policy nodemask. > + > + If the flag isn't supported by the kernel, or is used with mode > + other than MPOL_BIND, -1 is returned and errno is set to EINVAL. > + > Memory Policy Reference Counting > ================================ -- Best Regards, Huang, Ying