From patchwork Tue Feb 11 12:43:43 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Usama Arif X-Patchwork-Id: 13969549 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 5E3A7C021A5 for ; Tue, 11 Feb 2025 12:44:58 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 5A855280007; Tue, 11 Feb 2025 07:44:54 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 53B45280002; Tue, 11 Feb 2025 07:44:54 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 382FD280007; Tue, 11 Feb 2025 07:44:54 -0500 (EST) 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 18335280002 for ; Tue, 11 Feb 2025 07:44:54 -0500 (EST) Received: from smtpin16.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id BD498140367 for ; Tue, 11 Feb 2025 12:44:53 +0000 (UTC) X-FDA: 83107633266.16.B02D0A9 Received: from mail-qk1-f176.google.com (mail-qk1-f176.google.com [209.85.222.176]) by imf14.hostedemail.com (Postfix) with ESMTP id DDF0E10000A for ; Tue, 11 Feb 2025 12:44:51 +0000 (UTC) Authentication-Results: imf14.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b="UtWO+/3K"; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf14.hostedemail.com: domain of usamaarif642@gmail.com designates 209.85.222.176 as permitted sender) smtp.mailfrom=usamaarif642@gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1739277891; a=rsa-sha256; cv=none; b=GbrSazuzfHtooZ+231kXWcjsDYrzV2/Em5yVfcibpUKrGIkmLrJK10lDOERdU4YQa8KBeR YDHL8w2dBUugVu/ixTKM7DTrUaANppelIz9pB+Ah4Yk3WGbCCzwnwW+50A3stNIk9me5wq QxGEKsVHK2MX0vcYA7Tz3dI8bz2ena4= ARC-Authentication-Results: i=1; imf14.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b="UtWO+/3K"; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf14.hostedemail.com: domain of usamaarif642@gmail.com designates 209.85.222.176 as permitted sender) smtp.mailfrom=usamaarif642@gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1739277891; 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-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=CMpax52mTZ8HpB5qaIoavLxDy1tCpJlcHHk/nmljXSI=; b=47f0B9RRqZ58iBZbFRBmHqUpB+VVyeO7xTh4XMjxRvZdHR/1RtgPMNwmkcMtQqZFZCqAbG 9XQw5Wu3l69xGcWMtf4OEtoJV65Skcgg1tVj0poDuDjPmiMQssr7T3ghLkqrqVag74FQdr 4MoQr5Cpf9mepIn8FEJFec1K0eT6m/c= Received: by mail-qk1-f176.google.com with SMTP id af79cd13be357-7c0566511aaso330799185a.3 for ; Tue, 11 Feb 2025 04:44:51 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1739277891; x=1739882691; 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=CMpax52mTZ8HpB5qaIoavLxDy1tCpJlcHHk/nmljXSI=; b=UtWO+/3KbhGUzXmAuaSgSh2UZDszRNaIz1cNhT2EN+9RtfpBUNPv10NMwzPwH9SQgv +9PU4autw/fwERzMx8gZELJerfWCOcitGn7IWspP+iBsErWUh+QIRQA0DMGNGqO4VL1t GECLGRrYJrZNbWbAQQrP3Rl2Bwsx2yuCuRRcd55+ZXegDHQx6rmsw0h23jJFZGGRjWtF RhRPt+gICi6gMB7dw2ogF8KVX3z9j/gp0qrSYei3P7dwFPeh5r0HEHZTOUAtwwwy7+3i Xjzr89Niemrc+u6gx405uKIAWM6MONm3Vp0IBvj38NI1/6pl0W5Medy9NI5OqTvra9aQ 9ang== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1739277891; x=1739882691; 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=CMpax52mTZ8HpB5qaIoavLxDy1tCpJlcHHk/nmljXSI=; b=RsaqwqqdM+d1C+V9F1GImJrgTHtj9i0lM9MhKYsc9Y876C78ZN9N2jomd7K0DppVBW Eo4LfyFKRg9tFo7Rb1Iem4mgWGD803f/gZmJCNcZ7fAGJKA+oy9mufp1upUd+vtv5RyP 3VjaS7i6SVbcNAwwD0+OxhmQkzLLAb7Z2dKV3QNgcA7k7RVUNFU1gezt8Vf+Jijx03nE vsON8tPo7QpkeetqXIpgonfSoLjBdeHPV0BBrH1NclLwYdl5yX6+wVIgeU+MRF9wAYXd +d7ZsFk03pzuTB/Zg+0ecKGSkAopj0z2R0l32WqBD3deb6dL7S7e49qWfCip4aOEIVOO zX6A== X-Forwarded-Encrypted: i=1; AJvYcCWqIFf7wyVqpF1V08NDI7bjnp7LzqWWy4+cIPSWkkTdLtP95dh5LA9E8+S7SRkt8nhgsYzuaIJerw==@kvack.org X-Gm-Message-State: AOJu0YwkePW2jfQm0OJYsxMlc4NdYyhHGDYPXgYFG1GY2+8/nS4VSRad mpq+HOkLUmL4Bflhzc0eukCnXcNkxErPclgrX5Bc7Bg0y5q5Gs+b X-Gm-Gg: ASbGncu3psiBgq5WNd/mleL0mD6LXhfuS6S3ihE4b9Tk74wuLxRaOeBrIE+MK+LislG UpP3Sg85HKCHznkiM9CRIWixr0703LhT8iCrOSWTnSWX1v76xLb2vyuDm3GTEVtGKHU8M7KptF/ /UXx2Mq83gZOh0WCP5yejmNDCGCLiX0ZT2EgisnmAo4GNO7OqHgy+5iTVGuuZV9MKZZruEMoj0l 9Pm3jijbE0EHGeErdrkGHUIsK3X/1hvuj9CIk3liF88C47sFxxEKRDMc5mGZWzveqIVpqPzpW62 Dm08SGkoiubwnA== X-Google-Smtp-Source: AGHT+IEmiyxZeL3sd7uvIckZHDQoOiXcxTqD2r2xsGU0tH2ecYI3/ky1JVJC5fU0oahk6j9XCQI/fQ== X-Received: by 2002:a05:620a:27cf:b0:7b6:c714:f65c with SMTP id af79cd13be357-7c047c356e1mr2262320585a.28.1739277890995; Tue, 11 Feb 2025 04:44:50 -0800 (PST) Received: from localhost ([2a03:2880:20ff:73::]) by smtp.gmail.com with ESMTPSA id af79cd13be357-7c05a07824esm331948685a.101.2025.02.11.04.44.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 11 Feb 2025 04:44:50 -0800 (PST) From: Usama Arif To: sj@kernel.org, akpm@linux-foundation.org Cc: damon@lists.linux.dev, linux-mm@kvack.org, hannes@cmpxchg.org, david@redhat.com, kernel-team@meta.com, Usama Arif Subject: [PATCH v5 4/4] Docs/admin-guide/mm/damon/usage: Document hugepage_size filter type Date: Tue, 11 Feb 2025 12:43:43 +0000 Message-ID: <20250211124437.278873-5-usamaarif642@gmail.com> X-Mailer: git-send-email 2.43.5 In-Reply-To: <20250211124437.278873-1-usamaarif642@gmail.com> References: <20250211124437.278873-1-usamaarif642@gmail.com> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Queue-Id: DDF0E10000A X-Rspamd-Server: rspam12 X-Stat-Signature: 9dskz8qg3hwm5uwdegradufbeswx9typ X-HE-Tag: 1739277891-134351 X-HE-Meta: U2FsdGVkX1/K2BReo7MdYIxszvCAdGLOk/oyeA0pWvI56cIoEmH2DmtLbecwyY7KW/MW4j0aZuEIgO//i8WG2OTEow5IDi2nT4VT1Dv9TL3io2G0NBgP3L5OBdaqRxtmDcCjzxsbNd7zZg49w4Cz2eWxT+GkmD5Y7C7chJZ5zF/0s1LXW5gtX21QgXXzUoeKvfRMEbs38eQPJTFeta9POgeD8J1VbAj9qHyYKmMj/gPgAa//lwtJHHwnGlgXu/yy+8ESGRXOLk0/G6KC6x6HZFwAl92D39sx0X8+chfxxLs2qxrrwT/EcMs5yliNjlz55e0rHJgC9Upidk5ttha0I5B/k3PqO9fLio7xZScc2PEd0twpZdCQLBoA1si8EarBDFkGSktwEj52ff7ZAL9M8lHAPmU6BXSzMR0D7xtbho764diXQHUhZosQWPEHT0lviN6h1HwC4mAJbCmpNByNFzIrJ9wBEQ7gH86YwIP+JhyBbhkz690Do1CFVZd2craaDb7YtTCnzE/V+LnIhUPUm6XIRY1Afw10ZQd1TW1CbG9zhGlnQJaWE2JemdXwvjMRuCb3MUHUGrBBFz7MSrleNkf1/qIzk31aqCoUVHmJaTGwut8O5pdxx+cz2QYcknZ1C3T2uptQMGoFvEJdxVVWOtURL/YKWCxLUNBK3TVaP3JPS95rf8Wwu1xqH9DwU5XdEP7yKQfI3mv6D7ynriakrGo0t+mlCS8TB7r88EC7BH/ER3vY0GNBhDbCLBpal+SBgiWZDZh6DRZudA9re/8bijMrjfDVxY1RWeMiqNf1Z+ShnJ+RHYgt7qBQabn6HR6BUH1mvHrHN4UKleiPZPboFwHwMoCrtsdIRZnqaurWLyGjCKVcZTE+pnKjvbzk0M8kzGJ3qyPhTBDt+odMP0tmP/2lGAJeF7ZgH5cUSXGX4WFlRUmd8sXj1HNFeXHZJXhcK8Q6jkR4Ywv3sTHx9V7 XtesYdAM xL7GuplEKxrM2U3H6VDUIie9kwnAAW+3n+4BHTX/mcHRUfRmrjF21pIFznUHBKbZWL0iUdVLMFeKYafGi7Pg7MQz4zCLkyt9bwL2p9lf5jmvClNCkNCYABNw66fV3qz0EpLKmf48cNwMOQqJinYo3cps9fohzrDBizzBQLXHGUAiyjfWSYtmcDlmQO7qDzEgFOoy5Z2K9YlWwCbJXrLKHxO7PljFkttZh38fidj06D/Yp+LQT5OFgpL5Cr3Rj2FWabY4zd9yp/qioz4Upz61EEdZiSY0qebRTh416WhdA/16WG4+snm4la92PwUGT+PE3BEMJHF98tp5eS+RWNAWo3t8DtfvLX4xzwE0yYe/msKoI6T6r7OuGfzV0CK8hiNlzBRKOhbi3Zr/GYQEOq0LWXMCryfpqiEcuN22z8OgYE3N8uGlZGCBr21/lTA2FI0yG2syhP+TX5ofPCoBh4nn4cpxyPBsLcjpRHXdCDXVRYJKsG6z3ixyLrc5oATYXiZ1HRpqYHD5QrGfVBPdrJaVu7sE1vB7ruCVC3eKHPKkIWnbbVGfzDNAHc4VtnMqg1RbVZ3br X-Bogosity: Ham, tests=bogofilter, spamicity=0.104232, 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 includes both the 'hugepage_size' filter type and the min/max files used to decide range of sizes to filter on. Signed-off-by: Usama Arif Reviewed-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index 47a44bd348ab..51af66c208c5 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -83,7 +83,7 @@ comma (","). │ │ │ │ │ │ │ │ │ 0/target_metric,target_value,current_value │ │ │ │ │ │ │ :ref:`watermarks `/metric,interval_us,high,mid,low │ │ │ │ │ │ │ :ref:`filters `/nr_filters - │ │ │ │ │ │ │ │ 0/type,matching,allow,memcg_path,addr_start,addr_end,target_idx + │ │ │ │ │ │ │ │ 0/type,matching,allow,memcg_path,addr_start,addr_end,target_idx,min,max │ │ │ │ │ │ │ :ref:`stats `/nr_tried,sz_tried,nr_applied,sz_applied,sz_ops_filter_passed,qt_exceeds │ │ │ │ │ │ │ :ref:`tried_regions `/total_bytes │ │ │ │ │ │ │ │ 0/start,end,nr_accesses,age,sz_filter_passed @@ -406,13 +406,14 @@ number (``N``) to the file creates the number of child directories named ``0`` to ``N-1``. Each directory represents each filter. The filters are evaluated in the numeric order. -Each filter directory contains seven files, namely ``type``, ``matching``, -``allow``, ``memcg_path``, ``addr_start``, ``addr_end``, and ``target_idx``. -To ``type`` file, you can write one of five special keywords: ``anon`` for -anonymous pages, ``memcg`` for specific memory cgroup, ``young`` for young -pages, ``addr`` for specific address range (an open-ended interval), or -``target`` for specific DAMON monitoring target filtering. Meaning of the -types are same to the description on the :ref:`design doc +Each filter directory contains nine files, namely ``type``, ``matching``, +``allow``, ``memcg_path``, ``addr_start``, ``addr_end``, ``min``, ``max`` +and ``target_idx``. To ``type`` file, you can write one of six special +keywords: ``anon`` for anonymous pages, ``memcg`` for specific memory cgroup, +``young`` for young pages, ``addr`` for specific address range (an open-ended +interval), ``hugepage_size`` for large folios of a specific size range [``min``, +``max``] or ``target`` for specific DAMON monitoring target filtering. Meaning +of the types are same to the description on the :ref:`design doc `. In case of the memory cgroup filtering, you can specify the memory cgroup of