Re: [PATCH 2/3] docs/mm/damon/design: difference between watermarks and nr_snapshots

On Tue, 11 Aug 2026 18:18:40 +0800 Liew Rui Yan <[email protected]> wrote:

> Explain the difference between nr_snapshots reaches max_nr_snapshots and
> watermarks.
> 
> Signed-off-by: Liew Rui Yan <[email protected]>
> ---
>  Documentation/mm/damon/design.rst | 3 ++-
>  1 file changed, 2 insertions(+), 1 deletion(-)
> 
> diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst
> index 939298f2a9b9..1fcf0b8c044b 100644
> --- a/Documentation/mm/damon/design.rst
> +++ b/Documentation/mm/damon/design.rst
> @@ -872,7 +872,8 @@ the action to the region will fail.
>  
>  Unlike normal stats, ``max_nr_snapshots`` is set by users.  If it is set as
>  non-zero and ``nr_snapshots`` be same to or greater than ``nr_snapshots``, the
> -scheme is deactivated.
> +scheme is deactivated. Note that, unlike watermarks, even if a scheme's

Let's use two spaces between sentences, like other pargraphs in this file.

> +``nr_snapshots`` reaches ``max_nr_snapshots``, monitoring will not stop.
>  
>  To know how user-space can read the stats via :ref:`DAMON sysfs interface
>  <sysfs_interface>`, refer to :ref:s`stats <sysfs_stats>` part of the
> -- 
> 2.55.0


Thanks,
SJ