From patchwork Wed Apr 24 13:51:48 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Lance Yang X-Patchwork-Id: 13641894 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 5C219C10F15 for ; Wed, 24 Apr 2024 13:53:04 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id D87746B0260; Wed, 24 Apr 2024 09:53:03 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id D37696B0261; Wed, 24 Apr 2024 09:53:03 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id BB22F6B0266; Wed, 24 Apr 2024 09:53:03 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id 99CE06B0260 for ; Wed, 24 Apr 2024 09:53:03 -0400 (EDT) Received: from smtpin11.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id 55322140861 for ; Wed, 24 Apr 2024 13:53:03 +0000 (UTC) X-FDA: 82044566646.11.46C40D9 Received: from mail-pl1-f182.google.com (mail-pl1-f182.google.com [209.85.214.182]) by imf22.hostedemail.com (Postfix) with ESMTP id 5565DC000C for ; Wed, 24 Apr 2024 13:53:01 +0000 (UTC) Authentication-Results: imf22.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=GsCSFBOI; spf=pass (imf22.hostedemail.com: domain of ioworker0@gmail.com designates 209.85.214.182 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=1713966781; 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=8eSXSlkmErEctEhBOKS7ewxnrkbMKKDa4aGhbCp7pwQ=; b=AJ9F0VtYxneoQJtKnTX9S46oTS3Zs1ewgZMLjdUQOYpDHSdnmNL1aEwsEbghbPdDoUrDbu IoUhsEWD0TMpKd7cDw+mVW5ZD32iaVoE5NPILzR/hfpCDajB3y5WYxh5ZVmBSONdOAKkj8 lT4HB9f1wR15Ocqb6W5SXZwvBXR4s/E= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1713966781; a=rsa-sha256; cv=none; b=fCQDlnBzQvnuKq6NewzhxSYeRYLJpcOopsoyBpvICY2YpqBYN+pHG/4ijRHqKXgX+zO6cZ 2rGCxJS7UIDfD4u3A/c0X6363e7lRE6ydw1cmZYXGfbZoS9WJQZDUqorDT8Jw5+mKfjLwC Rg115TKMKqR3yJjniH+KDUtSOb9m7yE= ARC-Authentication-Results: i=1; imf22.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=GsCSFBOI; spf=pass (imf22.hostedemail.com: domain of ioworker0@gmail.com designates 209.85.214.182 as permitted sender) smtp.mailfrom=ioworker0@gmail.com; dmarc=pass (policy=none) header.from=gmail.com Received: by mail-pl1-f182.google.com with SMTP id d9443c01a7336-1e40042c13eso50744545ad.2 for ; Wed, 24 Apr 2024 06:53:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1713966780; x=1714571580; 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=8eSXSlkmErEctEhBOKS7ewxnrkbMKKDa4aGhbCp7pwQ=; b=GsCSFBOI9Ppowx4odicpMhnVLgqb8lahNmcskNV4saS5gXMHadAQRluwkePrzgNlZK dJP3K1laNCongAc8arEUxofk1fGJ85uWOmNUy3Tou0e3hipi4RDFgtOs5cv16a+d2x2B ZXKh7hg79ZH4eIQ+GA1g/G5CnFjS9ZcGcWtzxzw93lI4vQMcZDKioeFRXWXu2W6GJfyW fs9jAdg2v/KFwB9KU/lLZqIItpKpGfCrlvs+mXYWWsyXJyht/M8vSmJl2yIOynda7lgH mdjn/mKPtGgsj20Ap/qpvILQVySe1+fDY2Ng9vwyXqVNlgY6+OkK0rgCX5XSSbbtEBb2 3lKQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1713966780; x=1714571580; 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=8eSXSlkmErEctEhBOKS7ewxnrkbMKKDa4aGhbCp7pwQ=; b=IlhoUzq+FO7IVFRLYFAwWSdkMadvTrM8JOtoWmw7bLdz2ub8Fh0BpR33TmuvbZFP98 zD4rURpqH/GFigfRkR4G3QWkWSPK+e8Tb1IYq8heQ4+qJ+sAD2c51IDfGIQcmi63jBSS FFGIQSfAUyWmMYDFNDP06fAqRDY0svf5Fk8Oai4FqIFBVleNh2LmBcWFQaoBEiNbDwI0 wr0RXZO6UJpe4N0WEP7q64zC8FifTyqsjPsUSu7YrdRodLUfVLuwX7NarmxJAQfWvgeq Yuj+h++86x3lTOXgWr/t8paEc36qGeamrZToqw2he8dS6tE00tKGi82ZW5cPIRae6jBS H3oA== X-Forwarded-Encrypted: i=1; AJvYcCUzRzXfMmi8xd7GR2iAYWw0dfK68ubILmzy8upZSpZNb5UnQSWs4MQ4uZPWLFRWqtVa1gyPPr7dsffjkfnCNi0Si0s= X-Gm-Message-State: AOJu0YzhrCUuAcZ4AzRuj2LNOxbny/f2ET4RlbMGPHO90OqPl3MmMIRB VsiNO1etbFwE+T7TtCJx6A+e4i5LSQ9oV0IimAKPqBI1GOhhWCE6 X-Google-Smtp-Source: AGHT+IFpq8EsYQokhHELiawk+TzB5MqVAd/PCoqMESyI7odQvHSf7n7b5/uplpAEizjapcocQJvAIg== X-Received: by 2002:a17:902:ecd2:b0:1ea:9596:11eb with SMTP id a18-20020a170902ecd200b001ea959611ebmr406501plh.60.1713966780250; Wed, 24 Apr 2024 06:53:00 -0700 (PDT) Received: from LancedeMBP.lan ([112.10.240.252]) by smtp.gmail.com with ESMTPSA id c6-20020a170902d48600b001e89c729843sm11140235plg.228.2024.04.24.06.52.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 24 Apr 2024 06:52:59 -0700 (PDT) From: Lance Yang To: akpm@linux-foundation.org Cc: 21cnbao@gmail.com, ryan.roberts@arm.com, david@redhat.com, baolin.wang@linux.alibaba.com, linux-kernel@vger.kernel.org, linux-mm@kvack.org, Lance Yang Subject: [PATCH 2/2] mm: add docs for per-order mTHP split counters Date: Wed, 24 Apr 2024 21:51:48 +0800 Message-Id: <20240424135148.30422-3-ioworker0@gmail.com> X-Mailer: git-send-email 2.33.1 In-Reply-To: <20240424135148.30422-1-ioworker0@gmail.com> References: <20240424135148.30422-1-ioworker0@gmail.com> MIME-Version: 1.0 X-Rspamd-Server: rspam01 X-Rspamd-Queue-Id: 5565DC000C X-Stat-Signature: shjsbw19oqnkjx4sun8cojfpe8yu4cgd X-Rspam-User: X-HE-Tag: 1713966781-67014 X-HE-Meta: U2FsdGVkX1+/o2rfE/dzwMc8fM5KhKQRsA+hvP7685mwBZFAzmVDcGew+OfamQhjy1+v72gKOuxWBssXtkdpkCvy9/joRxZLuotIi+NQLT/tcKjVUPhoozWt204iHPahXDDtC6y+TCe0yot8u8SmwJZvGp82KTJGsWApcIyBbFWBHUMsp0FNU63JKS1aNxg1r9t2SRxDu+izYqFFofHXizcEjUFaW8pUFYC8zXJ/bKpgz+DtkK5ImEUOpXw9/FsuiSLosoU1Ypelr1WygZ1ZFhRDchzyW6QqWGclud6LLaq9hr0ot+wfDx3N2lgEphLwHqXcj5wvjOIcJ/CHp4PhjomM46eVwkVunsXhVRQDeml8luJQmj9ufw/sCSkUdGrfqI1jLFkcj6+mmQgosg3dv78YY4OkLIFeTOIEG0i2sFX6Hx1vYLmpagMX0FuNRTEn3YZS1WCA5VO6QFxiXHpRdafkhh056dP80cgGdhIYJAs8RwOAPUZ6rRuLRx1IiWKZLb06kB9nR2E1NVYqGVaoPFaJHAOKIcGn4CPa8Ef2G0YuF+aqmtzidLGEULcx7pBMzd/AVcVEnNmgjfEsMOKcRDpSjCZ4piuJcKOdo5zFU7p3V9yjg8OK2h1VeU7wvURFjjJKjHG0BVxNKagtRMgCutNmZUY1Y1K30XJ0j7nZeI6erOc23nibZjlsA5NM/2Eq20Bg24bVQ0eRODjSW3cdHUy7d0FvQRn6F1y+bVj6oVWRqwXGP5C9o7ObzixgG7/nqOjkv+jSXBUTPl4fuAwMUi/reanZFkTzwVHCm3IRFpznigLH1phVbDJeM1g5QGAiL/56A9Il1yGyRB1mtB/KR/cw5Z6PPi0k655YN1LjerSL73fo9JvGaiqBMbnBas58gdFw113ROkFx8wxOMlAkvO9XrmamLlocEoFwwZkAtmkc7yoXpiKAFKfuK2mAiarowc89lHEkhT7XBsCiH8o 7xOYHhfZ HEe+T98bTWjDkJgJ3WkneYUrp1LDqSj7zeF7+XbLPra3Dcsg7LzEoIpAM3qyESZY9UIdX3Z1R+UGLCM46qEQGlD/3EEKJe58wzyQzbu8Khg1xvIyLgG1IrmRAJXPDpGNzLmZi37sgSUQqDdChmfdvw9XPzX/XLfxkgaxFLygtNjopkwFi792cl/0yEIwbvZDBb7N6w7wrVaKAsCgeraclb0szp+BMQzcEOJU+ZDVmlRVhlESOgug38Ro1bruh6i8WLGAy6gOEfvFInvDRrpiOVw1f48Nmtwc4Qq8DsrATSVza8gZ5DI9bOSTwRxuSWx50l4L83B+rFwbkKOfx59kv9WHrLZbknQNq/Xzm0wgom2OF7nKSPhUtnDg1BirDD4Bf1rvYmHk7FWWfIBnAwZ7cg9YIL7EWpFvdEEFohmQgP5yprhpWmdPEVRWBA0cbAMGp6B/o 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: Lance Yang --- 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 f82300b9193f..35d574a531c8 100644 --- a/Documentation/admin-guide/mm/transhuge.rst +++ b/Documentation/admin-guide/mm/transhuge.rst @@ -475,6 +475,22 @@ anon_swpout_fallback Usually because failed to allocate some continuous swap space for the huge page. +split_page + is incremented every time a huge page is 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 all PMD/PTE mapped with the huge page. + +split_page_failed + is incremented if kernel fails to split huge + page. This can happen if the page was pinned by somebody. + +deferred_split_page + 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