From patchwork Tue Feb 27 13:52:27 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Baolin Wang X-Patchwork-Id: 13573846 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 7A07AC54798 for ; Tue, 27 Feb 2024 13:52:50 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 40BE26B016C; Tue, 27 Feb 2024 08:52:45 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 393EE6B016F; Tue, 27 Feb 2024 08:52:45 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 1993D6B0171; Tue, 27 Feb 2024 08:52:45 -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 022296B016C for ; Tue, 27 Feb 2024 08:52:45 -0500 (EST) Received: from smtpin29.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id CC821160BEA for ; Tue, 27 Feb 2024 13:52:44 +0000 (UTC) X-FDA: 81837724248.29.D99E2BC Received: from out30-97.freemail.mail.aliyun.com (out30-97.freemail.mail.aliyun.com [115.124.30.97]) by imf15.hostedemail.com (Postfix) with ESMTP id 73F91A0024 for ; Tue, 27 Feb 2024 13:52:41 +0000 (UTC) Authentication-Results: imf15.hostedemail.com; dkim=pass header.d=linux.alibaba.com header.s=default header.b=i3R9bWJt; dmarc=pass (policy=none) header.from=linux.alibaba.com; spf=pass (imf15.hostedemail.com: domain of baolin.wang@linux.alibaba.com designates 115.124.30.97 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=1709041963; 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=jQS6ixAjVk0AC8cKYwTBDAm2HkLKEDsUdifzfOmBcs0=; b=Qz9lkXnJkJA+WMlGt1VhUJWXnsoxxuyi7zmJ7vFQC1U5iUhd3t8Wc48U8osu7olRgs2qYr rpPRyOYvuTZX7eb7imapC3RePPPfaZxDAFuQsUnA1ZdyOWYBbSTu+nKkvF6XWH+VW6gSxN qchwHFxJO4O/qCIJj9sE8ck6laJePiU= ARC-Authentication-Results: i=1; imf15.hostedemail.com; dkim=pass header.d=linux.alibaba.com header.s=default header.b=i3R9bWJt; dmarc=pass (policy=none) header.from=linux.alibaba.com; spf=pass (imf15.hostedemail.com: domain of baolin.wang@linux.alibaba.com designates 115.124.30.97 as permitted sender) smtp.mailfrom=baolin.wang@linux.alibaba.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1709041963; a=rsa-sha256; cv=none; b=78pIlwCGAz2rtkLZenAWPkMem95d3VdX7t1KILThINrR/jWr0i/LymaFW0Aw3+naodxgHD DcKXuoC59RopHXGOZPUWi2rc+SaT8iUtEidlLqHzfaHKTEjUtIB4cXS9bNQ2Hdqn7LRaHG XktCsa2MSpWSKuZVwDq5R/NpX1wCxE0= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.alibaba.com; s=default; t=1709041958; h=From:To:Subject:Date:Message-Id:MIME-Version; bh=jQS6ixAjVk0AC8cKYwTBDAm2HkLKEDsUdifzfOmBcs0=; b=i3R9bWJt363GKWx5GJRWr6i7VTUoUN3mS7947TEsH0hIcPK9mpi1+rMe+1g2owwUwln/HU+E6tUx4cawEmaXKdIRCNoLh0rkLpUPx8UyCcJaDbTe3bEqJXJkY075nXPZqJzsj3GBiw8iLlmJXH9q9l2GzFLDDFezrn+NrbmgHMs= X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R161e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045192;MF=baolin.wang@linux.alibaba.com;NM=1;PH=DS;RN=10;SR=0;TI=SMTPD_---0W1MvL.r_1709041957; Received: from localhost(mailfrom:baolin.wang@linux.alibaba.com fp:SMTPD_---0W1MvL.r_1709041957) by smtp.aliyun-inc.com; Tue, 27 Feb 2024 21:52:37 +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: [PATCH 3/3] docs: hugetlbpage.rst: add hugetlb migration description Date: Tue, 27 Feb 2024 21:52:27 +0800 Message-Id: <574e5bfbaa2b6930aad4a64e1c3da25c4ee5c9ee.1709041586.git.baolin.wang@linux.alibaba.com> X-Mailer: git-send-email 2.39.3 In-Reply-To: References: MIME-Version: 1.0 X-Rspamd-Server: rspam09 X-Rspamd-Queue-Id: 73F91A0024 X-Stat-Signature: rouau97wpu5ypn4fkjwiw7pm8npxgafh X-Rspam-User: X-HE-Tag: 1709041961-797162 X-HE-Meta: U2FsdGVkX18dYROXlrlAgjIYT9Da5syVUKSn5ZQmmRo+dDMuILul1MJuFe87xrQuHmjCTRaBzIK7jOyHNHJvhnRSr5Ra7KZF8arxOOo4TceJQEp0cthKfTmpmKLewSPrvjyicvjJrrPi3aZFHk2gKrZxg+rqFNq5BLpNMugS3R79l/bITbzhyCrGE4LDfV3ao8IIkzj6FscYlWxt2dYNU49MCROX2+Osq/EJG4qh5mzRHbOxbjhJX2lSqHP3DvpN8szSccJ5Jl9Agjeld2Mh+6hIichrCIC89CMnkNh7QM1N0BwTmUIq0hUsv5MmWu4xWw/YIwLML1pkPBWKob+2hPsG+fGe/AEFgFwrtCUOB+otoAVKfb5q6K8vRk8WbYoJHJXgcuSzW1GIxVwg+DXNXdnctqCDLD8qYgLNRmX5k8aaJ5AdvsKndzkJblYkFexchTQ8gp/4EpEg9f8R6pkakiX0lW7S5Gd389z7jRg1C1lHq4UWHrVpOAZi0dYCHdN3V2h3+1ybPII+u/KF+uxBzRYxB+ilYayQrTa0lD7WI30c5qWN/SNP3bJtswO/qzJxEXVmHuG9flfOdQyAxpqkvw0T7xTs6Hs0ZOZzZetGksNpTdhRQkOd6Tc0cWo7ICkn/CUGmf336aA2j7/7ZcdUU4dwjngXEO4RlhPHKNQHSf1US20D5lmGQ1036t/iEKjgvB0ZjnMHc4zQhbzi1KI4EIXT6SiXd83tYNHTquNej+h22p/NfTUQwW4K7zhbo4WqjqG5Qial0aY8kt6mP/aDNny1ki+k9ozJY618zkdWqeQw4R/4/eH/uRsvbD8mAceKem62bW8f0zNhMg8x03cgA9ERN3BXz+38JaXDHgk4MWS40jQojpVfIfgc0ay9MY9++c74C4XRi4hR/Wvg27FIAohg+u+hSPj/ 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..f34a0d798d5b 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 and move_pages), alloc_contig_range() and alloc_contig_pages(). +Now only memory offline, memory failure and syscalls allow fallbacking 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