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 9F8F6C83F09 for ; Wed, 9 Jul 2025 01:00:39 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 3F4118D0002; Tue, 8 Jul 2025 21:00:39 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 3562D8D0001; Tue, 8 Jul 2025 21:00:39 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 244D58D0002; Tue, 8 Jul 2025 21:00:39 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id 105898D0001 for ; Tue, 8 Jul 2025 21:00:39 -0400 (EDT) Received: from smtpin15.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay04.hostedemail.com (Postfix) with ESMTP id 8D7F91A0290 for ; Wed, 9 Jul 2025 01:00:38 +0000 (UTC) X-FDA: 83642920956.15.7C17C71 Received: from mail-yb1-f171.google.com (mail-yb1-f171.google.com [209.85.219.171]) by imf20.hostedemail.com (Postfix) with ESMTP id A6B1B1C0019 for ; Wed, 9 Jul 2025 01:00:36 +0000 (UTC) Authentication-Results: imf20.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=dgKfTrHw; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf20.hostedemail.com: domain of bijan311@gmail.com designates 209.85.219.171 as permitted sender) smtp.mailfrom=bijan311@gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1752022836; 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=T0AEBACIj7iufFFEjwK+DXtNtO5oq6pBK1Svk06pLxI=; b=mVsMOZ3SLuqrhTtjcG3vEWsUvkbFMJjZRyKIoA0raBL6KgiVVQrOjjaR/MqCrzABS+o9lU M4x4HxNZUaaLMBvWyt7KZBzrjEBYE29hp9e87E+c+nIDUHYgac0xmZAq/s61Atl1DS0kg4 soOQaySgYj+BoTJKtHD7x4rwYbQeQV0= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1752022836; a=rsa-sha256; cv=none; b=ktZi1x+Z1GPnf/iyumAy0j1FmNaii0Gdy3Ylcccrp3tq85bwwnGu4gzuRfp2TuEHavWXlZ cBkALyGFZw5fZq3GlKXDmIFmhp6HNO+SYxCwkd9HxMBHb+nVc1toEkSd+Tcbkkjuhe1jQZ T7yMklqgcbYbj0L5Ueg7R68mOY08IGw= ARC-Authentication-Results: i=1; imf20.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=dgKfTrHw; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (imf20.hostedemail.com: domain of bijan311@gmail.com designates 209.85.219.171 as permitted sender) smtp.mailfrom=bijan311@gmail.com Received: by mail-yb1-f171.google.com with SMTP id 3f1490d57ef6-e812c817de0so3927168276.0 for ; Tue, 08 Jul 2025 18:00:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1752022836; x=1752627636; 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=T0AEBACIj7iufFFEjwK+DXtNtO5oq6pBK1Svk06pLxI=; b=dgKfTrHwnCqDYoSwrqtdOA1zv5viOJa7j6b/AdRV0SbRE+PH5Y+vjBJ7FG0ojOfwvn f64MZja8WmfrN8zKjDeGrvbSwtc6VcjmYfmFVPmNyLxk8VHpvfyInbVntPZqC8/VR85B 3Kdiutq1AaHxu46xrbAdUr2k16aK1DYIyo0mAJqfTpcYoXRBoW6/jcVWw0uzocy8nsxk 8LqdKeLEsVQ846RaJzRgc0klqc0PorMV/wldLjiKD8cdK0P80P75MBh2pUvPfL8PeoW9 mrYAATx2s/eqlhd87GOhwgeBZf6cu8c+yMenYQFCnqQ3+LpJBm9ZuR4MgXJDRdSEBjAM vGLA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1752022836; x=1752627636; 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=T0AEBACIj7iufFFEjwK+DXtNtO5oq6pBK1Svk06pLxI=; b=V2MclAx8P21of3zKrIAXHRWKVoayxPpR1c0qc7UayPyTfGIaqd5LuC7cV8ddYykGf1 kXdBbx9SuVN3OVvEH/mYQqkzWvBwt3PU0DUA50v74joHJ+g3RqnF/Nt2s2LFdkaCUO26 EcOIl5DND0RdH9YFzhpWrzbQLgHKwtR5Z6anRa3VytgrnV5Cu82TQSFpuq0EWppLU/6g h0zl06fZdJ0Pp3BBevQT4jUR8UJYaIVJI0j6rldVeluUhwWZRIuJiCJ1927LczzzBLFO MxYeEgZj/E/vJbhrMpAqOKXrwaCzdGilfHYeJiiUjvwJ14kCTQ8xKHqAe0yySW77q2tU OAWg== X-Forwarded-Encrypted: i=1; AJvYcCXTRlOhTpCj2ODuBDJRjS6hKVrRCObfuEVNOpDtLcL9KExUxuzE2o1QR7k2z+As0XZDeb2h+nTg/w==@kvack.org X-Gm-Message-State: AOJu0YxinS9pbyyv5oCtqkvUZVuNslvquEyrSntIEwdRZScqBYBUfumU +LWdDLshD82dLSnzDfExZz5sUaboJ16iSC+PqJ2hWNZco0QuldhwhWFF X-Gm-Gg: ASbGnctvzVDN2/SaiJgAnvZibSP3aY+UhAhHLdmG16BPtLaPAMeH9l1myxBkkV1zcyZ Nrsyjkb47jH8LU35cuwZrhwjVel1p9YMiqdW4mKmOEEBvDG1DWUIW+L5ia1I7BLXv/RI+Dj8OhH 1F5o6rg+TqJ29xH1EJ0AtR7yNkCuXe19K346QvnhdGX1gxwi51Nwrf4zHd1I/dy4RUHcrI+JGAB T71Rd8ydG8Xz4iyxiaM0nftMCHMkQRnCqeOGp3UhwGTDpiRgLsZUtxwmT3vGaEtn+mJceLgQfhT 95KEi+4x6P6hCijvSsj3rK+f1JN3YXEjMa+L57xWFEotPSzJgLGa+6wkiZlNPpy8kfzfKDGXSPK PpCvL5Sk= X-Google-Smtp-Source: AGHT+IGDozJUCJpVBxPfjv9ILiQSL1R6miXqzbkK4caVqVpgbl+9ZhuvLHM+DyHUEdodqwUQX37wGw== X-Received: by 2002:a05:6902:986:b0:e81:9b39:e46 with SMTP id 3f1490d57ef6-e8b6e102b32mr1051961276.18.1752022835632; Tue, 08 Jul 2025 18:00:35 -0700 (PDT) Received: from bijan-laptop.attlocal.net ([2600:1700:680e:c000:235f:99bb:f36e:a060]) by smtp.gmail.com with ESMTPSA id 3f1490d57ef6-e899c43ed8asm3656043276.26.2025.07.08.18.00.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 08 Jul 2025 18:00:35 -0700 (PDT) From: Bijan Tabatabai To: damon@lists.linux.dev, linux-mm@kvack.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org Cc: sj@kernel.org, akpm@linux-foundation.org, corbet@lwn.net, bijantabatab@micron.com, venkataravis@micron.com, emirakhur@micron.com, vtavarespetr@micron.com, ajayjoshi@micron.com Subject: [PATCH v4 05/13] Docs/ABI/damon: document schemes dests directory Date: Tue, 8 Jul 2025 19:59:35 -0500 Message-ID: <20250709005952.17776-6-bijan311@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250709005952.17776-1-bijan311@gmail.com> References: <20250709005952.17776-1-bijan311@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspam-User: X-Rspamd-Queue-Id: A6B1B1C0019 X-Rspamd-Server: rspam03 X-Stat-Signature: pi83omhtfu7ccezsf6x8qmwi8b3r1ozd X-HE-Tag: 1752022836-280057 X-HE-Meta: U2FsdGVkX18WUngRP14zxtH97jx7Buv8awzaIOvLIrMBV1E2AROmi+nzKolJPggc6ItD4NYJXH/l0xsEhCrqd6QBg/nB8qAZ00AvcbwlOrldNXKjWMIjjkTwNShUVxBFxGgiq00BliL7DtpGl4LdNylD89MC7S5iXoYgduhdoZ8vUeKDLxADpQVt0vmEkjGyvAGcz0fTE/TUHlR5rdjY2dIo8VVQ4uE/73/oxIhu5APGLrJ3tZiQNRllXhGiL3IMhW98YyB9Vw5TOgM738Ai/h5/8CoNgNv92hBk1aYborGd02NGRp32lr0etZUxBvU/5Y7hBa/miZaOaOmNrL0/nflKXZhilfY3ttMhmyFD4ZcAwYkMPx0j+Utnh5SLBgUu3cL/HntBYmbUpsnFsEYzrW3zUJnsu1IWx1LeM7+trtpqllr+SATCTKseefaqtIc/Ayz5gjw7oo54NwCuXSKDqt8MfrLDUgq6OLRNb7p7dM5s1Xrmqz4SpsMNky45UUHCyvkTZq4i5bnZy/I0uxt2NzUC95KkvuJZlYotg5q3dnmiAiWYP/2hLv+w8ok5Z01wLAspm93fgAAzQYGiL7GDfLQy9Ay3eXVux3To9QxDopnZ+VD/xK5hjLrsMVkHi/GCZI7W1SL0Pfga/riU3w3SpfiW9xAjFqB81AiqrB2ND8sQG7ryqQwcdw7HI0KIBYDWmTCrU4XQD6kH0XwmU6mqQV5J8lA2uXgxDHSMYGWJr/lPqVcmr7QUHlkvAaf31l+/tZFWGEKDuOdBzsgcW6TICTKy3KC/F7/yzXjY3SF4GZwaUxUBqZr5+81wMgJSt6wXcupLFRYBsoPOErPY4BCwcf1EvWKs72zI1vqQY4Zxhsnm63/QJmr9Ntdd6bvW1BqnZPDUK63ZGomeD88Boc4RVtwWq21ua4RLcvLFaNp35hOpqF+N8KbElYeuqG4zzvxCZmj4dposzVB/VFhml6i khS8td2k R0YZznoNEIE7i2yELzuha4XWHtk6W6j5pJlBFckTWfNVyWiB27JCZ6m+R2MUcxffM0Hz51ToYKPOnG9m+CJ0C3GaPPnkHtqAe3kr+aqhkhna8mpRG9J5VEqlL3J70NON8uNUlElthK3x3LWwgM4/7ENr29HGBvDuRN9wyATA6SSZAbjsbAt7xD9kXAKZm6GH/P2CiGYl6yzLwNBgpnn9RoKDvF3/uCEGew2DmGkGbKNm7uEvQg5TIlFfHPYO75biX4KtxT0Zw3BKFncuYQkNaezm6Fc0pueUP+3bzyyz86cmKXevvQvkDmxxH2vu5coJnNYO7Qa7YMEQk8lh8XKdUq8sjOZJystmNdnLELVAdQSE7s3I0aNC7FQqyBrsqecRsqzvVYg9cT8orJXvnxKiWTohfRULCw8w5Rh3Giur49zNAqqHITKe1aJ++qtmg6NK7U40g5qRtc7on1Lrrj4rH3kVcXu5WDgtFWB+cIXpwtaBW1HU= 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: SeongJae Park Document the new DAMOS action destinations sysfs directories on ABI doc. Signed-off-by: SeongJae Park --- .../ABI/testing/sysfs-kernel-mm-damon | 22 +++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon index 5697ab154c1f..e98974dfac7a 100644 --- a/Documentation/ABI/testing/sysfs-kernel-mm-damon +++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon @@ -431,6 +431,28 @@ Description: Directory for DAMON operations set layer-handled DAMOS filters. /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//filters directory. +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//dests/nr_dests +Date: Jul 2025 +Contact: SeongJae Park +Description: Writing a number 'N' to this file creates the number of + directories for setting action destinations of the scheme named + '0' to 'N-1' under the dests/ directory. + +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//dests//id +Date: Jul 2025 +Contact: SeongJae Park +Description: Writing to and reading from this file sets and gets the id of + the DAMOS action destination. For DAMOS_MIGRATE_{HOT,COLD} + actions, the destination node's node id can be written and + read. + +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//dests//weight +Date: Jul 2025 +Contact: SeongJae Park +Description: Writing to and reading from this file sets and gets the weight + of the DAMOS action destination to select as the destination of + each action among the destinations. + What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//stats/nr_tried Date: Mar 2022 Contact: SeongJae Park -- 2.43.0