From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pf1-f169.google.com (mail-pf1-f169.google.com [209.85.210.169]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7D644402B8C for ; Wed, 12 Aug 2026 10:04:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.169 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786529094; cv=none; b=XG073bTE2feYvaWpHc4EEnLwIbAu7aPFfnSPSfl7v+dwUteTGfHjnQBMIBvSZR+6qNUyl0wt+cv2vjzzApXpeqKdncZXdf4JhxrMUMhxNSN7GOgOtnK77TcUBUf2WHjvQnQnhgSAuCD3igXPvQOQunVbd/QLmG7cryUdG4UpDiM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1786529094; c=relaxed/simple; bh=FgV0EIRlXS2pNv/yLefwn1IDpSp+NZbkwedGH5rjvzA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=tVmRGRFBxZVWGcMzP3mu9hanGsi1QmD2UxYNEdu6MH26YuV/9M2PmHF8x/yYe7cTvV9rY2D4v4TulMOFn6YpIxRqI0yot+YAr0yBDjbrMlkX+oreNWoOAwFtNhraLnx3+vDjuigdwG3shpNseQh4X7557BZ5EzCSqYA618HLJ+8= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=BlFbs+aj; arc=none smtp.client-ip=209.85.210.169 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="BlFbs+aj" Received: by mail-pf1-f169.google.com with SMTP id d2e1a72fcca58-84eb992a881so653767b3a.2 for ; Wed, 12 Aug 2026 03:04:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1786529093; x=1787133893; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to:content-type; bh=JxZo8B7n4c14lfP0ZG1amHyFP5yaEQUN0LvXnBt5yBg=; b=BlFbs+ajbfDxVSy8XDqUOZTror6FP/RY+YB4scEP8UHoi5QMQOzdBj5z/x230anfg5 nE+7DP8jbbhVBizsu/n8fGK7BssT+WNErO/TPPpruGEIy0nwt/JFBi8b0QVNUkIzm7Pc 7L/meSZdIZJzoi9t83LLhKjRdemEJAlTU70Q9xXXn+aLJCv8+xqmw+UHFwQGKir2vp/n 9KP5YRlFsMBwWWleEeKqatCAnLRBL04E7vv1u10jIdgIeblckObuE89HCevldgZIHYWT thWRnlVofBkprrcb22/bA/XPg6f3RUVgbGCEozOybM2RHps9BN6HmIozZe96CBktnthV qeRA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1786529093; x=1787133893; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to:content-type; bh=JxZo8B7n4c14lfP0ZG1amHyFP5yaEQUN0LvXnBt5yBg=; b=DjEfP8l6saUCC2EKnRieh3yva9u4GT2lCmM/vuvciei9ozFy4ZB9v7NdsMcOk7ibbO A5hG7GggYOWaoqyfRZaELgsEjYHZ5Fg5QW+fAluXdOTCPqda8m+Nv1lITmmMh1eH9B0E DIFsc0WXCuBtVjB2cN6Jf3KtuAopV3Svz2Nt3PEAafuewj+G1gw77DmLBlxiAaax7utY Jt9BK7lbnqxUcvwGzIr3+sypbg1yzyne7LJ2pTWE5W0cM0FgjJ8OhCWAysdX4m5aH9Fu Op8tIwHK1PasI4SMeko+SfKshhOE79lweXNePa8p2vNybk+CHa6ddVfNNoumxrz3DkZA T3Ug== X-Forwarded-Encrypted: i=1; AHgh+RoUv16Lr9AJuucmFThoS8Qj0ezVj3M1U4HFckWStjQxn3LC8ALEBfhJzGehCArZ/fFTSCMRCLCwUdGK7l0=@vger.kernel.org X-Gm-Message-State: AOJu0YyBPMMVwzkX+YvKKjaArXrjv2NEAQYj2wuIioitvNL8Y/O8p0Ha ARuh0z6PsdxY0URtlvqLuMVjw5lemSPKiwO3SvVMLqAKzcLjIsIDvl1n X-Gm-Gg: AR+sD12XbGSJNhKULu+aJbd0FUxQYA2sZYEkqmAFca3WI7tfLPg68rgFkAMrKrPk8s6 nrBX40u5jGFWEq92fTHGOHlPbvsl4CLfyaqwIMKPY5ZSRuwv8iVNRrDqHWHCt5tuAkeK8/pfG4A S6dJAN7WLww6oZ5NN0VPNYYR0gDK725EXW4GuF4YcA1C5Ww2W47HLITu+05GxTSbTVAKuAQORoV dLnAPxwG8tXIsXoFqqBntqYdaqCVUsKQiSAYIiZ1XAmM7s2e5P0xwvSHxWbRLdMyApRTKf5ItZ3 IEZXu8ekjUAILxLFXxuJI5EDlEZJhTuEQXfhxvoC6N4R05b/aTk0lKCUSo5FtIubWs8h/i/FSnY 8xfAaI39KHBnIUn1m0a5Ht3C2SQQ4gUzeM1E6h0j9LLHSZ3csibOAf2x/CbbrZp9Nwhc0EVrIEO Wmmzpkti1fKdJjvGuQ8sCUG4wQT8M/ModGTBAp4OnwOr55EuJ0lC8UV8ABth48L+/0YlhZjrYU7 HwEhRZVAdmf4GI= X-Received: by 2002:a05:6a21:4d07:b0:3c3:a20f:f729 with SMTP id adf61e73a8af0-3cc3f51e8camr4663363637.7.1786529092842; Wed, 12 Aug 2026 03:04:52 -0700 (PDT) Received: from celestia.taila51cc2.ts.net ([2402:1980:85a:5c46:85a5:ec7:8aa8:72be]) by smtp.gmail.com with ESMTPSA id a92af1059eb24-14124454d3csm8821247c88.2.2026.08.12.03.04.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 12 Aug 2026 03:04:52 -0700 (PDT) From: Liew Rui Yan To: SJ Park Cc: Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R . Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Jonathan Corbet , Shuah Khan , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Liew Rui Yan Subject: [PATCH 2/3] docs/mm/damon/design: difference between watermarks and nr_snapshots Date: Wed, 12 Aug 2026 18:04:32 +0800 Message-ID: <20260812100433.6288-3-aethernet65535@gmail.com> X-Mailer: git-send-email 2.55.0 In-Reply-To: <20260812100433.6288-1-aethernet65535@gmail.com> References: <20260812100433.6288-1-aethernet65535@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Explain the difference between nr_snapshots reaches max_nr_snapshots and watermarks. Signed-off-by: Liew Rui Yan --- 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 +``nr_snapshots`` reaches ``max_nr_snapshots``, monitoring will not stop. To know how user-space can read the stats via :ref:`DAMON sysfs interface `, refer to :ref:s`stats ` part of the -- 2.55.0