From mboxrd@z Thu Jan 1 00:00:00 1970 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 A5B2AC3ABA3 for ; Thu, 1 May 2025 04:17:21 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 99C506B00A5; Thu, 1 May 2025 00:17:20 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 94B296B00A6; Thu, 1 May 2025 00:17:20 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 7ED5E6B00A7; Thu, 1 May 2025 00:17:20 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0015.hostedemail.com [216.40.44.15]) by kanga.kvack.org (Postfix) with ESMTP id 60EF96B00A5 for ; Thu, 1 May 2025 00:17:20 -0400 (EDT) Received: from smtpin21.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id ACD58161A00 for ; Thu, 1 May 2025 04:17:20 +0000 (UTC) X-FDA: 83393029440.21.06C897E Received: from mail-pf1-f193.google.com (mail-pf1-f193.google.com [209.85.210.193]) by imf02.hostedemail.com (Postfix) with ESMTP id B8C3480008 for ; Thu, 1 May 2025 04:17:18 +0000 (UTC) Authentication-Results: imf02.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=QBODgAUQ; spf=pass (imf02.hostedemail.com: domain of xu.xin.sc@gmail.com designates 209.85.210.193 as permitted sender) smtp.mailfrom=xu.xin.sc@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=1746073038; 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=kSqWz+uwNyc71utyx5zA29Wqka9YgW7cUa1XkyvqWms=; b=F6I+wfSl3Pn/LnBm5jm1R+4t7g/f1+3u2GrGaAczAR1MaPgNwWNhO32HJA+AdMLiMg0/mu zZG/x1dHU6tCT/VHD3r+EMsIMTNU/4pmFBEZObDi77w6G7V7vV+BGwVL+ZAFRdau5u7V3u fYmw29KXRjMIMrQPwxv5QtAprIZEIKo= ARC-Authentication-Results: i=1; imf02.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=QBODgAUQ; spf=pass (imf02.hostedemail.com: domain of xu.xin.sc@gmail.com designates 209.85.210.193 as permitted sender) smtp.mailfrom=xu.xin.sc@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1746073038; a=rsa-sha256; cv=none; b=J4UFwrAkW9ud88iiRlTZnFGu+PRjZiUEPVpvhHMnEmNhGpgrsPM5dqzdVnTwRuuIZeOCQz UD4VnB864sWGNZRG+Q2ZoUG4EvSl++HOWpQTa0EO9pggrkg6TgqGtnG3eQyUXKV2s01qlf lkKhCNphytzrchrcnAuzfunpLiKiO9I= Received: by mail-pf1-f193.google.com with SMTP id d2e1a72fcca58-73712952e1cso599584b3a.1 for ; Wed, 30 Apr 2025 21:17:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1746073038; x=1746677838; 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=kSqWz+uwNyc71utyx5zA29Wqka9YgW7cUa1XkyvqWms=; b=QBODgAUQ/dk1O0tJjbN95hyKtwuVodGh0dWMSmnwT3QFoEGIze7Ud1pwqtvKzVWPsj pjMYilsrOVlGhEgqfCdPy2pZwUgT7KFBsi+gYc7IUkFRjwr8+wiqTvRVq2sm/IMlzphD SmNojKRN6OLqCG/TJvKu1SPqbY0XSIi8J1lWcOSx3Mh4SviLi9MDyYeWx6uw/aHyI1b0 e4BVb5Wccly9SangieZU6ddSusqvVT1EA9+VvpSe9K80LPA6loaQu/A0/cZLcs1lPCCD 1JF+GxmWWcCqd18JKk1dtDVrfwaS1TQdcc52mwubWZxV3QZHtK6KSCuEgnV2ZJx+GpWq ZNJw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1746073038; x=1746677838; 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=kSqWz+uwNyc71utyx5zA29Wqka9YgW7cUa1XkyvqWms=; b=G7DJJKWlT9ZzuUnvyDrTQ0RdYYyHOSYvcwIzAMmRfVhosTiLVZxV5gttRv1ujP2DGS LSSDz5y0x4w1umegdda4K+AqUNc53dMsFYt2hjxkB4iduLqDdkSGzND/KiSpq1pCze6/ d0bVngkpcGuZSEYNcPLJfi2tEHLac/wHteDH+xVaCe/P7LjpaBBYld33iBHn7GzWHRrs BFKjMnsGs5FEkYl6P9h4y05eklUifYMoV+yB/6ztTChuWwG4wqVN+BG0DI8cxdwv4UBo PYNhnJ1mRKLw13F+W+2o+1qWRnQXE8vuS4i9HIG8W/gzCMJXOQGB2d66CZ8M7GdEFZjL ggcw== X-Forwarded-Encrypted: i=1; AJvYcCWmhPIvVGk35Ho3ugZZsz0ZtaUgJx4MIVroGVd+cHUB5i+edSsEE1xEYAF0iCqD2Ck22R2gvbH8Ug==@kvack.org X-Gm-Message-State: AOJu0YyB9CdBpAuXdvSGuXy+u/oXL0M7oPwsOv7R6uHmhTtaN2XBWDED K7QPnatV8pMEKeZSCWQRmu3HuNGx4tb3rAaIjJN6Jp8zlVAlJy0e X-Gm-Gg: ASbGnctKuTbvt52OUY6t2eYSPjUJcXyNrfjiAbHoBhrcAjMfj9CnLHTco/VmSJAs4kX fxQ5lzYC39TEoOaDvfzvtWnaLUUDP10Jp5qfrWvmZigD9T52+sQZo8JfRsi5UlI+6clTU8GjNAq D21lKVlsmuawpBnenRBo4PhjGtDzz19ZTB9dO0B4BLbRudEgNkpQleFuyDU3E3LYnQe6Jhk0mO8 Q0cuogvru9qCOPFaDxHDFjTp34EGzOEzgcqEjY9M9ahR2Gv3haI90SpF026P0qrQuOx9hMYhV8f p0MkoOYUnBfmXLy64o/DEozsYgTPmhGV1w013Loa7nMmTBgju5dRS8XDb7MH/Gt/ X-Google-Smtp-Source: AGHT+IHhhWhjtWqWjYhISbbYXlaaZG6J8Ta7drcMEv/LrBwlqg/TrkGMke/PM4xEXkJPcepQjnZfzg== X-Received: by 2002:a05:6a21:1511:b0:203:becd:f9ce with SMTP id adf61e73a8af0-20ba8e4bbe9mr2663073637.39.1746073037614; Wed, 30 Apr 2025 21:17:17 -0700 (PDT) Received: from localhost.localdomain ([193.203.214.57]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-74039a30e50sm2548943b3a.119.2025.04.30.21.17.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 30 Apr 2025 21:17:17 -0700 (PDT) From: xu.xin.sc@gmail.com X-Google-Original-From: xu.xin16@zte.com.cn To: xu.xin16@zte.com.cn Cc: akpm@linux-foundation.org, david@redhat.com, linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org, wang.yaxin@zte.com.cn, yang.yang29@zte.com.cn Subject: [PATCH v2 8/9] Documentation: add ksm_stat description in cgroup-v1/memory.rst Date: Thu, 1 May 2025 04:17:13 +0000 Message-Id: <20250501041713.3324621-1-xu.xin16@zte.com.cn> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20250501120854885LyBCW0syCGojqnJ8crLVl@zte.com.cn> References: <20250501120854885LyBCW0syCGojqnJ8crLVl@zte.com.cn> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Stat-Signature: wy6ehyeirrt55x8uug1ejjayc3jqx8ec X-Rspamd-Server: rspam01 X-Rspamd-Queue-Id: B8C3480008 X-Rspam-User: X-HE-Tag: 1746073038-187132 X-HE-Meta: U2FsdGVkX1+kAk2DnVfo4+2AqNEACZKuJDxbEBBv8tSYcuPmYCXTuw6CmkYQpdsOB7o+CLhA3jbWwEoKEiq+yEe/P9cBmJq34RdIaKTXOFZ+qMcLlaXAMBa3N0Q40jMgVF3JRG9YiaEdFHjKXTgECXpMGdaudvlAsvnDtppYhLX/BM1tTrDa22Xc0ZTR0BuPlxYSFB/+x7CnCp/EenbcCWTUK96DIg4zb79tKiYLgZbMEvwyuz59xd0IEMTQI/hy0Tn7EYHu7EIjNJ4lVPEsszKTVTzxc6gG77Mb6ggg6seHptYdMPfwp8OkyNIHKe+IucH3p3UPe98hC1oQl/GJvMbzqivD6wDdU8lInhjznWTT3ad8ZiMVRLHbMR81uvMJijx0JiFdHhRwmvDA7aQ5rZKIf9ajzcsLIRaUOeT9o/Fp0Ynt8oMUx6Xz0Ks2JjLFKpBgdaAWcBlzr6KsHTgID+d/S7R4KtoS02P4v3aKm3KWKU3SSJQS+6zztoIuz4pI0Lm9wJYCGZRwxQ6/ssWhkHeIN7QuUIh2DqcQoV/oSfjwJqj5poyz1NnjzndztI8nD8rm2pUkHBS5Xecm6AvXP/mqvV9eGr1FzLRPLCY5+mIjU8Jv/G1vghwNvSVSmrd9aimWq+WAti2MEAR76LWDhW0LSUIGFHztMMh/Y6BD2Swda0IcRA/FOOk5NI7NNf7sdbjOmBzd/4zdheNJa5GCz1E+2cPj6Zpuz6vkL1ED1VzK/Vxy5R7QGf4WhFLhHPN7ezHIW6W2+/nwBt9M1qKobO7URj+vEaO6ciplvPSCSgcLfJ/kTZlh/AP7uTNb9KDfeTezT1X7RhBJr6p4PWpxlKShns1+dTNK5shVTFYKHEAINlL5EeHkTyLxvto+hKP7Jqhkrlym7iGvzBCGIkjv6UGmgJgUzjskkbP+Y9iygm7yDf0bkNZkrm+bhI+XJUi+1nv0laqkOrGgbxqNnO0 xBK233Vm ElgdhDmN4eKcD9ZWSo9JXmYBlAIy374pjrJd0sx1lw3Qkrl9Uj45JbeMfcXIuvyDK89JGrH+RGxAcPnTEAFNoMNUUj54+vzQpSk87OfhMdM2zt9eXdcDD5DPOdbgrSPJVxXQzqrwdIYFln+dhbsT77fyYjV0c8A7REDzU0Xl9s1iJYqqqDjK0VT8cbXfYgLJREls/zHN4C2JctWzc49FPinKhXockQPAzQd/yJIEGmMsfPdaqO0syMGkHg8/1ARlwBzK7JFnKPbHw2nE6W+eknrT2f/ZU8qI8NddOblLMU5cs2CnzPFYs4U6WrVVMzGPNsMgWVJV26y0wyYqRDhUHdKd5wItWbg1sYexcFhtwuQEBebrPgcgIwqkuRcNR9Efej9yhVkeEIyTeh8+tGDJWgIgvnWm2HNnfTM0grEDiBzsqt56NVMqTd0MQynNxRUB4etL9tyJxjfuR+W/SbzhfsSNhcUhQhE7XN9DoiQ0VNZM4BRg= 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: From: xu xin This updates ksm_stat description in cgroup-v1/memory.rst. Signed-off-by: xu xin --- Documentation/admin-guide/cgroup-v1/memory.rst | 36 ++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/Documentation/admin-guide/cgroup-v1/memory.rst b/Documentation/admin-guide/cgroup-v1/memory.rst index d6b1db8cc7eb..a67e573c43d2 100644 --- a/Documentation/admin-guide/cgroup-v1/memory.rst +++ b/Documentation/admin-guide/cgroup-v1/memory.rst @@ -97,6 +97,8 @@ Brief summary of control files. used. memory.numa_stat show the number of memory usage per numa node + memory.ksm_stat show the statistic information about various ksm + counters memory.kmem.limit_in_bytes Deprecated knob to set and read the kernel memory hard limit. Kernel hard limit is not supported since 5.16. Writing any value to @@ -674,6 +676,40 @@ The output format of memory.numa_stat is:: The "total" count is sum of file + anon + unevictable. +.. _memcg_ksm_stat: + +5.7 ksm_stat +------------ + +When CONFIG_KSM is enabled, the ksm_stat file can be used to observe the ksm +merging status of the processes within an memory cgroup. + +The output format of memory.ksm_stat is:: + + ksm_rmap_items + ksm_zero_pages + ksm_merging_pages + ksm_profit + +The "ksm_rmap_items" count specifies the number of ksm_rmap_item structures in +use. The structureksm_rmap_item stores the reverse mapping information for +virtual addresses. KSM will generate a ksm_rmap_item for each ksm-scanned page +of the process. + +The "ksm_zero_pages" count specifies represent how many empty pages are merged +with kernel zero pages by KSM, which is useful when /sys/kernel/mm/ksm/use_zero_pages +is enabled. + +The "ksm_merging_pages" count specifies how many pages of this process are involved +in KSM merging (not including ksm_zero_pages). + +The "ksm_process_profit" count specifies the profit that KSM brings (Saved bytes). +KSM can save memory by merging identical pages, but also can consume additional +memory, because it needs to generate a number of rmap_items to save each scanned +page's brief rmap information. Some of these pages may be merged, but some may not +be abled to be merged after being checked several times, which are unprofitable +memory consumed. + 6. Hierarchy support ==================== -- 2.15.2