From patchwork Tue Sep 24 01:17:09 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Sridhar, Kanchana P" X-Patchwork-Id: 13810021 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 A58B7CF9C5B for ; Tue, 24 Sep 2024 01:17:41 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 769E26B0098; Mon, 23 Sep 2024 21:17:24 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 6B8566B0096; Mon, 23 Sep 2024 21:17:24 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 3ACDB6B009A; Mon, 23 Sep 2024 21:17:24 -0400 (EDT) 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 05CC86B0096 for ; Mon, 23 Sep 2024 21:17:24 -0400 (EDT) Received: from smtpin28.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id B1900AC729 for ; Tue, 24 Sep 2024 01:17:23 +0000 (UTC) X-FDA: 82597868766.28.670F292 Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.12]) by imf03.hostedemail.com (Postfix) with ESMTP id 99E7D2000E for ; Tue, 24 Sep 2024 01:17:21 +0000 (UTC) Authentication-Results: imf03.hostedemail.com; dkim=pass header.d=intel.com header.s=Intel header.b=lfAAnKzt; spf=pass (imf03.hostedemail.com: domain of kanchana.p.sridhar@intel.com designates 192.198.163.12 as permitted sender) smtp.mailfrom=kanchana.p.sridhar@intel.com; dmarc=pass (policy=none) header.from=intel.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1727140523; 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=hYr/0fE/hEH7EXfr+sA39oMCJTKJM3BQ1R8I1zTAG5k=; b=Kioa5KfbxVHZLkgULpWkFYp5Xb6CSVYB0vsbN5clm9FP8CzFU3+V+lB5o9oWvw+wfNaOvC arq7xz+F4+OZ19oIUDRGf3obTrRB0pzxiLB5b+D5iejd3ODqu90RoX1AHxPIF5nZbj78Fq EcFov/TfW6ywIgLP6xFpndZfYVlDU9c= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1727140523; a=rsa-sha256; cv=none; b=lpgCgN94mgYuisCfWCKj8szhr6bdXoCaqgPALWbeIo0zd5JSZmxpmzj1KL0c4QL569Nb/3 tmu7x+kHVrxx8YgsyhWVFagHrTV2tNo1Xa5A1WvO4duwVGgcFAWAbVNj9GBjZIWWYoeBqp QC2v1S1d8qGURvuoszCcWlfAiufvsK0= ARC-Authentication-Results: i=1; imf03.hostedemail.com; dkim=pass header.d=intel.com header.s=Intel header.b=lfAAnKzt; spf=pass (imf03.hostedemail.com: domain of kanchana.p.sridhar@intel.com designates 192.198.163.12 as permitted sender) smtp.mailfrom=kanchana.p.sridhar@intel.com; dmarc=pass (policy=none) header.from=intel.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1727140641; x=1758676641; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=6ALoeaC41g+MaGEwJSRyCvBiONdX4EAtPZdFIMUQEE0=; b=lfAAnKztoMX1kyVthhgb8tae9VejhfjwE71+v+ojhZWSZxl7yVuxVQa+ mivpfSqsl5uhu+RnlxJS/lbW3z+QuxwcVz8+EJ42EMzcxj1wOgsnH/8GD qvCc+stgM2gMm93wZdSDD/qezuHx/tbh26gT80cF2BXICm+5EvVgZx27O 9DHQx6cHCJtbn01h+JQHjrbMJJUGZKgUCIYCo+bKsTd4N5zSb33artgJz PdvoR8i0wF0K3wSnAGUjPhT1aeM6DjusCWoYSHKKLDgM4dMc6zah+VeT3 4QG/9LMkgR2gL2wkEjJsmlINNAqLDtbX5S7OLchewMAbV2hE23R2JAyw9 Q==; X-CSE-ConnectionGUID: yIhbLTWaTLSIdtHySu0YSw== X-CSE-MsgGUID: H050/3llQ7Scrac5b5dhSA== X-IronPort-AV: E=McAfee;i="6700,10204,11204"; a="30002053" X-IronPort-AV: E=Sophos;i="6.10,253,1719903600"; d="scan'208";a="30002053" Received: from orviesa001.jf.intel.com ([10.64.159.141]) by fmvoesa106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 Sep 2024 18:17:11 -0700 X-CSE-ConnectionGUID: XVBMt6QAQySzvitwOcWK+A== X-CSE-MsgGUID: EuABZkyHT6aA0zdKQwNlSA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="6.10,253,1719903600"; d="scan'208";a="108688466" Received: from jf5300-b11a338t.jf.intel.com ([10.242.51.6]) by orviesa001.jf.intel.com with ESMTP; 23 Sep 2024 18:17:10 -0700 From: Kanchana P Sridhar To: linux-kernel@vger.kernel.org, linux-mm@kvack.org, hannes@cmpxchg.org, yosryahmed@google.com, nphamcs@gmail.com, chengming.zhou@linux.dev, usamaarif642@gmail.com, shakeel.butt@linux.dev, ryan.roberts@arm.com, ying.huang@intel.com, 21cnbao@gmail.com, akpm@linux-foundation.org Cc: nanhai.zou@intel.com, wajdi.k.feghali@intel.com, vinodh.gopal@intel.com, kanchana.p.sridhar@intel.com Subject: [PATCH v7 8/8] mm: Document the newly added mTHP zswpout stats, clarify swpout semantics. Date: Mon, 23 Sep 2024 18:17:09 -0700 Message-Id: <20240924011709.7037-9-kanchana.p.sridhar@intel.com> X-Mailer: git-send-email 2.27.0 In-Reply-To: <20240924011709.7037-1-kanchana.p.sridhar@intel.com> References: <20240924011709.7037-1-kanchana.p.sridhar@intel.com> MIME-Version: 1.0 X-Stat-Signature: d8rhk6wni5pknytxexi75qzznemdsbxa X-Rspamd-Queue-Id: 99E7D2000E X-Rspam-User: X-Rspamd-Server: rspam08 X-HE-Tag: 1727140641-14380 X-HE-Meta: U2FsdGVkX19eFxbSDurwa9gYlmIrMMKueNkCKSF9sDdF/Nlgy/Mp7FDRLD2QJB9/fZU6B4RLDXmWcqptaR0FCkEfM0ABv2TRtmqx3lmCknkOtnmvjr0Uo33AvO85cwo/NkO37CfFgIQWLt5KtKYtGRXIzb6tfQ/IA/zJuZz4lNJ85ifheIEdmPsfBePJhhqV3WKesk50+2V21wijG6g+1SvToxEBCeu7r881/edIDZIPwrc+14qY4SpotVpnMW+qSPWWG5H30HuotXPxV7DmrICr1igJjCEDsF9SMC+RfZgE4W3j65+mscTmFpuuI59PGnccGXc//CajBD1SZ/EODgNw7Hq+iiPJDS/koIRsWGkWXn05x2+QkOjOnWX/75T041tgWvpA6hkuz4BV0XU2yaszLBY/NOc4YoSgyGVQocVupeG4+xILRLipkiCHwX2P9e3VDrfoGXlHBk4rCEdYUxFyUbHzRlfsNb+4EFcqS0g7si2UbCEHx3WnW1pOWEEw2D2/IkY9v/blYVJP4kHuLrslymSW+wwhlWWpd+whOkmLEx8hZjhZ4j6KwZVV48MM/eDTZuqrGSSpT1EwyLdO3ciSnGy//F7lA75pCEG90sssqviwkOpnqNAKeUPWbH0BuRPpHOYMs7JsOFoGE6rE3q5DpBGyPOJ3HXryWShZUv71TSYdGwCHSKX/bH7W/C3Wwv97Q6pTb/aealquSL7Gxxpiqav4dMmXunN7sQc7S+HcgTrsyV0D8pkcCFYSzy+7+d+oZ5tjf1gqSrIspl9w8/FKIRa7fyWAtcfpNZCu8w/EVIjYMs4uK6gl5mUCO6RPtJ/eccNm91x3dtjT7K8WX+pdnjefD9sk6Jujy9RR1V+11ZwTqQQDWqIuGj3EKAoUvV47vwoGDsAGMeJTah5bZrJLYGbktru2YZ1PtNN+Lh4QskunTEteLb14a8ZkktcHP8itLqQFukErG0iaQqd iuc2rKWr 8Mk4KzJuIv6Yc9hswygkbDbzkch1wwN/JB80F0PhXrIe9+8DXuGSKB1J8YHggP8Z/QXgzoA+/xQ42DX2wJGyti+Zyv3goxHMkmScdpUuvJY4VS/DPXk7zoSLlFv71e+hhZeK8KReEyIOiqZp9YdaC6rNnFdDZKI1XP+FnHCAUz9GuaN1Ge6DcV+C9dw== 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: Added documentation for the newly added sysfs mTHP "zswpout" stats. Clarified that only non-ZSWAP mTHP swapouts will be accounted in the mTHP "swpout" stats. Signed-off-by: Kanchana P Sridhar --- Documentation/admin-guide/mm/transhuge.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/Documentation/admin-guide/mm/transhuge.rst b/Documentation/admin-guide/mm/transhuge.rst index cfdd16a52e39..a65f905e9ca7 100644 --- a/Documentation/admin-guide/mm/transhuge.rst +++ b/Documentation/admin-guide/mm/transhuge.rst @@ -530,10 +530,14 @@ anon_fault_fallback_charge instead falls back to using huge pages with lower orders or small pages even though the allocation was successful. -swpout - is incremented every time a huge page is swapped out in one +zswpout + is incremented every time a huge page is swapped out to ZSWAP in one piece without splitting. +swpout + is incremented every time a huge page is swapped out to a non-ZSWAP + swap entity in one piece without splitting. + swpout_fallback is incremented if a huge page has to be split before swapout. Usually because failed to allocate some continuous swap space