path: root/release_note

This file records important changes that made in each release.  Those are
picked by human sense, so could be incomplete and missing many things.

v2.3.4
- damo record: Set --profile and --footprint by default
- Cleanup documents and files

v2.3.3
- Support memory footprint recording for non-process and ongoing targets
- damo report wss: Do --collapse_targets by default
- damo record: Do --include_child_tasks by default

v2.3.2
- Support system memory footprints recording/reporting

v2.3.1
- Hotfix release for bugs that intorudced with v2.3.0

v2.3.0
- Implement 'damo report footprints'

v2.2.9
- Cleanup code

v2.2.8
- Support recording memory usage of monitoring target process

v2.2.7
- Support region box right-side aligning (--region_box_align) of 'damo show'
- Cleanup code

v2.2.6
- Cleanup code

v2.2.5
- Support damon/next tree feature, the DAMOS filter type for young pages
- Implement '--infer_version' of 'damo feature'

v2.2.4
- Implement 'damo report profile'
- Implement 'damo report times'
- Implement snapshot size based record filtering (--sz_snapshot)

v2.2.3
- Document 'replay' command
- Support profiling data record (--profile option of 'damo record')
- Add a prototype of access pattern-based profiling report generation

v2.2.2
- Implement 'replay' command
- Support damon/next tree feature, quota goal metric

v2.2.1
- Support damon/next tree feature, effective quota

v2.2.0
- Make 'damo show' faster on schemes apply interval supporting kernel

v2.1.9
- dbgfs: Use proc/mounts
- Rename --damon_interface to --damon_interface_DEPRECATED
- Support damon/next kernel change for DAMON debugfs deprecation
  (https://git.kernel.org/pub/scm/linux/kernel/git/sj/damon-hack.git/tree/todo?id=90812522ebb5#n9)

v2.1.8
- sysfs: Use proc/mounts
- sysfs/stage_kdamonds(): Be features detection independent

v2.1.7
- Cleanup code

v2.1.6
- Cleanup code

v2.1.5
- Hotfix of v2.1.4: Add missing _damo_print.py file.

v2.1.4
- 'damo show, damo report raw': Use a pager if the output is longer than the
  terminal

v2.1.3
- 'damo reclaim': Support 'skip_anon'
- Cleanup code and documents

v2.1.2
- Internal code cleanup

v2.1.1
- Internal code cleanup

v2.1.0
- Remove 'damo translate_damos'
- Internal code cleanup
- Make 'damo show' fail faster for some cases

v2.0.9
- Internal code cleanup

v2.0.8
- Support DAMOS quota goals (not mainlined DAMON feature)

v2.0.7
- 'damo status': Add an option for only entered inputs without updating sysfs
- 'damo fmt_json': Drop non-input fields

v2.0.6
- Optimize 'damo status --damos_stat' to update only needed metrics
- Implement an alternative of '--damos_stat', namely '--damos_stats'
- Remove '--damos_stat' option

v2.0.5
- Code cleanup
- damo show: Use DAMOS address filter if possible

v2.0.4
- Save/load kernel feature supports to/from $HOME/.damo.damon_feature_supports
- Cleanup feature supports handling

v2.0.3
- Let 'damo status --damos_stat' to work with debugfs interface
- Schemes test code cleanup
- Misc code cleanup

v2.0.2
- Remove DAMON results record binary file format handling code
- Schemes test code cleanup

v2.0.1
- Deprecate DAMON results record binary file format
- 'damo status': Support scheme statistic only output

v2.0.0
- Trivial fixes and cleanups

v1.9.9
- Update documents for online usage commands (start/tune/stop/show/status)

v1.9.8
- Support DAMOS apply interval (feature on damon/next only as of this release)
- Update documents

v1.9.7
- Reverse unnecessary support of DAMON's moving access rate
- Support DAMOS apply intrvals (feature on damon/next only as of this release)
- Support DAMOS recording (feature on damon/next only as of this release)

v1.9.6
- Remove '<age access_rate size> region format keyword
  - Should use only '<box>'
- Add '<region box description>' snapshot keyword
- Add '--region_box' option for shortcut of box-based representation
- Allow per-key reverse sorting of regions
- Minimul support of DAMON's moving access rate

v1.9.5
- Code cleanup

v1.9.4
- DAMON command line options: Support multiple DAMOS schemes
- damo show: Support log/linear scale of region box

v1.9.3
- Restore --ascii_color and --plot_ascii of 'damo report heat'
- damo show: Support coloring of region box
- damo show: Implement '<age heat bar>'
- damo show: Make region box to use logscale for columns and rows
- damo show: Support more region box customizations

v1.9.2
- Support DAMOS filters, quotas, and watermarks via command line
- Support target idx DAMOS filter
- Implement '<size heat bar>' and '<size heat age bar>' region format keyword
  for 'damo show' (likely be changed in future)

v1.9.1
- Remove 'damo stat'
- 'damo show' update
  - Support address range based filtering
  - Add snapshot format keyword for number of regions
  - Implement '<size bar>' region format keyword (subject to change in future)

v1.9.0
- Mark 'damo stat' as deprecated
- Use '--force' for 'perf script'
- Internal code cleanup

v1.8.9
- Support flexible formatting of 'damo show' output
- Implement access pattern based 'damo show' output sorting
- Support --tried_regions_of option of 'damo show'
- Cleanup _damon_resul.py

v1.8.8
- Support under-development schemes tried regions total bytes file
- Fix empty snapshot for vaddr ops issue
- Polish 'damo show' output format
- Support 'update_schemes_tried_bytes' DAMON sysfs command

v1.8.7
- Stop supporting non-mainlined DAMOS kernel implementations
- Rename 'damo show status' into 'damo status'
- Re-implement 'damo show': Support snapshot and record files, but still not
  stabilized

v1.8.6
- Cleanup code

v1.8.5
- Add a not yet stabilized version of 'damo show'

v1.8.4
- Remove Python2 support
- Cleanup code

v1.8.3
- Remove '--rbuf' and kernel-direct record file generation support code
- More documentation of deprecated features
- Implement '--include_childs' option for 'damo record'
- Move single line DAMOS schemes input handling to a new module,
  _damo_deprecated

v1.8.2
- Support zlib-compressed json format monitoring record file
- Use zlib-compressed json format monitoring record file format by default