From patchwork Mon Feb 3 22:55:33 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Usama Arif X-Patchwork-Id: 13958388 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 1AA47C02193 for ; Mon, 3 Feb 2025 22:56:31 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 396C76B0096; Mon, 3 Feb 2025 17:56:28 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 31BF96B0098; Mon, 3 Feb 2025 17:56:28 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 148B66B0099; Mon, 3 Feb 2025 17:56:28 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id DE6626B0096 for ; Mon, 3 Feb 2025 17:56:27 -0500 (EST) Received: from smtpin22.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id 8A784160584 for ; Mon, 3 Feb 2025 22:56:27 +0000 (UTC) X-FDA: 83080144014.22.7A8826B Received: from mail-qv1-f41.google.com (mail-qv1-f41.google.com [209.85.219.41]) by imf23.hostedemail.com (Postfix) with ESMTP id A888614000A for ; Mon, 3 Feb 2025 22:56:25 +0000 (UTC) Authentication-Results: imf23.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=jnp3PKuI; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf23.hostedemail.com: domain of usamaarif642@gmail.com designates 209.85.219.41 as permitted sender) smtp.mailfrom=usamaarif642@gmail.com ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1738623385; a=rsa-sha256; cv=none; b=C5dYVEenswe9sFtgtMq+od0W3u8Bi6pRAzQzdCY7mE0JrCCvFzjfduh/+64RUa0WmxDMi1 ktSaCggPvDuHLd8TY1sVussln0hqpJs/DAYOALuyNj0qsbolalaHMlddA1CHgYO0Mi3YYD tjHfsOe/kkn71pOyJz1wzd3ut4afoJI= ARC-Authentication-Results: i=1; imf23.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=jnp3PKuI; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf23.hostedemail.com: domain of usamaarif642@gmail.com designates 209.85.219.41 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=1738623385; 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=42HHIMqh2iJaWiyZ3I2a3Q2yrqc7Y9pAkTTacWWAGL8=; b=gqnnchLJibZLfdIOFh3E6wDrvuKspfu4Nzf3RThYXpIiTyunWmkVKlTEUPA4yowAloMfGB N/TTdQoMuGWdGoCRTEDy1Ho8M8ut59HisjtAhQMyWt4aXrj3YW61vxWljW5VEjqeto5Pep wOJBZeYqQ0cD0z9J2+cDFhN2QPi7JDQ= Received: by mail-qv1-f41.google.com with SMTP id 6a1803df08f44-6dd01781b56so52760236d6.0 for ; Mon, 03 Feb 2025 14:56:25 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1738623385; x=1739228185; 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=42HHIMqh2iJaWiyZ3I2a3Q2yrqc7Y9pAkTTacWWAGL8=; b=jnp3PKuIS8vlmH7H13Ui5xWabygjXeBU9G6089ywyZjSK4T6me0Rlhl6Najhwi1jFA GjhkffSZnzIJrZZZg+f/olRBLZJKl7R6VgUhx2mIdjIx8ZjjX61h8X2h6QI7J4oQaUzp GEXXSlHm54iEf2oysTJn9unbXHmLWxUR8kB3HU3nqtKrM46QDj7zl5oNEsRhp19aM2lG JYZn0RQvH0gIbsS42D64QMKjLEG6oyUYkXltbwG4V85Z3GusxLfnjesb3AE/Pp98phvk YT75W8HWoqoWvhv3tDeaXWe2bJ9FRgrOyvepmav1yDEOLdnykxuaISCWVK9tB4hXDfYS kmFw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1738623385; x=1739228185; 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=42HHIMqh2iJaWiyZ3I2a3Q2yrqc7Y9pAkTTacWWAGL8=; b=gjPstdU8BhktFHFwP+6eOkGGuNYRQdCmYs8AD+B6S3g0kxv0e6D2l3gHSPQFd++1b0 EgvMXa3Dfq34yP/Fyq2UV5X4HzJZ+4GWOXoIsTlRNLabvvaUKj7/hk7fojUyOjUjkZz+ i9pkJl5D1dUxYLmjH/l3bMD9SCU4TRpLcjFhyeMubLlq8MChD+e+dtHirb7lLIqd2lxr wyH4Ibfs1Zd7O+sVdmUOBTavJHtrjpENRfX/NQOPGrmJYZZDJ1lr7vD6ceIyc/PRiZ7s gJ/ZfzuedwNNmLekp1yRMyZi/Ux/c9z6jcW3LqGEJWBFCo1LNAS67tuPewMUg34pK38R rGgQ== X-Forwarded-Encrypted: i=1; AJvYcCVlPB1GM98DiUkSns/GG3Ku/0bVN0dI9vQnUxP8XY0/vENZDl8HB10YE/JhVI91zFsN6jvBPOfezw==@kvack.org X-Gm-Message-State: AOJu0Yy8YL3jCd66kiG/wTLFCdKjH9Z6Qg9SnnV9XvH8FMGaUNyOifUO FEHAwddYpiQOj8wy9TxnpPo9dySHz4M9KnWDuOgErULMJx0/D0cb X-Gm-Gg: ASbGnctVepXwMmclr8RpipFdeXYwLpgeoa/y89Y+fRh2gGB3zTK3Y5NGH0LHJsH/fb0 70ivPGQAYbzkMiwfjUU/4i/8uZeFOE6dsQzJWr0L4N9nln2X2STYhAViU8uM9jrxaABw28f/WnN RZAOG1KWPbUwwsFsf260mHR/AQZUMqSHO7g5tJIJ8jXKASaMo0Gb0xB1V/zgCnSbCZfyl4/3q4Q z8vS5iDpnw2RzMdLCfVXttAnGhdBYILTGhcWiSkD4eWx1AjCagjpi6Zh0uJz4rh3VLEEMGOgkOD Suh7TGbJkggq1A== X-Google-Smtp-Source: AGHT+IFhlyc186tNNuJZi79PI3qlJsGmHC4/KUNG9CBtZP6SR5/AFRLR5sFR2OFiW12cBhbVQ+j77Q== X-Received: by 2002:a05:6214:2582:b0:6df:97ba:4f7a with SMTP id 6a1803df08f44-6e243c5eb6fmr359442226d6.33.1738623384681; Mon, 03 Feb 2025 14:56:24 -0800 (PST) Received: from localhost ([2a03:2880:20ff:70::]) by smtp.gmail.com with ESMTPSA id 6a1803df08f44-6e254814d01sm54971636d6.41.2025.02.03.14.56.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 03 Feb 2025 14:56:24 -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 v4 6/6] Docs/admin-guide/mm/damon/usage: Document hugepage filter type Date: Mon, 3 Feb 2025 22:55:33 +0000 Message-ID: <20250203225604.44742-7-usamaarif642@gmail.com> X-Mailer: git-send-email 2.43.5 In-Reply-To: <20250203225604.44742-1-usamaarif642@gmail.com> References: <20250203225604.44742-1-usamaarif642@gmail.com> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam01 X-Rspamd-Queue-Id: A888614000A X-Stat-Signature: fz8e655tc3tdpszebfurc86zg1sp7pbr X-HE-Tag: 1738623385-982728 X-HE-Meta: U2FsdGVkX1/XT2B3sIhD0vOUFqQNdhRQLSumxjCQvsqlM/Fw6iLCp4OCLb+6ZTQ/BYqbKqDdKawVB5N1RP8iNb89jdnt6SeILas5UplP7YvqDrm2NR27YOzcKUk0iPk31hNXd31aNhP/zYjrqReO7j56ujCAKjPNy40wbg6YJydkpX5tOl1Fn9fKWIzZz8qJnUrDe6IN6IY3BiSIxB0N5a2Us5xd9Tys4jCZHic5Vq7F6grbHf20tRdvv7pjmuFxdfv3igk8rU7XsoP7POYhi/DQR+Xp5PyGIhY7f+ERS8G+hhQ44aloYQJxSFOaJeCJDTnTLQGSPeNIXXseUrV9gxdXyheUoa30tVW1k0lk2pJJYvSqFPeWhAM0zoNoiRfAdWk3Zbt82Uf6ixznXdI7ufAH3vg6pKvz7ecZGHQ+lB+fDdbmWSfQZh06q99ZfeiZSNry0HH23smSzzqBgaV26pqNn51ddyYrIj4K7jJfhk3j+ipslXyfhdxuLhAnJ9tOyUGdh3HopFAloGXQsNuORZ4GTz/XjeRe+j6WDRnCLkEtExoBkchQcJ6YknHELa0U0EFc+ZLmz6Z0N6DSrtIDct5fnz+PV9xjFSE4hDdN4AogEoW+grN1TfzKC/YGkuCsy9+sKRNVSCumOGT7ur+NoCGE2/7UeaTxdxihllZXMv7jhThEPM74nWdI/kCGTKcDu/+VcgGUwA6Td5ojnrZWKnehmERzgnqmX2GDtB/g1fXwOXRDGfEMa+/aqZFxF+z2/xc42YGwKKy3a7aFHCgD6kieRtX7mE7ljqOgDQroXxBKAWN1nVq7R+qpodY8PPiVkXXVFnK28IE0C9A7L3vr8d+gDa6mMBK6JkJGFl7HIf9+v2wJHgrFgO40En7qCIqzP15kAIqqYHju5j9K01OQ/YSpACL8h8X+UVE0DJgI60jr4Q1koMPi2wiI0elbR+C/0Gf+kZn6QgCHG5kwDqm bVFxbbLC tqrY5TdsXXjTMCovAg6ApdbEFjVI/BjpFQ2zkEgu0X+0LmBF3vFv36LfPu828FYcndPG4QqgA6MKNczoboLCVANEz5iu9RKdOKD6RO4GFtl7xO7s28Ba6r06swOVXBieH8vbJIa/rN7az98ixQbt6bNQaWMepU+9zqAzK+cXQZnn66nXnjeKcc/mehNsPB6ePoYTBftQ+4DAEj+0FENpanc4yAo/Rl/lcxbc9U7UjdIoGy0QxQl+ypIqQ+XbkrsWmKuTH07tjWGvbl0X1y+nsbOndWNWL9/J4HwkuvG13AlizK1g2wt1wqWhbnqX58AoESHFV3YEzohrgYCoS9ZehuCDPqh/9M9CYx8BRAZlSjZj5lkBe6DFjTWXreg/Jlfq6fq/TduzdLMs19hlUMcdODpbSA8X0HViXvwrBNW8XdnpApnTlWvcsjlG0cPnXgyW8EGJfBEpT6RhKOpe1kmsEeLH7FxgcHeCrFD8wpyiT8x8XVQkv01BQQBS/s96kT/SLBeKs0QqxIJoKoLvwl3qeuZaoBUEYKRlXtx/As4Gw56CvYNttPvGfEDazwXpHiIF4oWuFUzzmWHwPUIJB2gUDf8tUq8KxMRL3LQaj3+MNnM6FpIc9Lh5KDdoKOuO+dvvhudDoba5peP3uhBvUHj8rqg98Fe0IvgQbpLBKHfdHBd5J3SusDErre0wQThMQjiA+ucRZXId5d0xgRkd3ZxSIRb30g5BtNHYAjtyfCVvZY2CxgGBfB74rYc0rq5Pvara9bMA7DRM/81Fbfoest5mZY3FH0h/DIqihEG8vKjZkqGMUCeF56tP74dGeQYHeheTLN/5UGfcayiYENkMC9TE5rovykktgEt0kv50HrnJgh6A6A5vAkImCnb9gw2b6o1A2GAEW4XYvo4cfXFwoiV030s+P6iBJLXMSiNFXhqFi114Mex2cLd2Xl4CRYc8nOKluaL8ooM6j2+96mM6HOG9YaGOm/R8B 6LSCdcWM 9Mgbt6470VabFcDjsLwQ+nTmMP0hEJdi67IjwNPQ+IRmrZu/RIL7mzKasuxlBLvl5YZdkJpdaoZ+hviGtnMQPQw+bgmyaFtcnVCey6GYHmd4OxWkswP2fy3NdL47stZTmeM9KZyl3R56MPgsNpG//aUzf87lwBcXjLTjPseB6A7GmzR1TEmqr2JyRTXv7/4tf7tBvWyc2ZR0sCAC25AcS4lqei0UHXef2ufU4vZwlxJVz3kBXW9PoMHpC+kiDMgBAnV0n+EZlyBfo3C6F+CMSpXQwV9D+EtvcmiziQwGK0cCsCp7U+fE0u9qAemIYsRDK1v51yYht4h3/gjikCwHJkRBToaoeVJ8b285NsEaF4dyo5t3N1UzJhHW9ATSRtKzYCzo/2uLspbF/20DYwzfUNYNKrIdl9+feo/t3WUwUZpWmD8Wf2vafk/yFw1B9YzKmFTfQyw61VOfE1ivo52Z6I04WaumtI9HEtEcVHrN72RQvxjimJ/UfRw1BgLKH6ZNZSqydorbAk5N45CsUIHQCl0kFmnNdQYavqyQjsSh/Cuv3yp4LM761s6yWjSByJIASSrWD5F6O2crZFp4ejEn8e40/6/Sn4b8bE/7mLYGcNow7au2sorXigZD14FXlR9zRLZqN1jltHxoBTJNxJNdB6r2pwWb4SmNQidAqKfOhplVvXr/r+MSlXK8qjU41tVFWvF05QrxemODZBz+EdTsx34nIIJCp4ClcyL5zY+gaIR5nx1DDUu0GYrFLeigMCPqdwpt5SoWQP0uoi59VxlKbU7DoGek8gM7mfxryoQjsM86iw0js+BrdwZz/z7mMKTobhhQ7JGLy8XZvSFIMD6EXFbwzYKRWhxusee6KjKI6ol5wBPrfWINb7lylVSn1t+ZrZdFEVyPnW2gOYH1cvFDYny8cna4zHnTDMf8iPsn6Nl0OPjClL1eeBiyIz1azvrqxBazXJq6RquBdHtXU9bNdT6HBe+38 eqtuff3d oRSVFNnIUAiens8QFDKUgRdO+3DvHaog4Hw1xnbHFDdCDtiOCejxpBbpg7GmoORzGDT9qiaESd0c4RCUxejBqdS5LZoOM2djpPevSvT+zAi0DDDouk1dakFUzru4Clx7kVk6/TTW4beV1ioZf6risEOUNh/H5vc+M5BYPtZt/O7ZNtX31k/nrHteqmCM9EdmNyPrV3UtraHViQXmZHEGXwEMBQ7WHZzi+50L643rwuslnZDPEItnPhvfgCghsFZVnAtsEB17FeqsjDzlFKgP9GCmPvzDUWiaMb3+/MmWtSudBAFfmGbLaxRsnvyLN8Os5pwyS30x4KXwrYwJ1XlpA0nR02QZOuJPvsfcNEaJtFYdDQY1Ne67wtWt8pFUVieLTVecmZhoruvzzu/xcUU+Z3EN7vLSEHTGQbs8QCckGcd+oa+LgiypwAz26MdEBYHViQRUFPFptBm3HrCzsoy5/nD7yAznzXRYGjz2jwKTYcHdOvdeVDBf61g5WSa43iUMrzWAbmTkpUUdOKmUfkoB9SxuyBXgcIA09me1Q/ju0qNplBZuLlx0Lz21Nby8CqoNbaIm/mML+8/8Ah8qRYCGM/BfdUZ2/xZS3yxigYPgJcd0Z4elp4oml62VeQpoh/1EPOeVtH+0Cad8nXyUWPxt19u7Z9RCVd7hbcaenWavFjaGhq2o86W4+rPClqz1tyNw0KTSLBKYtaKL84Kl3gPVvB75GLuQ0IEQ46Ho38jmRm6dgKIAMtWjezVqQ4a9R7LymD8pMShYPfWIQRhvDWWreVB4q1zSOI/zX3fjXiIKdBHTQMNCyJUYPSOPLm9wwd/oyjUHzZ+XDr/Az1iuVydhz5/xQCzTftayWOsIUuqC/qxoZeg1HzfrYgOqMsjXnr4Gcto8KLk2WtBrgUNjEY2eW+HB4ZP X-Bogosity: Ham, tests=bogofilter, spamicity=0.020664, 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' filter type and the min/max files used to decide range of sizes to filter on. Signed-off-by: Usama Arif --- 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..5765896aaa7e 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`` 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