From patchwork Wed Mar 6 10:13:28 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Baolin Wang X-Patchwork-Id: 13583756 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 29222C54E49 for ; Wed, 6 Mar 2024 10:13:50 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 28A976B0075; Wed, 6 Mar 2024 05:13:44 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 211D76B0081; Wed, 6 Mar 2024 05:13:44 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 0B2606B0082; Wed, 6 Mar 2024 05:13:44 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id E6DC06B0081 for ; Wed, 6 Mar 2024 05:13:43 -0500 (EST) Received: from smtpin02.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 9ECDA12097C for ; Wed, 6 Mar 2024 10:13:43 +0000 (UTC) X-FDA: 81866202726.02.BB566B8 Received: from out30-130.freemail.mail.aliyun.com (out30-130.freemail.mail.aliyun.com [115.124.30.130]) by imf02.hostedemail.com (Postfix) with ESMTP id 985C680013 for ; Wed, 6 Mar 2024 10:13:41 +0000 (UTC) Authentication-Results: imf02.hostedemail.com; dkim=pass header.d=linux.alibaba.com header.s=default header.b="aVH/oJsK"; spf=pass (imf02.hostedemail.com: domain of baolin.wang@linux.alibaba.com designates 115.124.30.130 as permitted sender) smtp.mailfrom=baolin.wang@linux.alibaba.com; dmarc=pass (policy=none) header.from=linux.alibaba.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1709720022; 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=4g/R0jCgsevYl+dbAndNjHJir7WSr02n7lRtU5f3/zXaqreJ/S6BjAjFdnPTgqcV7S5rgs iMwV2oKQxcwpzV3HzDz9nuulGULevEB0c/5E6jk9mBBEhfnKnH5C9N7X+WCSpxmLySK+m3 J7UupfYgdig+Exdfmnja8kP4w3WMNUk= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1709720022; a=rsa-sha256; cv=none; b=ucUtq4jCG8Y/RDa5h0akpI8rdGKAiU3lFZF1wP/Q7duoqfV/UgH3Y5OT6yf5e0aXfaTS++ xQqX51OJQANO1uRJPqLr63EsEWsdgT8Dszzo8tx9N2ilodKixg9yqpIT3Zo1SMSCSMrxMo bW8q2R7RGGJuMM4ZyMiTI5XJIAhfXOo= ARC-Authentication-Results: i=1; imf02.hostedemail.com; dkim=pass header.d=linux.alibaba.com header.s=default header.b="aVH/oJsK"; spf=pass (imf02.hostedemail.com: domain of baolin.wang@linux.alibaba.com designates 115.124.30.130 as permitted sender) smtp.mailfrom=baolin.wang@linux.alibaba.com; dmarc=pass (policy=none) header.from=linux.alibaba.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.alibaba.com; s=default; t=1709720018; h=From:To:Subject:Date:Message-Id:MIME-Version; bh=jQS6ixAjVk0AC8cKYwTBDAm2HkLKEDsUdifzfOmBcs0=; b=aVH/oJsKmuK6AiXGW+Yhae9St6wsrA+7CYmVTQyL6WXrMA45Ym8q7cE4mc3QAGNjSve/8uzcXVWPvHkxX9Lo1UKlrEko+TNsrrsRzfrKXLFO6PYLgwM5NjXyyZfAuimM0UZnYzeqp8abGal/E6v5Vx+OfdCGAPr9JhSCGrzwp24= X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R131e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018046060;MF=baolin.wang@linux.alibaba.com;NM=1;PH=DS;RN=10;SR=0;TI=SMTPD_---0W1xC4Y-_1709720017; Received: from localhost(mailfrom:baolin.wang@linux.alibaba.com fp:SMTPD_---0W1xC4Y-_1709720017) by smtp.aliyun-inc.com; Wed, 06 Mar 2024 18:13:38 +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 v2 3/3] docs: hugetlbpage.rst: add hugetlb migration description Date: Wed, 6 Mar 2024 18:13:28 +0800 Message-Id: <63fb16e7a4ebc5cb69ce655af86e29b2d8e9ba34.1709719720.git.baolin.wang@linux.alibaba.com> X-Mailer: git-send-email 2.39.3 In-Reply-To: References: MIME-Version: 1.0 X-Rspamd-Queue-Id: 985C680013 X-Rspam-User: X-Stat-Signature: 1ocjxnywekfmsed6ur315ra5tk9bazqi X-Rspamd-Server: rspam03 X-HE-Tag: 1709720021-32525 X-HE-Meta: U2FsdGVkX18wWhl5FFaHtJRyx/Ujk8DMPHlvAUdGHGBjRPVdL80n3QVZvpPGuN4ekotMHFhxHM6xOspOp3DZJpSVrjO6K7cg2+ls6Rhanaw7+fjSvc7ef8qU7+QdQVGB3ZYQDJjVB6t9cVH5VFNDAbhFfkMBifwK115r4gZcwqGsxkYkEg0R6Q2AK1OH85fgYsxQKImGB7lmbuXK83DiLyOVgDsXMRrB9BqEH4aKhaiphGCjfxFiM5lPPqrQQc08L8lT4Im0PORkaVlO+DrkiYG+Hd/++GuygV/knhfeJJkvXWjzE15xJX3GZw1I462UAHrGWLW71Oo72zoPZwvvOwWKs/45Xpd3MdsGirYtGND0l7IpNNCXJYbLp33m8IuCVnUkYoQkTPSGARhLGY8NjMDvSg46MDZ3KKBPVmjzS+ASG+fo2tZ4Y+LR+uhxwy3Mzy93v2lB60/b9tQxTqDw/eUqL/tbNjVLFTRRm394eX/7LlXQroEBJzgLRIR5DnX5suzSBdhOxs5em6xKt1fElmJwH5wlrUyLmHD3JULloq5J5wthhkep6f04mnxWlamKrNYW0AjzHpJSiGYe6L5NUMEEf1FuUvsArK4peFi88OfDMitGtBROXTzF69BdAh60AzLs0br1b0TBeOwxcamiOaYDphvoqZgDKgjdV07eHgG8FHZkWkyFZyfKML56ln97o5SKzOi9BatQDbMWrZJwR74+pA+4iVHiMjr19kgJIjLNKRa6F9r+C+Vb9JbZiOUyz67K35ce+lQcZ6eoX8fo7yYuLSfkX8eyTDsfZ1FbvGW1S7HUuqWt0uqVj7ytMF7Xl/dNofnPzJZMI8+0C0BpilnKDrqWJ9oQqslYfZv/hIS1qu8l0x3Dml6WVJ+jikj2MPUGT4kOI3NZ52cFbgxBwnZdy1Rr+FR2 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