From patchwork Fri Jun 28 13:07:50 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lance Yang X-Patchwork-Id: 13716111 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 0DE77C2BD09 for ; Fri, 28 Jun 2024 13:09:19 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 9991F6B008A; Fri, 28 Jun 2024 09:09:18 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 954336B008C; Fri, 28 Jun 2024 09:09:18 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 7C0C56B0092; Fri, 28 Jun 2024 09:09:18 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0012.hostedemail.com [216.40.44.12]) by kanga.kvack.org (Postfix) with ESMTP id 5A4E36B008A for ; Fri, 28 Jun 2024 09:09:18 -0400 (EDT) Received: from smtpin17.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 0CB77120331 for ; Fri, 28 Jun 2024 13:09:18 +0000 (UTC) X-FDA: 82280328396.17.CC30AB5 Received: from mail-pf1-f179.google.com (mail-pf1-f179.google.com [209.85.210.179]) by imf15.hostedemail.com (Postfix) with ESMTP id 2CE2FA000F for ; Fri, 28 Jun 2024 13:09:15 +0000 (UTC) Authentication-Results: imf15.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=GZUw8PYg; spf=pass (imf15.hostedemail.com: domain of ioworker0@gmail.com designates 209.85.210.179 as permitted sender) smtp.mailfrom=ioworker0@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1719580137; 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=8fwqZttwC+ZbW8FD7nFrsLap1fPEL7EKx4IYhcmZWAQ=; b=3JQIAFEcxzBWbwNqc3XCWpgA0tNLGT1ufdqBu7YJJ3IueppiMCmzXnWveR6Btj0IQu96wU IRd3vh5RbMBQ2AHDzK7htANl0LY3iuetIgN9lo0oUdOVbR67OUwl7PfKferEeUmoIVmDRD Hk0/Yc1ON9DGXj/vTzU9lH8sr7PLKws= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1719580137; a=rsa-sha256; cv=none; b=AtBpc93oF3lYp+2u3q6PTfbxdN8XkVx0Ex8KX82f95AnjHv4oIQAlCxDP/ooEIKZ/i+o7/ 4+n6OSRbcG+JsdtJI0QbrypS5D45dmQkfyvA76XR7urtLZwJHAUlsCmXpnYpTdVIGbEIav uYGLwknlNV7MGxsZMcUylFyjwHr22ec= ARC-Authentication-Results: i=1; imf15.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=GZUw8PYg; spf=pass (imf15.hostedemail.com: domain of ioworker0@gmail.com designates 209.85.210.179 as permitted sender) smtp.mailfrom=ioworker0@gmail.com; dmarc=pass (policy=none) header.from=gmail.com Received: by mail-pf1-f179.google.com with SMTP id d2e1a72fcca58-7066c9741fbso484003b3a.2 for ; Fri, 28 Jun 2024 06:09:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1719580155; x=1720184955; darn=kvack.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=8fwqZttwC+ZbW8FD7nFrsLap1fPEL7EKx4IYhcmZWAQ=; b=GZUw8PYgx+nPS/fJzmknTHlZCuREwfcLTRbpXVRGfEfGgXdWPiW+lZcEeK1pAkkI4c Vw64Cqo17NnLBAroGL53IJl2rifs9Z2IK4109nWrjILne6Vup8xYGSGyTYPJNSGLwqSt vN/vZoJiSNNFy35w4NAnittKRP58Q6zO9CeDzflI7NoM59T23Nkzr/X/M+RS785c/BNl wG16ORxk2gc+2XBrzzwY0wUG62NDV/BAMhVj+Gcx1IfZCqzeOzi8xObw8ESVJjCSFlmU fBfKQjeyKB68xxG9dbVbsmkqcpa22iPzrzLB+G+pcF8iNeakuR+B94V75nm1lISpm579 3RoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1719580155; x=1720184955; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=8fwqZttwC+ZbW8FD7nFrsLap1fPEL7EKx4IYhcmZWAQ=; b=WM1noJlKZqaGVjhm+ydhJcIieZwfYS7uK7MVEZaAH8DCJ15u5QKsJnbuLVX6BNfuoR 4WLWr8rg+Mz2F2M+qhm4RTbcZQCU4ljz9KdL6lI1f2AjAqhcvuZMyDJKMuZjfKo6sVPu 9mkC+jAFeAyzuhf4dPBTBvmWhWcOiSy41Zn1nlElLGymjVyjDSJF3ntTr/Kcy3ZGKPgw /z2Q5wotQskMUdK2gkXQcowBMGxjnZ+9UbhrracExTt182peeQOwZgP+OP0IbxHo+Rc0 hHSxB0L/jZoczZQNA+/MVj1GNzwQPew1+rGVlLQoho+HvCIQfz6GM3OjU1pzY0F5xKLF aMKQ== X-Forwarded-Encrypted: i=1; AJvYcCU/eL2UXcUNjQpiia+QK4u9FkbAB4C4pzNMjMGvSmgSk4bqmj+fFX+zE+CHekmL44vnDwAnbizenym8cVQBOiXIbi4= X-Gm-Message-State: AOJu0Yw0QZsJgDokHm2hw9xPsNK43IP2hvhMR/wS+Wvjco1mVtTaEvwz XGcFG09K/qURRBIDeM7CokNAqnk6Pm68nqRnJF73GrXE3CrJMyQ8 X-Google-Smtp-Source: AGHT+IGn9DD50DNkYgejYoYqzKV81yY1R9ssvw1Q4pWXXVQ+kRqODZU3f60f4qTWaKwYCs6Dn2f3Ww== X-Received: by 2002:a05:6a00:3c94:b0:704:23dc:6473 with SMTP id d2e1a72fcca58-7067474dc86mr23147585b3a.30.1719580154982; Fri, 28 Jun 2024 06:09:14 -0700 (PDT) Received: from EBJ9932692.tcent.cn ([124.156.216.125]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7080498946bsm1526102b3a.200.2024.06.28.06.09.10 (version=TLS1_3 cipher=TLS_CHACHA20_POLY1305_SHA256 bits=256/256); Fri, 28 Jun 2024 06:09:14 -0700 (PDT) From: Lance Yang To: akpm@linux-foundation.org Cc: dj456119@gmail.com, 21cnbao@gmail.com, ryan.roberts@arm.com, david@redhat.com, shy828301@gmail.com, ziy@nvidia.com, libang.li@antgroup.com, baolin.wang@linux.alibaba.com, linux-kernel@vger.kernel.org, linux-mm@kvack.org, Lance Yang , Mingzhe Yang Subject: [PATCH v2 2/2] mm: add docs for per-order mTHP split counters Date: Fri, 28 Jun 2024 21:07:50 +0800 Message-ID: <20240628130750.73097-3-ioworker0@gmail.com> X-Mailer: git-send-email 2.45.2 In-Reply-To: <20240628130750.73097-1-ioworker0@gmail.com> References: <20240628130750.73097-1-ioworker0@gmail.com> MIME-Version: 1.0 X-Stat-Signature: ingxmepqs4p9exupowm56x6tks4zmjgt X-Rspamd-Queue-Id: 2CE2FA000F X-Rspam-User: X-Rspamd-Server: rspam08 X-HE-Tag: 1719580155-434329 X-HE-Meta: U2FsdGVkX19eBwfy8iis6M89pxcHserJDAozQrUrG8UXteaLVxGDppwHJQMFAwl8iBbJ9HmqhIKdcE70NmvCvIv4PRe3dMYRLNytjHqpc4S4XF1zDuiSsdyNS65E42UtTd65NKY51ksBqMoyEa4QaWr1LGAq2mhGXaCsplM/QTHKDd3TsZnEF/8kImk3n2hPE/1C7zwEKnblY8sezm4lV0dPyyLHiaN3c6PXOHB8GdM2nEbca7fuSpQQRj5iQPeKQ8+R/EcEDvlJrHBuOPB/QuEa6Qj+2NJVEg7kTTaku4q0fIw15Lc6MeBLvR59W1sqSkVIj95peeX9MrSp4rcg7tyI26J+IqC3cRhX7qV6uhPEXWQZw7wZ9sKPKNwOD7LZq3CQ2lKKDaiC/orzR8PLzj6Pzhr7KGRvPSgr0PNyC54CyLaEtIp3It9SMGrb2gSnp0LPH1pACDBDGF0v3wEgFqsGqn521V1S8YkQp6asm44xJ2L8DNvQdNfRRMvUKC4roIJcwR6BOJGpHOggVIA7nJ1Q55XynQY8H5G8cWVkZq/2j2K989d+ZEOk+oIEzOm4/MWmWzbaf+xoLsd+/JCfLhKFvDN0pdYR1JDdQqL4zhLl+JPIE4+cWmqit/aa9OGdYMyA/ohpx2VKtsOoz/zwfZWk0cAoBAncGNXpKIS++hV5LoKWhc6wbgXT2/shDxG6BfWqprGDAZM8zYDZjhH4LQRlf9qECo0DnreG08m72MPndDYiL8KyBExrPN8kvUxjHkCqfwHjyyc7FbxWD+d1aE5wY+NfKqezJcqJU8Q7nFbLmyk9cvzb3Udp5oI2pFnxJnvG8fsBgDn94T5oFyQ7JCmMc5E8pk0UYyTsbzBJL6Hi+9jg0JKy/xRXXEQQe8IGWdD/Ub38IkCecADlAW5KQYPaoL4AERy9azLXiJVUHEbz48a28lqzTucJbYTOLcdufawXv52ruyYFiLwjAvp QtCUVAmt Q33YsriP3iZq+shLzPsSp7NUaMbOzbreTR19U8aX1y3SRhW9C+ajwsw4CEChcGaomlVb6Z6g6UaMtV3j6HsF2lkvHPao7rZINxe8NmbBDeettZN9gCaFPCe2xnfmjN1ncv2gTc3JgqiD2IcUU9ClA/Teh+J6Dl+JwtbimEtNPMmXT8FymkEXg6xT3mqJK8Q4YsiZPJirJ4WI4KbgmDGUS1Kk6/jbgcoT4sxMwqEEALCE3OfsBSrMFKM1mm/LPQ05Vb00ys4AcTEl7+CPjRSpK06VBEK+hCF+LliqQVZyw+0jx2kEUoldPJic+XSlZdolz7iafRTvIMaaZluzpUFLgtuJBY8/PPH4eQ3zs/xWy8IUFTCJm1wOSO0Yspw== 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: This commit introduces documentation for mTHP split counters in transhuge.rst. Signed-off-by: Mingzhe Yang Signed-off-by: Lance Yang Reviewed-by: Barry Song --- Documentation/admin-guide/mm/transhuge.rst | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/Documentation/admin-guide/mm/transhuge.rst b/Documentation/admin-guide/mm/transhuge.rst index 1f72b00af5d3..709fe10b60f4 100644 --- a/Documentation/admin-guide/mm/transhuge.rst +++ b/Documentation/admin-guide/mm/transhuge.rst @@ -514,6 +514,22 @@ file_fallback_charge falls back to using small pages even though the allocation was successful. +split + is incremented every time a huge page is successfully split into + base pages. This can happen for a variety of reasons but a common + reason is that a huge page is old and is being reclaimed. + This action implies splitting any block mappings into PTEs. + +split_failed + is incremented if kernel fails to split huge + page. This can happen if the page was pinned by somebody. + +split_deferred + is incremented when a huge page is put onto split + queue. This happens when a huge page is partially unmapped and + splitting it would free up some memory. Pages on split queue are + going to be split under memory pressure. + As the system ages, allocating huge pages may be expensive as the system uses memory compaction to copy data around memory to free a huge page for use. There are some counters in ``/proc/vmstat`` to help