From nobody Wed Feb 11 22:53:23 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7466517BB0E; Tue, 18 Jun 2024 21:36:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1718746595; cv=none; b=WrqIT+IFePlv365+lZxwUBsJBPeSyf9HKXywo0usZUBaNeBm7o6wzs4eJ6W5L1bfFbTobPx9Ddi69ZWs8pmg+KXnxc/NMhpnZltuINAp5JaiLnNfFZxofV+z3Z7Pi3JOfzR8rjxUcGGE/V5n9C23IRuHy0eY/fN2TnjEAioxekQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1718746595; c=relaxed/simple; bh=RoniSjozDPpNLveGjBTMTaM+FpRJleaCmjKB3DAhfkQ=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version:Content-Type; b=Em8hQhIHNmfSz2LukbhGceBq6KiO1z0IOBCjgo1kqULCIJu+XdJBfr+ghjBYlbp2yMPKZ0Ee9mA8QxjpWUijpqjzMhkuwNEhfBuEuGjMlxqrZ28ZIgrBCPBrdJaeCmfqG7lm6d+bbubs5f9t1OXicij7mAApUIGFs1IAv9PeBuo= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=p34/6GwW; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="p34/6GwW" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 6171DC32786; Tue, 18 Jun 2024 21:36:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1718746595; bh=RoniSjozDPpNLveGjBTMTaM+FpRJleaCmjKB3DAhfkQ=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=p34/6GwW02jnbVIkrWglFEBNA9oU35st/HdIpDUnsqKFAXtyVsobAiE3BWWnCTanb 9iwKlSYarqymTcntkYuSH5YzXhvFJZIxj1dzbfyTz8ZbAOXm2w5rdlqgwC76BXa2CS tR5S2UPM2zHjMqXuslXQPkV7//M7DC1UkOdatIZ92iCVLEaJLaen5WJWkViEdyqo8y FAqaZYqHyMGmb6BazBvENRcRMEfC9O2oix4j6wKL8LJbQA0j30mdFhP3AU+qogU7i/ pFyjljmz9dx5qbP5Hu3O80EN49resxDpV1j1bIyrUaPMyCAWTdqdTllUmUqlxrcorU /k7tYkmjWS0TQ== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , Honggyu Kim , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/2] Docs/admin-guide/damon/usage: trivial fixups for DAMOS_MIGRATE_{HOT,COLD} documetnation Date: Tue, 18 Jun 2024 14:36:29 -0700 Message-Id: <20240618213630.84846-2-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240618213630.84846-1-sj@kernel.org> References: <20240618213630.84846-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Fixup below three trivial issues in DAMOS_MIGRATE_{HOT,COLD} usage documentation[1,2]. 1. Add target_nid on sysfs files hierarchy 2. Fix scheme directory section to mention target_nid file 3. Explain target_nid before apply_interval_us Fixes: c100fc71858a ("Docs/damon: document damos_migrate_{hot,cold}") # mm-= unstable [1] Link: https://lore.kernel.org/20240614030010.751-8-honggyu.kim@sk.com # [2] Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/a= dmin-guide/mm/damon/usage.rst index 98804e34448b..26df6cfa4441 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -78,7 +78,7 @@ comma (","). =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 = =E2=94=82 ... =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 ... =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 :ref:`schemes `/nr_schemes - =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 :ref:`0 `/action,apply_interval_us + =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 :ref:`0 `/action,target_nid,apply_interval_us =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 = :ref:`access_pattern `/ =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 = =E2=94=82 sz/min,max =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 =E2=94=82 = =E2=94=82 nr_accesses/min,max @@ -289,21 +289,21 @@ schemes// ------------ =20 In each scheme directory, five directories (``access_pattern``, ``quotas``, -``watermarks``, ``filters``, ``stats``, and ``tried_regions``) and two fil= es -(``action`` and ``apply_interval``) exist. +``watermarks``, ``filters``, ``stats``, and ``tried_regions``) and three f= iles +(``action``, ``target_nid`` and ``apply_interval``) exist. =20 The ``action`` file is for setting and getting the scheme's :ref:`action `. The keywords that can be written to and read from the file and their meaning are same to those of the list on :ref:`design doc `. =20 -The ``apply_interval_us`` file is for setting and getting the scheme's -:ref:`apply_interval ` in microseconds. - The ``target_nid`` file is for setting the migration target node, which is only meaningful when the ``action`` is either ``migrate_hot`` or ``migrate_cold``. =20 +The ``apply_interval_us`` file is for setting and getting the scheme's +:ref:`apply_interval ` in microseconds. + .. _sysfs_access_pattern: =20 schemes//access_pattern/ --=20 2.39.2 From nobody Wed Feb 11 22:53:23 2026 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C0C8717E46A; Tue, 18 Jun 2024 21:36:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1718746595; cv=none; b=r8iiSwJACjGuiMXkpO2XGmYtV6O3ZAScH8oAEL9kWE/eNHWvZO/u90Bhs7IFg+A3K/qSgrNBJqcJD4lifix1zPnlMYPnGT4cKkzfdrLFy7z75GtjssaIGD6Nyv77bT2TF3KAE0DhvEOo92i4nKKj4hLjdqUbkY+VtBFqzONVM+I= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1718746595; c=relaxed/simple; bh=QdAgvz/eRFgxbWjUE+6h9i06/YLLhBFGTN2aDiUR8OI=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=Qq1B8Dw+DNor+Lvg7YALgSX/WOPi1aH8wrgBMqi91xDNsqEc0BcPsHKP9/Bflq+0lxCjgJWEVEFqTm/L3eIcCZ6CANli+RS2UYPJ33w7O0LcfOLC6y/6T+JlRYZuOI3T6vVXhTSl18PN06TsojUU9P0XbdSTAXfE9M6mqZSOqOs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=VjvXziCt; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="VjvXziCt" Received: by smtp.kernel.org (Postfix) with ESMTPSA id 396E9C4AF53; Tue, 18 Jun 2024 21:36:35 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1718746595; bh=QdAgvz/eRFgxbWjUE+6h9i06/YLLhBFGTN2aDiUR8OI=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=VjvXziCtoMIheG1gqO2FDGiBd/Ryq4bLZy4eL1bflr6mBUjdb7pfyhrxK6vADKrru TJlxPkaziIoxsFJP+Ig0ZBuL+2ZtbbCX1WFETMaoF+TE+cQ5lW70XjNDmzMc49HZwe JAQ2lS8w7NwGfeYBwGiUW88ouEavyX/WUrkn88UWzt20zeNM23UoQzjso7Z54BSVq5 IwbIthcaDi9P272x0+e2WpZHZ1Y0Pk7y/PzHHXrZVGlnOhSO0+vsUCR3SpudDewQoW 59/ReIQjigqq5uC2494TpVKfap+w+7V8XqJlw2I9M1O9FvlUQguATKMCylpGI9+1wL I1LX6eTlW/+AQ== From: SeongJae Park To: Andrew Morton , SeongJae Park Cc: Honggyu Kim , damon@lists.linux.dev, linux-mm@kvack.org, linux-kernel@vger.kernel.org Subject: [PATCH 2/2] Docs/ABI/damon: document target_nid file Date: Tue, 18 Jun 2024 14:36:30 -0700 Message-Id: <20240618213630.84846-3-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240618213630.84846-1-sj@kernel.org> References: <20240618213630.84846-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Document target_nid DAMON sysfs file that introduced for DAMOS_MIGRATE_{HOT,COLD}. Signed-off-by: SeongJae Park --- Documentation/ABI/testing/sysfs-kernel-mm-damon | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentatio= n/ABI/testing/sysfs-kernel-mm-damon index cef6e1d20b18..f1b90cf1249b 100644 --- a/Documentation/ABI/testing/sysfs-kernel-mm-damon +++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon @@ -155,6 +155,12 @@ Contact: SeongJae Park Description: Writing to and reading from this file sets and gets the action of the scheme. =20 +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//ta= rget_nid +Date: Jun 2024 +Contact: SeongJae Park +Description: Action's target NUMA node id. Supported by only relevant + actions. + What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//ap= ply_interval_us Date: Sep 2023 Contact: SeongJae Park --=20 2.39.2