The patch titled
Subject: Docs/translations/damon/usage: update for monitor_on renaming
has been added to the -mm mm-unstable branch. Its filename is
docs-translations-damon-usage-update-for-monitor_on-renaming.patch
This patch will shortly appear at
https://git.kernel.org/pub/scm/linux/kernel/git/akpm/25-new.git/tree/patches/docs-translations-damon-usage-update-for-monitor_on-renaming.patch
This patch will later appear in the mm-unstable branch at
git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm
Before you just go and hit "reply", please:
a) Consider who else should be cc'ed
b) Prefer to cc a suitable mailing list as well
c) Ideally: find the original patch on the mailing list and do a
reply-to-all to that, adding suitable additional cc's
*** Remember to use Documentation/process/submit-checklist.rst when testing your code ***
The -mm tree is included into linux-next via the mm-everything
branch at git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm
and is updated there every 2-3 working days
------------------------------------------------------
From: SeongJae Park <sj@xxxxxxxxxx>
Subject: Docs/translations/damon/usage: update for monitor_on renaming
Date: Mon, 29 Jan 2024 17:35:48 -0800
Update DAMON debugfs interface sections on the translated usage documents
to reflect the fact that 'monitor_on' file has renamed to
'monitor_on_DEPRECATED'.
Link: https://lkml.kernel.org/r/20240130013549.89538-10-sj@xxxxxxxxxx
Signed-off-by: SeongJae Park <sj@xxxxxxxxxx>
Cc: Alex Shi <alexs@xxxxxxxxxx>
Cc: Hu Haowen <2023002089@xxxxxxxxxxxxxxxx>
Cc: Jonathan Corbet <corbet@xxxxxxx>
Cc: Shuah Khan <shuah@xxxxxxxxxx>
Cc: Yanteng Si <siyanteng@xxxxxxxxxxx>
Signed-off-by: Andrew Morton <akpm@xxxxxxxxxxxxxxxxxxxx>
---
Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst | 20 +++++-----
Documentation/translations/zh_TW/admin-guide/mm/damon/usage.rst | 20 +++++-----
2 files changed, 20 insertions(+), 20 deletions(-)
--- a/Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst~docs-translations-damon-usage-update-for-monitor_on-renaming
+++ a/Documentation/translations/zh_CN/admin-guide/mm/damon/usage.rst
@@ -344,7 +344,7 @@ debugfs��
:ref:`sysfsæ?¥å?£<sysfs_interface>`ã??
DAMON导å?ºäº?å?«ä¸ªæ??件, ``attrs``, ``target_ids``, ``init_regions``,
-``schemes``, ``monitor_on``, ``kdamond_pid``, ``mk_contexts`` å??
+``schemes``, ``monitor_on_DEPRECATED``, ``kdamond_pid``, ``mk_contexts`` å??
``rm_contexts`` under its debugfs directory, ``<debugfs>/damon/``.
@@ -521,15 +521,15 @@ 大äº?60%ï¼?æ??ä½?äº?30%ï¼?å??å??æ¢ç??æ
å¼?å?³
----
-é?¤é??ä½ æ??ç¡®å?°å?¯å?¨ç??æµ?ï¼?å?¦å??å¦?ä¸?æ??è¿°ç??æ??件设置ä¸?ä¼?产ç??æ??æ??ã??ä½ å?¯ä»¥é??è¿?å??å?¥å??读å?? ``monitor_on``
+é?¤é??ä½ æ??ç¡®å?°å?¯å?¨ç??æµ?ï¼?å?¦å??å¦?ä¸?æ??è¿°ç??æ??件设置ä¸?ä¼?产ç??æ??æ??ã??ä½ å?¯ä»¥é??è¿?å??å?¥å??读å?? ``monitor_on_DEPRECATED``
æ??件æ?¥å?¯å?¨ã??å??æ¢å??æ£?æ?¥ç??æµ?ç??å½?å??ç?¶æ??ã??å??å?¥ ``on`` 该æ??件å?¯ä»¥å?¯å?¨å¯¹æ??å±?æ?§ç??ç?®æ ?ç??ç??æµ?ã??å??å?¥
``off`` 该æ??件å??å??æ¢è¿?äº?ç?®æ ?ã??å¦?æ??æ¯?个ç?®æ ?è¿?ç¨?被ç»?æ¢ï¼?DAMONä¹?ä¼?å??æ¢ã??ä¸?é?¢ç??示ä¾?å?½ä»¤å¼?å?¯ã??å?³
é?å??æ£?æ?¥DAMONç??ç?¶æ??::
# cd <debugfs>/damon
- # echo on > monitor_on
- # echo off > monitor_on
- # cat monitor_on
+ # echo on > monitor_on_DEPRECATED
+ # echo off > monitor_on_DEPRECATED
+ # cat monitor_on_DEPRECATED
off
请注æ??ï¼?å½?ç??æµ?å¼?å?¯æ?¶ï¼?ä½ ä¸?è?½å??å?°ä¸?è¿°ç??debugfsæ??件ã??å¦?æ??ä½ å?¨DAMONè¿?è¡?æ?¶å??å?°è¿?äº?æ??件ï¼?å°?ä¼?è¿?
@@ -543,11 +543,11 @@ DAMONé??è¿?ä¸?个å?«å??kdamondç??å??æ ¸ç
å¾?该线ç¨?ç?? ``pid`` ã??å½?ç??æµ?被 ``å?³é?`` æ?¶ï¼?读å??该æ??件ä¸?ä¼?è¿?å??ä»»ä½?ä¿¡æ?¯::
# cd <debugfs>/damon
- # cat monitor_on
+ # cat monitor_on_DEPRECATED
off
# cat kdamond_pid
none
- # echo on > monitor_on
+ # echo on > monitor_on_DEPRECATED
# cat kdamond_pid
18594
@@ -574,7 +574,7 @@ å¦?æ??ä¸?å??é??è¦?ä¸?ä¸?æ??ï¼?ä½ å?¯ä»¥é
# ls foo
# ls: cannot access 'foo': No such file or directory
-注æ??ï¼? ``mk_contexts`` ã?? ``rm_contexts`` å?? ``monitor_on`` æ??件å?ªå?¨æ ¹ç?®å½?ä¸?ã??
+注æ??ï¼? ``mk_contexts`` ã?? ``rm_contexts`` å?? ``monitor_on_DEPRECATED`` æ??件å?ªå?¨æ ¹ç?®å½?ä¸?ã??
ç??æµ?ç»?æ??ç??ç??æµ?ç?¹
@@ -583,9 +583,9 @@ ç??æµ?ç»?æ??ç??ç??æµ?ç?¹
DAMONé??è¿?ä¸?个tracepoint ``damon:damon_aggregated`` æ??ä¾?ç??æµ?ç»?æ??. å½?ç??æµ?å¼?å?¯æ?¶ï¼?ä½ å?¯
以记å½?追踪ç?¹äº?件ï¼?并使ç?¨è¿½è¸ªç?¹æ?¯æ??å·¥å?·å¦?perfæ?¾ç¤ºç»?æ??ã??æ¯?å¦?说::
- # echo on > monitor_on
+ # echo on > monitor_on_DEPRECATED
# perf record -e damon:damon_aggregated &
# sleep 5
# kill 9 $(pidof perf)
- # echo off > monitor_on
+ # echo off > monitor_on_DEPRECATED
# perf script
--- a/Documentation/translations/zh_TW/admin-guide/mm/damon/usage.rst~docs-translations-damon-usage-update-for-monitor_on-renaming
+++ a/Documentation/translations/zh_TW/admin-guide/mm/damon/usage.rst
@@ -344,7 +344,7 @@ debugfs��
:ref:`sysfsæ?¥å?£<sysfs_interface>`ã??
DAMONå°?å?ºäº?å?«å??æ??件, ``attrs``, ``target_ids``, ``init_regions``,
-``schemes``, ``monitor_on``, ``kdamond_pid``, ``mk_contexts`` å??
+``schemes``, ``monitor_on_DEPRECATED``, ``kdamond_pid``, ``mk_contexts`` å??
``rm_contexts`` under its debugfs directory, ``<debugfs>/damon/``.
@@ -521,15 +521,15 @@ 大æ?¼60%ï¼?æ??ä½?æ?¼30%ï¼?å??å??æ¢ç?£æ
é??é??
----
-é?¤é??ä½ æ??確å?°å??å??ç?£æ¸¬ï¼?å?¦å??å¦?ä¸?æ??è¿°ç??æ??件è¨ç½®ä¸?æ??ç?¢ç??æ??æ??ã??ä½ å?¯ä»¥é??é??寫å?¥å??è®?å?? ``monitor_on``
+é?¤é??ä½ æ??確å?°å??å??ç?£æ¸¬ï¼?å?¦å??å¦?ä¸?æ??è¿°ç??æ??件è¨ç½®ä¸?æ??ç?¢ç??æ??æ??ã??ä½ å?¯ä»¥é??é??寫å?¥å??è®?å?? ``monitor_on_DEPRECATED``
æ??件ä¾?å??å??ã??å??æ¢å??檢æ?¥ç?£æ¸¬ç??ç?¶å??ç??æ??ã??寫å?¥ ``on`` 該æ??件å?¯ä»¥å??å??å°?æ??屬æ?§ç??ç?®æ¨?ç??ç?£æ¸¬ã??寫å?¥
``off`` 該æ??件å??å??æ¢é??äº?ç?®æ¨?ã??å¦?æ??æ¯?å??ç?®æ¨?é?²ç¨?被çµ?æ¢ï¼?DAMONä¹?æ??å??æ¢ã??ä¸?é?¢ç??示ä¾?å?½ä»¤é??å??ã??é??
é??å??檢æ?¥DAMONç??ç??æ??::
# cd <debugfs>/damon
- # echo on > monitor_on
- # echo off > monitor_on
- # cat monitor_on
+ # echo on > monitor_on_DEPRECATED
+ # echo off > monitor_on_DEPRECATED
+ # cat monitor_on_DEPRECATED
off
è«?注æ??ï¼?ç?¶ç?£æ¸¬é??å??æ??ï¼?ä½ ä¸?è?½å¯«å?°ä¸?è¿°ç??debugfsæ??件ã??å¦?æ??ä½ å?¨DAMONé??è¡?æ??寫å?°é??äº?æ??件ï¼?å°?æ??è¿?
@@ -543,11 +543,11 @@ DAMONé??é??ä¸?å??å?«å??kdamondç??å?§æ ¸ç
å¾?該ç·?ç¨?ç?? ``pid`` ã??ç?¶ç?£æ¸¬è¢« ``é??é??`` æ??ï¼?è®?å??該æ??件ä¸?æ??è¿?å??ä»»ä½?ä¿¡æ?¯::
# cd <debugfs>/damon
- # cat monitor_on
+ # cat monitor_on_DEPRECATED
off
# cat kdamond_pid
none
- # echo on > monitor_on
+ # echo on > monitor_on_DEPRECATED
# cat kdamond_pid
18594
@@ -574,7 +574,7 @@ å¦?æ??ä¸?å??é??è¦?ä¸?ä¸?æ??ï¼?ä½ å?¯ä»¥é
# ls foo
# ls: cannot access 'foo': No such file or directory
-注æ??ï¼? ``mk_contexts`` ã?? ``rm_contexts`` å?? ``monitor_on`` æ??件å?ªå?¨æ ¹ç?®é??ä¸?ã??
+注æ??ï¼? ``mk_contexts`` ã?? ``rm_contexts`` å?? ``monitor_on_DEPRECATED`` æ??件å?ªå?¨æ ¹ç?®é??ä¸?ã??
ç?£æ¸¬çµ?æ??ç??ç?£æ¸¬é»?
@@ -583,10 +583,10 @@ ç?£æ¸¬çµ?æ??ç??ç?£æ¸¬é»?
DAMONé??é??ä¸?å??tracepoint ``damon:damon_aggregated`` æ??ä¾?ç?£æ¸¬çµ?æ??. ç?¶ç?£æ¸¬é??å??æ??ï¼?ä½ å?¯
以è¨?é??追蹤é»?äº?件ï¼?並使ç?¨è¿½è¹¤é»?æ?¯æ??å·¥å?·å¦?perf顯示çµ?æ??ã??æ¯?å¦?說::
- # echo on > monitor_on
+ # echo on > monitor_on_DEPRECATED
# perf record -e damon:damon_aggregated &
# sleep 5
# kill 9 $(pidof perf)
- # echo off > monitor_on
+ # echo off > monitor_on_DEPRECATED
# perf script
_
Patches currently in -mm which might be from sj@xxxxxxxxxx are
docs-admin-guide-mm-damon-usage-use-sysfs-interface-for-tracepoints-example.patch
mm-damon-rename-config_damon_dbgfs-to-damon_dbgfs_deprecated.patch
mm-damon-dbgfs-implement-deprecation-notice-file.patch
mm-damon-dbgfs-make-debugfs-interface-deprecation-message-a-macro.patch
docs-admin-guide-mm-damon-usage-document-deprecated-file-of-damon-debugfs-interface.patch
selftets-damon-prepare-for-monitor_on-file-renaming.patch
mm-damon-dbgfs-rename-monitor_on-file-to-monitor_on_deprecated.patch
docs-admin-guide-mm-damon-usage-update-for-monitor_on-renaming.patch
docs-translations-damon-usage-update-for-monitor_on-renaming.patch
