From patchwork Mon Jan 23 17:37:43 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefan Roesch X-Patchwork-Id: 47287 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp1742861wrn; Mon, 23 Jan 2023 10:04:48 -0800 (PST) X-Google-Smtp-Source: AMrXdXsENRYI47LQme3w9580UpcD5CcMl30RH0kjajQtcczVCpC67FRB8xIhzbtpfxi3DiEGJfB3 X-Received: by 2002:a05:6402:3883:b0:49e:a121:e560 with SMTP id fd3-20020a056402388300b0049ea121e560mr14945585edb.27.1674497088326; Mon, 23 Jan 2023 10:04:48 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1674497088; cv=none; d=google.com; s=arc-20160816; b=AWRF4iowT5HQzqFzXgxowcvBT4P5hrHc9MysZsfae+BiN5Btbn96gsh5kmk4A0uGeM 0icPOGjuKhgoArPIOC4mS8ECMrRA5pN7xsymCUK2JWar++WDEJnOs9Ybvp41kW+1R1jS OSlN4pfflXuaqm7TQDUObU9I6PLTE7bmlJJSnsR7dfhtD0OOziHUni2z4kKFT+QhCLk4 M1qQKm68RkN9WT8NbYeeJ1X31dQz9lAo7KC0Hye+r4s73CpV3VCVxnuIxe0PcvlImrYE ZaPYCHVbBNTHpIWqjQLDDQ9P8Dot05xlA0fugzLP2dfOXsIJ17s5HVrZw1HsYb0ApfkV RqCg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=48BaoTp/2HJ6bS79iL9g9GlQiiTNNuHFinc8DbFXwQM=; b=wJmRFVdKU667jZl1+BNqW9Gr4x+NgoWCDm9U4AqyTzfAar4rrb+HFOVnYKLYcyTYSj C64mdY3Nc/kLjJrMr7xRw9d1bHm9VWGz2/GGeHLDVci12ISErMGzh9LF8n+JkPzv82/r n1VFPuvzGTmVL3ZUMr9oNWdy9iIBIxdaLyMPUrRQ3RFRBj2Er+TA9ztNKXIfLyz7Ut8c 4NQbTEnB51UsvCALgJUGc/ijZGIcIzgfZGeDfcHjb1kZUoUPmKnhkTBe68er5nzuhncH 8vOQXJULNMFAzMBVUfJ3yS2XHjEITyeizF32ej5x4m017HOutnFGNlmxdgG0Pz79z2lr Tfgw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id i19-20020a1709064fd300b0086e1572ccfdsi33817226ejw.709.2023.01.23.10.04.24; Mon, 23 Jan 2023 10:04:48 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233109AbjAWR7v (ORCPT + 99 others); Mon, 23 Jan 2023 12:59:51 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:37984 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233171AbjAWR7s (ORCPT ); Mon, 23 Jan 2023 12:59:48 -0500 Received: from 66-220-144-178.mail-mxout.facebook.com (66-220-144-178.mail-mxout.facebook.com [66.220.144.178]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 29E19233FC for ; Mon, 23 Jan 2023 09:59:48 -0800 (PST) Received: by dev0134.prn3.facebook.com (Postfix, from userid 425415) id 7BBE85616BF1; Mon, 23 Jan 2023 09:37:56 -0800 (PST) From: Stefan Roesch To: linux-mm@kvack.org Cc: shr@devkernel.io, linux-doc@vger.kernel.org, linux-fsdevel@vger.kernel.org, linux-kernel@vger.kernel.org, linux-kselftest@vger.kernel.org, linux-trace-kernel@vger.kernel.org Subject: [RESEND RFC PATCH v1 15/20] docs: document new procfs ksm knobs Date: Mon, 23 Jan 2023 09:37:43 -0800 Message-Id: <20230123173748.1734238-16-shr@devkernel.io> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20230123173748.1734238-1-shr@devkernel.io> References: <20230123173748.1734238-1-shr@devkernel.io> MIME-Version: 1.0 X-Spam-Status: No, score=2.4 required=5.0 tests=BAYES_00,RDNS_DYNAMIC, SPF_HELO_PASS,SPF_NEUTRAL,SUSPICIOUS_RECIPS,TVD_RCVD_IP autolearn=no autolearn_force=no version=3.4.6 X-Spam-Level: ** X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1755837458917809705?= X-GMAIL-MSGID: =?utf-8?q?1755837458917809705?= This documents the ksm_process_profit and ksm_merge_type settings in ksm_stat. Signed-off-by: Stefan Roesch --- Documentation/admin-guide/mm/ksm.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/Documentation/admin-guide/mm/ksm.rst b/Documentation/admin-guide/mm/ksm.rst index 72189bf1283e..70896f01d641 100644 --- a/Documentation/admin-guide/mm/ksm.rst +++ b/Documentation/admin-guide/mm/ksm.rst @@ -211,7 +211,8 @@ several times, which are unprofitable memory consumed. ksm_rmap_items * sizeof(rmap_item). where ksm_merging_pages is shown under the directory ``/proc//``, - and ksm_rmap_items is shown in ``/proc//ksm_stat``. + and ksm_rmap_items is shown in ``/proc//ksm_stat``. The process profit + is also shown in ``/proc//ksm_stat`` as ksm_process_profit. From the perspective of application, a high ratio of ``ksm_rmap_items`` to ``ksm_merging_pages`` means a bad madvise-applied policy, so developers or @@ -222,6 +223,9 @@ so if the ``ksm_rmap_items/ksm_merging_pages`` ratio exceeds 64 on 64-bit CPU or exceeds 128 on 32-bit CPU, then the app's madvise policy should be dropped, because the ksm profit is approximately zero or negative. +The ksm_merge_type in ``/proc//ksm_stat`` shows the merge type of the +process. Valid values are ``none``, ``madvise`` and ``process``. + Monitoring KSM events =====================