mm/damon/Kconfig: add DAMON debugfs interface deprecation notice
authorSeongJae Park <sj@kernel.org>
Thu, 9 Feb 2023 19:20:08 +0000 (19:20 +0000)
committerAndrew Morton <akpm@linux-foundation.org>
Mon, 13 Feb 2023 23:54:32 +0000 (15:54 -0800)
DAMON debugfs interface has announced to be deprecated after >v5.15 LTS
kernel is released.  And, v6.1.y has announced to be an LTS[1].

Though the announcement was there for a while, some people might not
noticed that so far.  Also, some users could depend on it and have
problems at  movng to the alternative (DAMON sysfs interface).

For such cases, note DAMON debugfs interface as deprecated, and contacts
to ask helps on the Kconfig.

[1] https://git.kernel.org/pub/scm/docs/kernel/website.git/commit/?id=332e9121320bc7461b2d3a79665caf153e51732c

Link: https://lkml.kernel.org/r/20230209192009.7885-3-sj@kernel.org
Signed-off-by: SeongJae Park <sj@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
mm/damon/Kconfig

index 7821fcb3f25869d72673f2246d045db60ea46f72..436c6b4cb5ec57fb7e47d093569ec093d7ec7401 100644 (file)
@@ -60,7 +60,7 @@ config DAMON_SYSFS
          the interface for arbitrary data access monitoring.
 
 config DAMON_DBGFS
-       bool "DAMON debugfs interface"
+       bool "DAMON debugfs interface (DEPRECATED!)"
        depends on DAMON_VADDR && DAMON_PADDR && DEBUG_FS
        help
          This builds the debugfs interface for DAMON.  The user space admins
@@ -68,8 +68,9 @@ config DAMON_DBGFS
 
          If unsure, say N.
 
-         This will be removed after >5.15.y LTS kernel is released, so users
-         should move to the sysfs interface (DAMON_SYSFS).
+         This is deprecated, so users should move to the sysfs interface
+         (DAMON_SYSFS).  If you depend on this and cannot move, please report
+         your usecase to damon@lists.linux.dev and linux-mm@kvack.org.
 
 config DAMON_DBGFS_KUNIT_TEST
        bool "Test for damon debugfs interface" if !KUNIT_ALL_TESTS