From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-alma10-1.taild15c8.ts.net [100.103.45.18]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 360251EA65; Thu, 25 Jun 2026 14:24:40 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=100.103.45.18 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782397481; cv=none; b=bfCHJgzVJ/CZY2oNunDbarF2pxZzQG4VIlXsIICCIYla76j6JqJOBBIA5zYniwmQAY0dSq3YmmC9MvkA8BgO/b/asMZmC+FReEFbI/SY7oSvA/e7bQ7nKoP8STc2cKh3CcLQYWEX34qiwFD7C2T17OCtyl/mE1V1nn07oTTZrbk= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782397481; c=relaxed/simple; bh=U83CuGGTpz/l3QnDhUGShfNAF1oKHyDrOUzyv1RWKCM=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=jYmwP984izll8GKKQwb8+ScKjWov2HKC9J6/UHQdiHYLCn+vCejwC/EnUkd6j/rYbOIlRayxzOv2BUJ3hOVV/fDxDGoA4Fje0e3wGrZteFHkOD0hvcT6ni02idBdbNuCQVd8x5WVzrnAxhcc01pv/IUQtZqDZhwBOOXJfSNFT90= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=ifoY/AOk; arc=none smtp.client-ip=100.103.45.18 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="ifoY/AOk" Received: by smtp.kernel.org (Postfix) with ESMTPSA id BBD671F00A3A; Thu, 25 Jun 2026 14:24:36 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=kernel.org; s=k20260515; t=1782397479; bh=o5OttG5aZqvfe3QoWDGJ8CJoxJmlu+HgiCPFZDVymoA=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=ifoY/AOkapZewhih6Vu73IuNk+uEivXTeN1YPTEAQEGYR/rqaJlGEECgu6iooE/2j 8tWaIQl3ovBmvnCpWbOuDQC1sOKXWNDDtzTi7RBDQtWLMVQuHkMrTtvSrm51XZd9nO 6j9fV855ih+uLpDSOG3Eptw4EQ6fdrt1KUZauZBqj3a01ASI2mhWPTqL83Q8LBgAm1 SZp6LC3z0/2l1an4Z/eb7McQjhDHh0GiARmWEAeDgG5Ik1dCbq1Xx3Jm4GNKVKaZj6 ebaG/WJzflLBqjVRGo27uDJTtwluGNjEndR3eH9H+iquTin3ftqNgPg4yeIxY3c071 nbBMcWYqh1ozw== From: SeongJae Park To: Cc: SeongJae Park , "Liam R. Howlett" , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , Michal Hocko , Mike Rapoport , Suren Baghdasaryan , Vlastimil Babka , damon@lists.linux.dev, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [RFC PATCH v1.2 02/11] Docs/ABI/damon: document probe files Date: Thu, 25 Jun 2026 07:23:47 -0700 Message-ID: <20260625142357.103500-3-sj@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260625142357.103500-1-sj@kernel.org> References: <20260625142357.103500-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit DAMON ABI document is not updated for the DAMON probe sysfs files. Update. Signed-off-by: SeongJae Park --- .../ABI/testing/sysfs-kernel-mm-damon | 40 +++++++++++++++++++ 1 file changed, 40 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon index b73e6bc28ea5f..f914aab79fced 100644 --- a/Documentation/ABI/testing/sysfs-kernel-mm-damon +++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon @@ -157,6 +157,46 @@ Description: Writing a value to this file sets the maximum number of monitoring regions of the DAMON context as the value. Reading this file returns the value. +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//monitoring_attrs/probes/nr_probes +Date: May 2026 +Contact: SeongJae Park +Description: Writing a number 'N' to this file creates the number of + directories for each DAMON probe named '0' to 'N-1' under the + probes/ directory. + +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//monitoring_attrs/probes/

/filters/nr_filters +Date: May 2026 +Contact: SeongJae Park +Description: Writing a number 'N' to this file creates the number of + directories for each DAMON probe filter named '0' to 'N-1' + under the filters/ directory. + +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//monitoring_attrs/probes/

/filters//type +Date: May 2026 +Contact: SeongJae Park +Description: Writing to and reading from this file sets and gets the type of + the memory of the interest. + +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//monitoring_attrs/probes/

/filters//path +Date: May 2026 +Contact: SeongJae Park +Description: If 'memcg' is written to the 'type' file, writing to and + reading from this file sets and gets the path to the memory + cgroup of the interest. + +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//monitoring_attrs/probes/

/filters//matching +Date: May 2026 +Contact: SeongJae Park +Description: Writing 'Y' or 'N' to this file sets whether the filter is for + the memory of the 'type', or all except the 'type'. + +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//monitoring_attrs/probes/

/filters//allow +Date: May 2026 +Contact: SeongJae Park +Description: Writing 'Y' or 'N' to this file sets whether to allow or reject + hitting the probe for the memory that satisfies the 'type' and + the 'matching' of the directory. + What: /sys/kernel/mm/damon/admin/kdamonds//contexts//targets/nr_targets Date: Mar 2022 Contact: SeongJae Park -- 2.47.3