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 ABF31C48BC3 for ; Wed, 21 Feb 2024 09:28:13 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 3C7076B0082; Wed, 21 Feb 2024 04:28:13 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 34E976B0087; Wed, 21 Feb 2024 04:28:13 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 1E4286B0085; Wed, 21 Feb 2024 04:28:13 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id 0B0386B0082 for ; Wed, 21 Feb 2024 04:28:13 -0500 (EST) Received: from smtpin18.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id D2A55120801 for ; Wed, 21 Feb 2024 09:28:12 +0000 (UTC) X-FDA: 81815284824.18.96466E8 Received: from out30-110.freemail.mail.aliyun.com (out30-110.freemail.mail.aliyun.com [115.124.30.110]) by imf03.hostedemail.com (Postfix) with ESMTP id 731232000B for ; Wed, 21 Feb 2024 09:28:10 +0000 (UTC) Authentication-Results: imf03.hostedemail.com; dkim=pass header.d=linux.alibaba.com header.s=default header.b=tbf261B3; dmarc=pass (policy=none) header.from=linux.alibaba.com; spf=pass (imf03.hostedemail.com: domain of baolin.wang@linux.alibaba.com designates 115.124.30.110 as permitted sender) smtp.mailfrom=baolin.wang@linux.alibaba.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1708507691; 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-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=m3nqGI/fMVZjL40459w/MnS9DkbLdhc8HEWPtY+H0PM=; b=H28lTZZVfByf5MC4X0DevN8pisN9GQ+NuuzLvHgDJgWIpkADrIO0CL979LqWabFZvJNGMv sJEioWT8x58xpgN8T5+TJnE5t/7EKtx9zqR9PPY8O5Y9GLayiZUczI/K8GoOspng1jtfHL Tb9ShdCoAylJJkotkZyj5hOkTC0JGJ0= ARC-Authentication-Results: i=1; imf03.hostedemail.com; dkim=pass header.d=linux.alibaba.com header.s=default header.b=tbf261B3; dmarc=pass (policy=none) header.from=linux.alibaba.com; spf=pass (imf03.hostedemail.com: domain of baolin.wang@linux.alibaba.com designates 115.124.30.110 as permitted sender) smtp.mailfrom=baolin.wang@linux.alibaba.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1708507691; a=rsa-sha256; cv=none; b=bH2jaPhV8p+wWmIw3jNwjqOindBKC4pJqRGcPCoH91+ya7+Fk3HdbohLBWeiDPuI4DkU/L asxHitmOel+MpXYfPNWAX8sZ3gwE14dSkIGLJsPO5bqkqgJYYOD6Kwnl3c6Cj0B+sa4WZG uKmuHvqAUTfONteQGLiov/10iMhf+/g= DKIM-Signature:v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.alibaba.com; s=default; t=1708507687; h=From:To:Subject:Date:Message-Id:MIME-Version; bh=m3nqGI/fMVZjL40459w/MnS9DkbLdhc8HEWPtY+H0PM=; b=tbf261B3zP1aJ8GoO26ZLScrCldl7dzZMaMeJlr4A0bIl/eqetArzNNTiOsFE+fOf/P1yNqrhbc01ou4qQRZMWJoVnjJ3soxij/rRObHr6LyXu5wk8ViEdZ/Bm1Q1GVHnL3JyQopwO4VLGTofhfHTP+Uxm8md5XHJXiDpx/ZCk0= X-Alimail-AntiSpam:AC=PASS;BC=-1|-1;BR=01201311R101e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018046050;MF=baolin.wang@linux.alibaba.com;NM=1;PH=DS;RN=10;SR=0;TI=SMTPD_---0W0zShrU_1708507686; Received: from localhost(mailfrom:baolin.wang@linux.alibaba.com fp:SMTPD_---0W0zShrU_1708507686) by smtp.aliyun-inc.com; Wed, 21 Feb 2024 17:28:06 +0800 From: Baolin Wang To: akpm@linux-foundation.org Cc: muchun.song@linux.dev, osalvador@suse.de, david@redhat.com, linmiaohe@huawei.com, naoya.horiguchi@nec.com, mhocko@kernel.org, baolin.wang@linux.alibaba.com, linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: [RFC PATCH 3/3] docs: hugetlbpage.rst: add hugetlb migration description Date: Wed, 21 Feb 2024 17:27:55 +0800 Message-Id: <75b80937a84bd98211cea0607707bfdee8cb5873.1708507022.git.baolin.wang@linux.alibaba.com> X-Mailer: git-send-email 2.39.3 In-Reply-To: References: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam09 X-Rspamd-Queue-Id: 731232000B X-Stat-Signature: oykiryj1yswo569sz151itbzaxidb4ub X-Rspam-User: X-HE-Tag: 1708507690-439289 X-HE-Meta: U2FsdGVkX18OPFcqmAkL/AkovthAlSjn+Qi6kz91oMgAXu+iD5zohBrGRSTMRtm3kGyDZiYon6ijlVI41n206dp+RaUPuoLvnY1/hba3u5zionqebcWmiEyNn1CHYDLsvrIY8qFSEN+nj5ePsXpA3kKMVHeOoQsNk7nMvRVOOqynmtQePNBrxvUoZsSgzH7w99AYPoL5JkWehrXP1WMZJca83RcTjCmobHC1zya5EDXZEMSUYKTha5FIGYetldUnehBdXK389QACjSPS/ngq0DXps2fop7+W1LXjU7QwLoiFv8ps6SI8vBjw8fR2JCqUQ/1uUGcuANIRfPX6/E6E0mm8duS7uMX5egT+pLWgSJyHIsIDefx/cu5QuaQolTHF/JCkdoEYlcLX8MVYIASBEcdq9d1SPdSWYe8uXiX0N6L3zYKLYPVnSYQ08u/gDvASthS2tIFgd2dvQBB/00GLEE2p9OEz/Z1CaLPE7w/2wdLV+SNwgDDYZpnIGyyPMLCG2iuEKFUia/qWYuehvaWJ/Sw7XxMZiPQfmQBOrOKMuNidzpFg5cnYDoaL4l1fIVw0WmexWbRFmcj9bpSCFi+l/oTPb3snM2xo17U+Aep54iZXhICdFN1qvQ8h1k/niNFSpK0zZpFuWC0ilJFqNW91971rlCmdStvpQ0UgjdcYTbzaJmgSF6hPBiixBDR3ADFlAutEaY3UVGVCCyMWtlLZtoQHiYHOQ8z8xa/xelcMpoSZze95tDjBxODXKY5Q0KuNt+CcJWS1HM2W3IvZVa1x/n0d0vusSF+nrbGEOFmWteQZVMcqASjr2PUnWPNowN+7WMY/PqQiLqBpmVhnXAoFDyMk5J0ZJqOvef6mN3xi8m2h1pv73ikDSHT/RzdbxuQtWdZKeVIZEY6Z8Chhmx7ncLSd2rbmTosl 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: Add some description of the hugetlb migration strategy. Signed-off-by: Baolin Wang --- Documentation/admin-guide/mm/hugetlbpage.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/Documentation/admin-guide/mm/hugetlbpage.rst b/Documentation/admin-guide/mm/hugetlbpage.rst index e4d4b4a8dc97..68d7bc2165c9 100644 --- a/Documentation/admin-guide/mm/hugetlbpage.rst +++ b/Documentation/admin-guide/mm/hugetlbpage.rst @@ -376,6 +376,13 @@ Note that the number of overcommit and reserve pages remain global quantities, as we don't know until fault time, when the faulting task's mempolicy is applied, from which node the huge page allocation will be attempted. +The hugetlb may be migrated between the per-node hugepages pool in the following +scenarios: memory offline, memory failure, longterm pinning, syscalls(mbind, +migrate_pages, move_pages), alloc_contig_range() and alloc_contig_pages(). Now +only memory offline, memory failure and syscalls allow fallback to allocate a +new hugetlb on a different node if the current node is unable to allocate during +hugetlb migration, that means these 3 cases can break the per-node hugepages pool. + .. _using_huge_pages: Using Huge Pages -- 2.39.3