1what: /sys/kernel/mm/damon/ 2Date: Mar 2022 3Contact: SJ Park <sj@kernel.org> 4Description: Interface for Data Access MONitoring (DAMON). Contains files 5 for controlling DAMON. For more details on DAMON itself, 6 please refer to Documentation/mm/damon/index.rst. 7 8What: /sys/kernel/mm/damon/admin/ 9Date: Mar 2022 10Contact: SJ Park <sj@kernel.org> 11Description: Interface for privileged users of DAMON. Contains files for 12 controlling DAMON that aimed to be used by privileged users. 13 14What: /sys/kernel/mm/damon/admin/kdamonds/nr_kdamonds 15Date: Mar 2022 16Contact: SJ Park <sj@kernel.org> 17Description: Writing a number 'N' to this file creates the number of 18 directories for controlling each DAMON worker thread (kdamond) 19 named '0' to 'N-1' under the kdamonds/ directory. 20 21What: /sys/kernel/mm/damon/admin/kdamonds/<K>/state 22Date: Mar 2022 23Contact: SJ Park <sj@kernel.org> 24Description: Writing 'on' or 'off' to this file makes the kdamond starts or 25 stops, respectively. Reading the file returns the keywords 26 based on the current status. Writing 'commit' to this file 27 makes the kdamond reads the user inputs in the sysfs files 28 except 'state' again. Writing 'commit_schemes_quota_goals' to 29 this file makes the kdamond reads the quota goal files again. 30 Writing 'update_schemes_stats' to the file updates contents of 31 schemes stats files of the kdamond. Writing 32 'update_schemes_tried_regions' to the file updates contents of 33 'tried_regions' directory of every scheme directory of this 34 kdamond. Writing 'update_schemes_tried_bytes' to the file 35 updates only '.../tried_regions/total_bytes' files of this 36 kdamond. Writing 'clear_schemes_tried_regions' to the file 37 removes contents of the 'tried_regions' directory. Writing 38 'update_schemes_effective_quotas' to the file updates 39 '.../quotas/effective_bytes' files of this kdamond. Writing 40 'update_tuned_intervals' to the file updates 'sample_us' and 41 'aggr_us' files under 'monitoring_attrs/intervals' with the 42 auto-tuned sampling and aggregation intervals. 43 44What: /sys/kernel/mm/damon/admin/kdamonds/<K>/pid 45Date: Mar 2022 46Contact: SJ Park <sj@kernel.org> 47Description: Reading this file returns the pid of the kdamond if it is 48 running. 49 50What: /sys/kernel/mm/damon/admin/kdamonds/<K>/refresh_ms 51Date: Jul 2025 52Contact: SJ Park <sj@kernel.org> 53Description: Writing a value to this file sets the time interval for 54 automatic DAMON status file contents update. Writing '0' 55 disables the update. Reading this file returns the value. 56 57What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/nr_contexts 58Date: Mar 2022 59Contact: SJ Park <sj@kernel.org> 60Description: Writing a number 'N' to this file creates the number of 61 directories for controlling each DAMON context named '0' to 62 'N-1' under the contexts/ directory. 63 64What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/avail_operations 65Date: Apr 2022 66Contact: SJ Park <sj@kernel.org> 67Description: Reading this file returns the available monitoring operations 68 sets on the currently running kernel. 69 70What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/operations 71Date: Mar 2022 72Contact: SJ Park <sj@kernel.org> 73Description: Writing a keyword for a monitoring operations set ('vaddr' for 74 virtual address spaces monitoring, 'fvaddr' for fixed virtual 75 address ranges monitoring, and 'paddr' for the physical address 76 space monitoring) to this file makes the context to use the 77 operations set. Reading the file returns the keyword for the 78 operations set the context is set to use. 79 80 Note that only the operations sets that listed in 81 'avail_operations' file are valid inputs. 82 83What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/addr_unit 84Date: Aug 2025 85Contact: SJ Park <sj@kernel.org> 86Description: Writing an integer to this file sets the 'address unit' 87 parameter of the given operations set of the context. Reading 88 the file returns the last-written 'address unit' value. 89 90What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/pause 91Date: Mar 2026 92Contact: SJ Park <sj@kernel.org> 93Description: Writing a boolean keyword to this file sets the 'pause' request 94 parameter for the context. Reading the file returns the 95 last-written 'pause' value. 96 97What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/sample_us 98Date: Mar 2022 99Contact: SJ Park <sj@kernel.org> 100Description: Writing a value to this file sets the sampling interval of the 101 DAMON context in microseconds as the value. Reading this file 102 returns the value. 103 104What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/aggr_us 105Date: Mar 2022 106Contact: SJ Park <sj@kernel.org> 107Description: Writing a value to this file sets the aggregation interval of 108 the DAMON context in microseconds as the value. Reading this 109 file returns the value. 110 111What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/update_us 112Date: Mar 2022 113Contact: SJ Park <sj@kernel.org> 114Description: Writing a value to this file sets the update interval of the 115 DAMON context in microseconds as the value. Reading this file 116 returns the value. 117 118What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intervals_goal/access_bp 119Date: Feb 2025 120Contact: SJ Park <sj@kernel.org> 121Description: Writing a value to this file sets the monitoring intervals 122 auto-tuning target DAMON-observed access events ratio within 123 the given time interval (aggrs in same directory), in bp 124 (1/10,000). Reading this file returns the value. 125 126What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intervals_goal/aggrs 127Date: Feb 2025 128Contact: SJ Park <sj@kernel.org> 129Description: Writing a value to this file sets the time interval to achieve 130 the monitoring intervals auto-tuning target DAMON-observed 131 access events ratio (access_bp in same directory) within. 132 Reading this file returns the value. 133 134What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intervals_goal/min_sample_us 135Date: Feb 2025 136Contact: SJ Park <sj@kernel.org> 137Description: Writing a value to this file sets the minimum value of 138 auto-tuned sampling interval in microseconds. Reading this 139 file returns the value. 140 141What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intervals_goal/max_sample_us 142Date: Feb 2025 143Contact: SJ Park <sj@kernel.org> 144Description: Writing a value to this file sets the maximum value of 145 auto-tuned sampling interval in microseconds. Reading this 146 file returns the value. 147 148What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/min 149 150Date: Mar 2022 151Contact: SJ Park <sj@kernel.org> 152Description: Writing a value to this file sets the minimum number of 153 monitoring regions of the DAMON context as the value. Reading 154 this file returns the value. 155 156What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/max 157Date: Mar 2022 158Contact: SJ Park <sj@kernel.org> 159Description: Writing a value to this file sets the maximum number of 160 monitoring regions of the DAMON context as the value. Reading 161 this file returns the value. 162 163What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/nr_probes 164Date: May 2026 165Contact: SJ Park <sj@kernel.org> 166Description: Writing a number 'N' to this file creates the number of 167 directories for each DAMON probe named '0' to 'N-1' under the 168 probes/ directory. 169 170What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/<P>/weight 171Date: Jul 2026 172Contact: SJ Park <sj@kernel.org> 173Description: Writing to and reading from this file sets and gets the 174 per-probe attribute weight. 175 176What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/<P>/preps/nr_preps 177Date: Jun 2026 178Contact: SJ Park <sj@kernel.org> 179Description: Writing a number 'N' to this file creates the number of 180 directories for each DAMON probing preparation action named '0' 181 to 'N-1' under the preps/ directory. 182 183What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/<P>/preps/<R>/prep_action 184Date: Jun 2026 185Contact: SJ Park <sj@kernel.org> 186Description: Writing to and reading from this file sets and gets the probing 187 preparation action. 188 189What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/<P>/filters/nr_filters 190Date: May 2026 191Contact: SJ Park <sj@kernel.org> 192Description: Writing a number 'N' to this file creates the number of 193 directories for each DAMON probe filter named '0' to 'N-1' 194 under the filters/ directory. 195 196What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/<P>/filters/<F>/type 197Date: May 2026 198Contact: SJ Park <sj@kernel.org> 199Description: Writing to and reading from this file sets and gets the type of 200 the memory of the interest. 201 202What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/<P>/filters/<F>/path 203Date: May 2026 204Contact: SJ Park <sj@kernel.org> 205Description: If 'memcg' is written to the 'type' file, writing to and 206 reading from this file sets and gets the path to the memory 207 cgroup of the interest. 208 209What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/<P>/filters/<F>/min 210Date: Sep 2026 211Contact: SJ Park <sj@kernel.org> 212Description: If 'hugepage_size' is written to the 'type' file, writing to and 213 reading from this file sets and gets the minimum size of the 214 huge page of the interest. 215 216What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/<P>/filters/<F>/max 217Date: Sep 2026 218Contact: SJ Park <sj@kernel.org> 219Description: If 'hugepage_size' is written to the 'type' file, writing to and 220 reading from this file sets and gets the maximum size of the 221 huge page of the interest. 222 223What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/<P>/filters/<F>/matching 224Date: May 2026 225Contact: SJ Park <sj@kernel.org> 226Description: Writing 'Y' or 'N' to this file sets whether the filter is for 227 the memory of the 'type', or all except the 'type'. 228 229What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/probes/<P>/filters/<F>/allow 230Date: May 2026 231Contact: SJ Park <sj@kernel.org> 232Description: Writing 'Y' or 'N' to this file sets whether to allow or reject 233 hitting the probe for the memory that satisfies the 'type' and 234 the 'matching' of the directory. 235 236What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/nr_targets 237Date: Mar 2022 238Contact: SJ Park <sj@kernel.org> 239Description: Writing a number 'N' to this file creates the number of 240 directories for controlling each DAMON target of the context 241 named '0' to 'N-1' under the contexts/ directory. 242 243What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/pid_target 244Date: Mar 2022 245Contact: SJ Park <sj@kernel.org> 246Description: Writing to and reading from this file sets and gets the pid of 247 the target process if the context is for virtual address spaces 248 monitoring, respectively. 249 250What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/obsolete_target 251Date: Oct 2025 252Contact: SJ Park <sj@kernel.org> 253Description: Writing to and reading from this file sets and gets the 254 obsoleteness of the matching parameters commit destination 255 target. 256 257What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/nr_regions 258Date: Mar 2022 259Contact: SJ Park <sj@kernel.org> 260Description: Writing a number 'N' to this file creates the number of 261 directories for setting each DAMON target memory region of the 262 context named '0' to 'N-1' under the regions/ directory. In 263 case of the virtual address space monitoring, DAMON 264 automatically sets the target memory region based on the target 265 processes' mappings. 266 267What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/<R>/start 268Date: Mar 2022 269Contact: SJ Park <sj@kernel.org> 270Description: Writing to and reading from this file sets and gets the start 271 address of the monitoring region. 272 273What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/targets/<T>/regions/<R>/end 274Date: Mar 2022 275Contact: SJ Park <sj@kernel.org> 276Description: Writing to and reading from this file sets and gets the end 277 address of the monitoring region. 278 279What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/nr_schemes 280Date: Mar 2022 281Contact: SJ Park <sj@kernel.org> 282Description: Writing a number 'N' to this file creates the number of 283 directories for controlling each DAMON-based operation scheme 284 of the context named '0' to 'N-1' under the schemes/ directory. 285 286What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/action 287Date: Mar 2022 288Contact: SJ Park <sj@kernel.org> 289Description: Writing to and reading from this file sets and gets the action 290 of the scheme. 291 292What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/target_nid 293Date: Jun 2024 294Contact: SJ Park <sj@kernel.org> 295Description: Action's target NUMA node id. Supported by only relevant 296 actions. 297 298What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/apply_interval_us 299Date: Sep 2023 300Contact: SJ Park <sj@kernel.org> 301Description: Writing a value to this file sets the action apply interval of 302 the scheme in microseconds. Reading this file returns the 303 value. 304 305What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/sz/min 306Date: Mar 2022 307Contact: SJ Park <sj@kernel.org> 308Description: Writing to and reading from this file sets and gets the minimum 309 size of the scheme's target regions in bytes. 310 311What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/sz/max 312Date: Mar 2022 313Contact: SJ Park <sj@kernel.org> 314Description: Writing to and reading from this file sets and gets the maximum 315 size of the scheme's target regions in bytes. 316 317What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/min 318Date: Mar 2022 319Contact: SJ Park <sj@kernel.org> 320Description: Writing to and reading from this file sets and gets the minimum 321 'nr_accesses' of the scheme's target regions. 322 323What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/max 324Date: Mar 2022 325Contact: SJ Park <sj@kernel.org> 326Description: Writing to and reading from this file sets and gets the maximum 327 'nr_accesses' of the scheme's target regions. 328 329What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/age/min 330Date: Mar 2022 331Contact: SJ Park <sj@kernel.org> 332Description: Writing to and reading from this file sets and gets the minimum 333 'age' of the scheme's target regions. 334 335What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/age/max 336Date: Mar 2022 337Contact: SJ Park <sj@kernel.org> 338Description: Writing to and reading from this file sets and gets the maximum 339 'age' of the scheme's target regions. 340 341What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/ms 342Date: Mar 2022 343Contact: SJ Park <sj@kernel.org> 344Description: Writing to and reading from this file sets and gets the time 345 quota of the scheme in milliseconds. 346 347What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/bytes 348Date: Mar 2022 349Contact: SJ Park <sj@kernel.org> 350Description: Writing to and reading from this file sets and gets the size 351 quota of the scheme in bytes. 352 353What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/effective_bytes 354Date: Feb 2024 355Contact: SJ Park <sj@kernel.org> 356Description: Reading from this file gets the effective size quota of the 357 scheme in bytes, which adjusted for the time quota and goals. 358 359What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/reset_interval_ms 360Date: Mar 2022 361Contact: SJ Park <sj@kernel.org> 362Description: Writing to and reading from this file sets and gets the quotas 363 charge reset interval of the scheme in milliseconds. 364 365What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/nr_goals 366Date: Nov 2023 367Contact: SJ Park <sj@kernel.org> 368Description: Writing a number 'N' to this file creates the number of 369 directories for setting automatic tuning of the scheme's 370 aggressiveness named '0' to 'N-1' under the goals/ directory. 371 372What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/target_metric 373Date: Feb 2024 374Contact: SJ Park <sj@kernel.org> 375Description: Writing to and reading from this file sets and gets the quota 376 auto-tuning goal metric. 377 378What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/complement 379Date: Sep 2026 380Contact: SJ Park <sj@kernel.org> 381Description: Writing to and reading from this file sets and gets whether to 382 use the complement value of the quota auto-tuning goal metric. 383 384What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/target_value 385Date: Nov 2023 386Contact: SJ Park <sj@kernel.org> 387Description: Writing to and reading from this file sets and gets the target 388 value of the goal metric. 389 390What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/current_value 391Date: Nov 2023 392Contact: SJ Park <sj@kernel.org> 393Description: Writing to and reading from this file sets and gets the current 394 value of the goal metric. 395 396What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/nid 397Date: Apr 2025 398Contact: SJ Park <sj@kernel.org> 399Description: Writing to and reading from this file sets and gets the nid 400 parameter of the goal. 401 402What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goals/<G>/path 403Date: Oct 2025 404Contact: SJ Park <sj@kernel.org> 405Description: Writing to and reading from this file sets and gets the path 406 parameter of the goal. 407 408What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/goal_tuner 409Date: Mar 2026 410Contact: SJ Park <sj@kernel.org> 411Description: Writing to and reading from this file sets and gets the 412 goal-based effective quota auto-tuning algorithm to use. 413 414What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/fail_charge_num 415Date: Mar 2026 416Contact: SJ Park <sj@kernel.org> 417Description: Writing to and reading from this file sets and gets the 418 action-failed memory quota charging ratio numerator. 419 420What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/fail_charge_denom 421Date: Mar 2026 422Contact: SJ Park <sj@kernel.org> 423Description: Writing to and reading from this file sets and gets the 424 action-failed memory quota charging ratio denominator. 425 426What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/sz_permil 427Date: Mar 2022 428Contact: SJ Park <sj@kernel.org> 429Description: Writing to and reading from this file sets and gets the 430 under-quota limit regions prioritization weight for 'size' in 431 permil. 432 433What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/nr_accesses_permil 434Date: Mar 2022 435Contact: SJ Park <sj@kernel.org> 436Description: Writing to and reading from this file sets and gets the 437 under-quota limit regions prioritization weight for 438 'nr_accesses' in permil. 439 440What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/quotas/weights/age_permil 441Date: Mar 2022 442Contact: SJ Park <sj@kernel.org> 443Description: Writing to and reading from this file sets and gets the 444 under-quota limit regions prioritization weight for 'age' in 445 permil. 446 447What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/metric 448Date: Mar 2022 449Contact: SJ Park <sj@kernel.org> 450Description: Writing to and reading from this file sets and gets the metric 451 of the watermarks for the scheme. The writable/readable 452 keywords for this file are 'none' for disabling the watermarks 453 feature, or 'free_mem_rate' for the system's global free memory 454 rate in permil. 455 456What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/interval_us 457Date: Mar 2022 458Contact: SJ Park <sj@kernel.org> 459Description: Writing to and reading from this file sets and gets the metric 460 check interval of the watermarks for the scheme in 461 microseconds. 462 463What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/high 464Date: Mar 2022 465Contact: SJ Park <sj@kernel.org> 466Description: Writing to and reading from this file sets and gets the high 467 watermark of the scheme in permil. 468 469What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/mid 470Date: Mar 2022 471Contact: SJ Park <sj@kernel.org> 472Description: Writing to and reading from this file sets and gets the mid 473 watermark of the scheme in permil. 474 475What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/watermarks/low 476Date: Mar 2022 477Contact: SJ Park <sj@kernel.org> 478Description: Writing to and reading from this file sets and gets the low 479 watermark of the scheme in permil. 480 481What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters 482Date: Feb 2025 483Contact: SJ Park <sj@kernel.org> 484Description: Directory for DAMON core layer-handled DAMOS filters. 485 486What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters/nr_filters 487Date: Feb 2025 488Contact: SJ Park <sj@kernel.org> 489Description: Writing a number 'N' to this file creates the number of 490 directories for setting filters of the scheme named '0' to 491 'N-1' under the core_filters/ directory. 492 493What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters/<F>/type 494Date: Feb 2025 495Contact: SJ Park <sj@kernel.org> 496Description: Writing to and reading from this file sets and gets the type of 497 the memory of the interest. 'anon' for anonymous pages, 498 'memcg' for specific memory cgroup, 'young' for young pages, 499 'addr' for address range (an open-ended interval), or 'target' 500 for DAMON monitoring target can be written and read. 501 502What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters/<F>/memcg_path 503Date: Feb 2025 504Contact: SJ Park <sj@kernel.org> 505Description: If 'memcg' is written to the 'type' file, writing to and 506 reading from this file sets and gets the path to the memory 507 cgroup of the interest. 508 509What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters/<F>/addr_start 510Date: Feb 2025 511Contact: SJ Park <sj@kernel.org> 512Description: If 'addr' is written to the 'type' file, writing to or reading 513 from this file sets or gets the start address of the address 514 range for the filter. 515 516What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters/<F>/addr_end 517Date: Feb 2025 518Contact: SJ Park <sj@kernel.org> 519Description: If 'addr' is written to the 'type' file, writing to or reading 520 from this file sets or gets the end address of the address 521 range for the filter. 522 523What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters/<F>/min 524Date: Feb 2025 525Contact: SJ Park <sj@kernel.org> 526Description: If 'hugepage_size' is written to the 'type' file, writing to 527 or reading from this file sets or gets the minimum size of the 528 hugepage for the filter. 529 530What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters/<F>/max 531Date: Feb 2025 532Contact: SJ Park <sj@kernel.org> 533Description: If 'hugepage_size' is written to the 'type' file, writing to 534 or reading from this file sets or gets the maximum size of the 535 hugepage for the filter. 536 537What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters/<F>/damon_target_idx 538Date: Feb 2025 539Contact: SJ Park <sj@kernel.org> 540Description: If 'target' is written to the 'type' file, writing to or 541 reading from this file sets or gets the index of the DAMON 542 monitoring target of the interest. 543 544What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters/<F>/matching 545Date: Feb 2025 546Contact: SJ Park <sj@kernel.org> 547Description: Writing 'Y' or 'N' to this file sets whether the filter is for 548 the memory of the 'type', or all except the 'type'. 549 550What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters/<F>/allow 551Date: Feb 2025 552Contact: SJ Park <sj@kernel.org> 553Description: Writing 'Y' or 'N' to this file sets whether to allow or reject 554 applying the scheme's action to the memory that satisfies the 555 'type' and the 'matching' of the directory. 556 557What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/ops_filters 558Date: Feb 2025 559Contact: SJ Park <sj@kernel.org> 560Description: Directory for DAMON operations set layer-handled DAMOS filters. 561 Files under this directory works same to those of 562 /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters 563 directory. 564 565What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/filters 566Date: Dec 2022 567Contact: SJ Park <sj@kernel.org> 568Description: Directory for DAMOS filters. Files under this directory works 569 same to those of 570 /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/{core,ops}_filters 571 directory. This is deprecated. Use the core_filters and 572 ops_filters instead. 573 574What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/nr_dests 575Date: Jul 2025 576Contact: SJ Park <sj@kernel.org> 577Description: Writing a number 'N' to this file creates the number of 578 directories for setting action destinations of the scheme named 579 '0' to 'N-1' under the dests/ directory. 580 581What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/<D>/id 582Date: Jul 2025 583Contact: SJ Park <sj@kernel.org> 584Description: Writing to and reading from this file sets and gets the id of 585 the DAMOS action destination. For DAMOS_MIGRATE_{HOT,COLD} 586 actions, the destination node's node id can be written and 587 read. 588 589What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/dests/<D>/weight 590Date: Jul 2025 591Contact: SJ Park <sj@kernel.org> 592Description: Writing to and reading from this file sets and gets the weight 593 of the DAMOS action destination to select as the destination of 594 each action among the destinations. 595 596What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_tried 597Date: Mar 2022 598Contact: SJ Park <sj@kernel.org> 599Description: Reading this file returns the number of regions that the action 600 of the scheme has tried to be applied. 601 602What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_tried 603Date: Mar 2022 604Contact: SJ Park <sj@kernel.org> 605Description: Reading this file returns the total size of regions that the 606 action of the scheme has tried to be applied in bytes. 607 608What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_applied 609Date: Mar 2022 610Contact: SJ Park <sj@kernel.org> 611Description: Reading this file returns the number of regions that the action 612 of the scheme has successfully applied. 613 614What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_applied 615Date: Mar 2022 616Contact: SJ Park <sj@kernel.org> 617Description: Reading this file returns the total size of regions that the 618 action of the scheme has successfully applied in bytes. 619 620What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/sz_ops_filter_passed 621Date: Dec 2024 622Contact: SJ Park <sj@kernel.org> 623Description: Reading this file returns the total size of memory that passed 624 DAMON operations layer-handled filters of the scheme in bytes. 625 626What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/qt_exceeds 627Date: Mar 2022 628Contact: SJ Park <sj@kernel.org> 629Description: Reading this file returns the number of the exceed events of 630 the scheme's quotas. 631 632What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/nr_snapshots 633Date: Dec 2025 634Contact: SJ Park <sj@kernel.org> 635Description: Reading this file returns the total number of DAMON snapshots 636 that the scheme has tried to be applied. 637 638What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/stats/max_nr_snapshots 639Date: Dec 2025 640Contact: SJ Park <sj@kernel.org> 641Description: Writing a number to this file sets the upper limit of 642 nr_snapshots that deactivates the scheme when the limit is 643 reached or exceeded. 644 645What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/total_bytes 646Date: Jul 2023 647Contact: SJ Park <sj@kernel.org> 648Description: Reading this file returns the total amount of memory that 649 corresponding DAMON-based Operation Scheme's action has tried 650 to be applied. 651 652What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/start 653Date: Oct 2022 654Contact: SJ Park <sj@kernel.org> 655Description: Reading this file returns the start address of a memory region 656 that corresponding DAMON-based Operation Scheme's action has 657 tried to be applied. 658 659What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/end 660Date: Oct 2022 661Contact: SJ Park <sj@kernel.org> 662Description: Reading this file returns the end address of a memory region 663 that corresponding DAMON-based Operation Scheme's action has 664 tried to be applied. 665 666What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/nr_accesses 667Date: Oct 2022 668Contact: SJ Park <sj@kernel.org> 669Description: Reading this file returns the 'nr_accesses' of a memory region 670 that corresponding DAMON-based Operation Scheme's action has 671 tried to be applied. 672 673What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/age 674Date: Oct 2022 675Contact: SJ Park <sj@kernel.org> 676Description: Reading this file returns the 'age' of a memory region that 677 corresponding DAMON-based Operation Scheme's action has tried 678 to be applied. 679 680What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/sz_filter_passed 681Date: Dec 2024 682Contact: SJ Park <sj@kernel.org> 683Description: Reading this file returns the size of the memory in the region 684 that passed DAMON operations layer-handled filters of the 685 scheme in bytes. 686 687What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/probes/ 688Date: May 2026 689Contact: SJ Park <sj@kernel.org> 690Description: Directory for DAMON data-attribute monitoring probes of the 691 region. 692 693What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/probes/<P>/hits 694Date: May 2026 695Contact: SJ Park <sj@kernel.org> 696Description: Reading this file returns the number of data-attribute 697 monitoring probe-hit positive samples of the region. 698