From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 B0D43231836; Tue, 21 Apr 2026 04:49:45 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776746985; cv=none; b=Hq2VG5ChnaUf8fKKVt1CqDkh1q8a74IvUyRmyt5Fy/QQXlPumz4S4Bu7XTHfb3gaKD/58V5TrbTVJCagP7HB3OfHD7Ch4SnbzY4YCyHXnOakwzifBRf7yeb1nFrJqmN1Gx/OIYh8Z5+1RxH9Xyjbrg81BtJbHzTE37SdOXBH6A4= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776746985; c=relaxed/simple; bh=ka4gbLZs99fExMD1yc1xEuZ3x1da439G/UiyCjNMmiQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=goy/5zpH21yEsuv8ucMBLnlykPtn2Q7QPPiUC5mwUg1QNi6hY1KFlYREOylgvtQE7AnC8ebocYT3oV/3Olz+mXUoRszXCpKPgdYGNuuZeUlrT8g9rDOzdMyb+FymJEQ+gHIx1bEP8o8Ym2Xlv5ZTBuMpDjsQIFIfYkyXBO7tecY= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=VxAXPIWx; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="VxAXPIWx" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 19FB8C2BCB5; Tue, 21 Apr 2026 04:49:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1776746985; bh=ka4gbLZs99fExMD1yc1xEuZ3x1da439G/UiyCjNMmiQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=VxAXPIWxB31Jk6/Qmby4wm0jEL0HHoppbsPaygsvseRuCttTk7XJFZPTDRTfu/968 sVgGpFssrD5yjsRi1eEs/w2v4V+0904KUXmvohuEvax8kBK9jjs9+Q8IwWCa8iCbaz uyUHho97AL/Gs0H4FpKrOFHa9lQ13/tdcX2Lu8mTn5yl3EbU2s5PTj3yez608G8l4m U3m6/LootpFAl/x1f84gJgMI8L+y1dB60kzpCjHDMAsw/9XamrkvuqtQg/ZtN4pGG1 gUCE3ZK30H/owzyhL1i/hpPrMvow3RJBJ9Uls6iGb18KKEuxjDNlkjI8zZlpTu9ab4 vyrcMRQs2AZkw== From: SeongJae Park To: Cc: SeongJae Park , "Liam R. Howlett" , Andrew Morton , David Hildenbrand , Jonathan Corbet , Lorenzo Stoakes , Michal Hocko , Mike Rapoport , Shuah Khan , Suren Baghdasaryan , Vlastimil Babka , damon@lists.linux.dev, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [RFC PATCH 1/2] Docs/admin-guide/mm/damon/usage: mark scheme filters sysfs dir as deprecated Date: Mon, 20 Apr 2026 21:49:26 -0700 Message-ID: <20260421044928.141388-2-sj@kernel.org> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260421044928.141388-1-sj@kernel.org> References: <20260421044928.141388-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 The alternatives of 'filters/' directory, namely 'core_filters/' and 'ops_filters/', can fully support all the features 'filters/' directory can do, and provide better user experience. Having 'filters/' directory is only confusing to users. Announce it as deprecated on the usage document. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index d5548e460857c..918c14a8e852b 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -486,9 +486,10 @@ layers. Filters that requested by ``core_filters`` and ``ops_filters`` will be installed before those of ``filters``. All three directories have same files. Use of ``filters`` directory can make expecting evaluation orders of given -filters with the files under directory bit confusing. Users are hence -recommended to use ``core_filters`` and ``ops_filters`` directories. The -``filters`` directory could be deprecated in future. +filters with the files under directory bit confusing. For the reason, +``filters`` directory is deprecated. It is still functioning, but it will be +broken and eventually removed in near future. Users should use +``core_filters`` and ``ops_filters`` directories instead. In the beginning, the directory has only one file, ``nr_filters``. Writing a number (``N``) to the file creates the number of child directories named ``0`` -- 2.47.3