Received: by 2002:a89:2c3:0:b0:1ed:23cc:44d1 with SMTP id d3csp969580lqs; Wed, 6 Mar 2024 02:14:49 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCViI7V4PPZfnkalQJkLtgmQ7YABgSmYD7Kz8lwuDdJkOYRxBAf9kNtDGM+xXcgR6nYm9UYLhr4bEZfK0JsjJxZFAn5pJC9Opb2NzUmClA== X-Google-Smtp-Source: AGHT+IGP/jNdCtWEd58KtVV8M3ebqgy3/dVLJHgMglwIqb8Jz0tNg8cOqoYz/encfce5GFSuKTx1 X-Received: by 2002:a05:6a20:8925:b0:1a1:4bb8:3017 with SMTP id i37-20020a056a20892500b001a14bb83017mr3638440pzg.61.1709720089009; Wed, 06 Mar 2024 02:14:49 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1709720088; cv=pass; d=google.com; s=arc-20160816; b=CMJI7dobbx80KJIZFe6GI8zPcoHxn2HMJgEp4KycVIkRMosZLFthlYuDF0KOqL3R3d uiIypwDgOI2uc2hnJ9s4QCLbyBSbkEieu0gYTyCLOUnx/9H90vS/82wHUMp3R1WMnAgh HXE/VVsr8ivQoeiMsFE/f5+os5bGSZsvKLhcPDNF9ZfwEWO8dAx9jY7Le8CExMarvEEU qXBcVOAL0WT+zhzEd27UUpJ9f/GxsvZ1LFvdkZii+w6QlsxTw/xlll906WRDAwQGTiaS KeHLIrxLejg3V+v7yxNDAYjW0nMM/OiuLIJhb+JdCoQQOUuzld2bZLTq/8HA7MwZ5Zs5 Drnw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=jQS6ixAjVk0AC8cKYwTBDAm2HkLKEDsUdifzfOmBcs0=; fh=Eg1bbkMBB2FpJxkcjuowRNwwz/msSkRTpuEVSvFESpg=; b=ZMMRdrY4/g6rRJcFdV2kuVZnn0eOA1YsDCgQ4yCKbyCTXOIcBj4e8D7IzVKpUNjViK XaWREuW6BZKPhCAS3ECKy/hUZod+GGO/tpiK3HRtEM8ZcLI1FAyd8qiaMpVHVxkeFZdk uZ4nl3fMM2HpAjUSlnlsK83Ar4xSjzlwcj97knilI0rcNYd+59n0TZDBU/Ss0ephUquK YrkTn2OsoT8CS9naXoQZ0BFuGetWu7xnWnrK5wpoo+CsV0STa2PQg4VKSlL8NYQOsd/a IMJkP0j7hYGcgkGMY2epfAlS9o/n/6Ld3iuqRDPHxvQPj3c0rSu0slQuRyqvATyH8EDd R8Tg==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@linux.alibaba.com header.s=default header.b="aVH/oJsK"; arc=pass (i=1 spf=pass spfdomain=linux.alibaba.com dkim=pass dkdomain=linux.alibaba.com dmarc=pass fromdomain=linux.alibaba.com); spf=pass (google.com: domain of linux-kernel+bounces-93719-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-93719-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linux.alibaba.com Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id jc23-20020a056a006c9700b006e5aa0f8668si10692235pfb.135.2024.03.06.02.14.48 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 06 Mar 2024 02:14:48 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-93719-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1; Authentication-Results: mx.google.com; dkim=pass header.i=@linux.alibaba.com header.s=default header.b="aVH/oJsK"; arc=pass (i=1 spf=pass spfdomain=linux.alibaba.com dkim=pass dkdomain=linux.alibaba.com dmarc=pass fromdomain=linux.alibaba.com); spf=pass (google.com: domain of linux-kernel+bounces-93719-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-93719-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linux.alibaba.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id 90D8A2899FA for ; Wed, 6 Mar 2024 10:14:07 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id DEEB95F86B; Wed, 6 Mar 2024 10:13:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linux.alibaba.com header.i=@linux.alibaba.com header.b="aVH/oJsK" Received: from out30-124.freemail.mail.aliyun.com (out30-124.freemail.mail.aliyun.com [115.124.30.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 041235D750 for ; Wed, 6 Mar 2024 10:13:40 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=115.124.30.124 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709720023; cv=none; b=MusrVvZHrbsTnpUyZOXZwmnSBXRRF9Zbs7ObEcklZlHCHZvlMlgy8KTG0+KbQsH8yX95NfCTzQrvuaR4l2Hc6SeRJy0jOjs8FEAaMxiJEg2q+czdHm/nzLQnNzhuN1sFa7Sb+PLwrkwvrHrV4Yx4IyqVpw1SUIbvm8Wr8bRWyIE= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709720023; c=relaxed/simple; bh=MzCC0AE/rUvpEAo4tb5cVZ7cGsewHKgZszzxyYlWgms=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=foAprtJ0H+fGcIz4XPbPNRAhY935n/+B6B8RZibPe80XKR0g/n0TKrliKrklrxgYo03xj/EGaw6ob3JSkkmDAEWpmI/+qo07/D10xj++eNB4S7TIkVZI8tDMjNmfSwlWp2xIDi/68x8qdKaHFyuyG+tz/pg6QItpn7+L7BrbJEg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.alibaba.com; spf=pass smtp.mailfrom=linux.alibaba.com; dkim=pass (1024-bit key) header.d=linux.alibaba.com header.i=@linux.alibaba.com header.b=aVH/oJsK; arc=none smtp.client-ip=115.124.30.124 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.alibaba.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=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: Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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 -- 2.39.3