From patchwork Tue Jun 18 21:36:29 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13703076 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id CBF01C2BA1A for ; Tue, 18 Jun 2024 21:36:43 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 9E9FC8D0068; Tue, 18 Jun 2024 17:36:41 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 9707E8D0066; Tue, 18 Jun 2024 17:36:41 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 79C948D0068; Tue, 18 Jun 2024 17:36:41 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id 507F08D0066 for ; Tue, 18 Jun 2024 17:36:41 -0400 (EDT) Received: from smtpin09.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 11321A0B93 for ; Tue, 18 Jun 2024 21:36:41 +0000 (UTC) X-FDA: 82245319002.09.08AC117 Received: from sin.source.kernel.org (sin.source.kernel.org [145.40.73.55]) by imf15.hostedemail.com (Postfix) with ESMTP id B8BBFA0004 for ; Tue, 18 Jun 2024 21:36:38 +0000 (UTC) Authentication-Results: imf15.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b="p34/6GwW"; spf=pass (imf15.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1718746592; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=YWoxftUvnCcYe11wx3Oy1Ly8m+ngQKDCy+zv54ZzY2E=; b=GrGx2honiymJIKeHE3ERDFDGQT8neVdENkilz+ILNsuEkSvxeaofTedOiS7qrfi+DyjGYd f+2PD0IefP2ZfRsX+7G8bwk8+QUtkvhs16TnS+LK1RivP4FqskeVMnGgCJqyeyHOLcI+XJ VVlxpT2Rqz83rXEOGbGw/ll0brDdTN0= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1718746592; a=rsa-sha256; cv=none; b=AAiKP3fmJYnxKUwjhN81nCFc0X1siu1C+CBeK7INXKZb7uuaMjNttU6SBOcvvE43iWTKUg Z+Ka2X54pz53gS1OxLWfrIq/2LM+YW1bQx6A3vNo4fA1ZA/DXsS1yxIdV+rIQ5j63i5VHm fiI1aeySvWu9Ri/2qnTtljnBN0npQOw= ARC-Authentication-Results: i=1; imf15.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b="p34/6GwW"; spf=pass (imf15.hostedemail.com: domain of sj@kernel.org designates 145.40.73.55 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by sin.source.kernel.org (Postfix) with ESMTP id C5B40CE1CAB; Tue, 18 Jun 2024 21:36:35 +0000 (UTC) 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> MIME-Version: 1.0 X-Rspamd-Queue-Id: B8BBFA0004 X-Stat-Signature: uok8r98xy9nqq763tkopab5nq7583ire X-Rspamd-Server: rspam09 X-Rspam-User: X-HE-Tag: 1718746598-411246 X-HE-Meta: U2FsdGVkX190IxhTCt76efg9bBX/8fENlOlwHgwRos+EBAYpH49mIQVHTRmpZePyFBhDgAKFVlDviJZ6uhBwU1TWs4E6uZ37Mfa6XMBTHgWupnACQAOtnqJcJUQfvAGihaclteWITFxZiejQHUxQf3mAo5Jrp+qLKi+ruztZpJC6oAmTuVYHZJaimYEY3vQjSejtz1+krlqpAME8kk7yVNfQ3xgs8yb+T1sMMlg4mWlR2ar80TV0MfM1ORG07bbhHiGx7f+qbZKnjvDORNAt8X6gSOyKiHeZgxhOrmJ5Sw4b7yx448OugWKIbcxLhQ7Ebte8BpFyUFCY0NLAlMZ6LNQIlwYT7cxvzMybb7F7PBLB+ovj+hbvp99DiTQspEjm11E/qHmFjc1X7Bvj3fPlJPgpYqF+m8jbSxwNGkcY6ebTvp4ZGnwVNaU57IHENyK1viAzn8iJDsEHKtYlDnTifBSSIT0UbEzZjAAjoEjKW6bTRkzf2ggVYSYgvnyZ35d/CFlRhBAjDpKtShPx7QeIv1neKud+KAl9T3lSnKaNmGvGBQ4iCz1eOx4MT1gw73Ow3qmzJEC3weAD8bosHrdkbKXGORUj4yu3tyxjMgY1O2j0d9GzG8kxUNXBPlEiCaNTmItAYSlUN5xgweu+66rRAnyu8hV6B+YFBxcfRUEf5sYwvsIpLZPmIDXj+HZtj7qtTWgpdm4LtdZLlpt4rkFcUnrv65hpFIF2vR6I9SNX9zCIWdVSJfRIeburSNO4I8OQZHNK6mBMz6TsOktGWEnGLSZ8QAv6UQWZcI1Nn14mmEIsQLpeaHHk8IcpnYN14uSVyxkxW4pwaotva+z9HhBqWHjuSVdYKT0hyHteW7TsXAhw4gE1imF07T/h7lMpHUQ7UVg5O+BEgvIm7j4gVCeC1JC1OKYQrGUTfCWkLP0z8g4/1Odcyx1STgPARbPT0eeL1pnKFdvq+TVtcJpT5ys rjMD7UJ9 1QYtuHBOEH/RGvSvoN1lc8HOSTGgy3pvjyWOIvWqgi/rwcUfbrdkHQ7joyshDIoFj5v3La3oyfZsFWApyCfMoBmoEJlTs9zbDj0zlH3p+ePuoPQtQ9QoEWmT4UYmtyhapAUUeDSfTop/UekvR108tKlPVnWT3JKLoA3iF6Vzy+/xWENp88E3gNPmBWRK1qWQlvM95vWGhf+e6kWgdov5S2zthcBBjcHCOLRoI3QOwgt4BplKyxl+umG0bQHYOv6fqmTTcoqQMoaMcwhXmzMYYCYwNEwgOHlwYZ+SazXH9UxG0s3h5+CzHhoGd00ptilMOuLz+0me1JZIz9grqp1d1HsxaKaHiPNnQcrEU8tPjo4MZQaVmzmECpybX2A== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000281, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: 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/admin-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 (","). │ │ │ │ │ │ │ │ ... │ │ │ │ │ │ ... │ │ │ │ │ :ref:`schemes `/nr_schemes - │ │ │ │ │ │ :ref:`0 `/action,apply_interval_us + │ │ │ │ │ │ :ref:`0 `/action,target_nid,apply_interval_us │ │ │ │ │ │ │ :ref:`access_pattern `/ │ │ │ │ │ │ │ │ sz/min,max │ │ │ │ │ │ │ │ nr_accesses/min,max @@ -289,21 +289,21 @@ schemes// ------------ In each scheme directory, five directories (``access_pattern``, ``quotas``, -``watermarks``, ``filters``, ``stats``, and ``tried_regions``) and two files -(``action`` and ``apply_interval``) exist. +``watermarks``, ``filters``, ``stats``, and ``tried_regions``) and three files +(``action``, ``target_nid`` and ``apply_interval``) exist. 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 `. -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``. +The ``apply_interval_us`` file is for setting and getting the scheme's +:ref:`apply_interval ` in microseconds. + .. _sysfs_access_pattern: schemes//access_pattern/ From patchwork Tue Jun 18 21:36:30 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13703074 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 1565CC2BA15 for ; Tue, 18 Jun 2024 21:36:41 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 888348D0067; Tue, 18 Jun 2024 17:36:40 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 836FA8D0066; Tue, 18 Jun 2024 17:36:40 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 6FF9D8D0067; Tue, 18 Jun 2024 17:36:40 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0010.hostedemail.com [216.40.44.10]) by kanga.kvack.org (Postfix) with ESMTP id 525CE8D005C for ; Tue, 18 Jun 2024 17:36:40 -0400 (EDT) Received: from smtpin07.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay08.hostedemail.com (Postfix) with ESMTP id E870C140AE8 for ; Tue, 18 Jun 2024 21:36:39 +0000 (UTC) X-FDA: 82245318918.07.652D6E0 Received: from dfw.source.kernel.org (dfw.source.kernel.org [139.178.84.217]) by imf21.hostedemail.com (Postfix) with ESMTP id CF2921C0013 for ; Tue, 18 Jun 2024 21:36:36 +0000 (UTC) Authentication-Results: imf21.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=VjvXziCt; spf=pass (imf21.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1718746589; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=IfAqNI7Rlhh5xfdCPOCNGJ/34Q8IDTQxl8CylpNqvkI=; b=j8KqcDJ13wz5ajTYoPrbFMiEV3++ui7L/r2Rr3GAk/ax+wMdiyoM49v43IpOx4Zom7q+Iu go9yke4yS4l2Fj/6Nmh4O1O2yFHzkVEAioIhUIzWR4BZg2aZbMxBYfJkyZOXk7BGs4FQpf D+Wf2u0kPO4r1Qe5Rytd/2m5sdv4beQ= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1718746589; a=rsa-sha256; cv=none; b=GmU2a79Y1ONc9jTA/cyH/jTZ1m17BDu0cUzYQ310rlJ663Q3ev2FxseI8LJ4Voeu6CtXZN m0/p2wdp+pdfHi+FD0yNP3ITNa8Eo3r7EtNKChmCYzSVUjVXhvg/t8kJi9wAfprxdFp382 LVPyCTEAtlw8UyHGrEKL0HIKsCYg0sg= ARC-Authentication-Results: i=1; imf21.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=VjvXziCt; spf=pass (imf21.hostedemail.com: domain of sj@kernel.org designates 139.178.84.217 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by dfw.source.kernel.org (Postfix) with ESMTP id CC59761B7C; Tue, 18 Jun 2024 21:36:35 +0000 (UTC) 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> MIME-Version: 1.0 X-Rspam-User: X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: CF2921C0013 X-Stat-Signature: yrujdedyk97ypp6zwchzwz4yitkf3bjg X-HE-Tag: 1718746596-746620 X-HE-Meta: U2FsdGVkX18LPmTTmzF6vL9wMy9prRcuTYfvTMoMdP2XCiF4KK0ZwWSaAgp2GqNy3p4QXK8seh1eYcxjqaMFhbRtEZLTfk+M7XcYZ21bxQi+HZCXWznhEoo3LatoUHzWxaAagfj2O3V5XNdT01qT36w1iXpUXHSTMjwIqordbHcTn9EyCcIp+wQWDmC1KDaRFz9R/uc1Wow7Tmo+jmlxal9+MPNbq/Slx3pp1JeluaRW43cWW7NTugYhDyfmmM9IUrBfV5WfxLGhKOvkiMRkv7+R2p8IPqtqHEn8LQdxL/EFNjzJb+5E2RI7NoDA1L56LguhWkc5evoBV9qiXGcqDGBJLONdzLfKSNMa0riw0JoNrYXL0wuZfj910ghOA34YUmQn1/pT0+GyXjKAoE+SyyeZ+UePEFCcajovIdoBC1XwcO3jDvt4lZuo51Uq5gN9y22/6/uy1jKvO3tx4Nc4q2hryjW8M53fFAx3Xh5awt6/eZAHbsUdFwRGrsrRlLhtOxX11hxQsdo17XkHUXuwpD+/Uw28HoymLHrCUqdF+36ZST+0UsysOCqev/szY/9E/6d31804tCbesjUP6VUBF8WUUyJkA5G98uHoeU8vSe+oC5rjfVNt1a3bvcmngKm65LszQ39GhogdiYEBS3HvKkM1E04b5tDkvdvYZepKyJQndnBdV7O6NsW7HbDySsTwDObebqA1YpPyZ9V5vv3X2IgvhFanZnJu2JQQTMqAvuRGuKhHQ/ThE5gJRDeiAEBKVfcR75xlm9iSu+d1T2ifXuUVfbyP7GLebPkvUAGQDB7j+s2xLf+Ut3pewNjvcEAlkMEifSCrOWk4d+VQUlj3TfLAzjCvKbwZVO8BCb+6GWlRXIwxZDkI+54U0Wj46hMc29BOl24cjOLVEuv6yz75nPguGXCLDS+wl/LncyNfU6noYQfHL6kUXAYCCkvB4nKFHgKwlbUOfmt2/3jvA2j mPtZ2Njm Yz2QGxs2dY3OAgX7YyTj71gyiNtyClfIGu43i8NaXGXJyE2xEKIqcvWIHvMyQh+m8+4JfpSSxFwGfzYnbbHjAELZliX1lxL3BcXDZ2wL/A65YTuniICPst/D59aP/HBv+iT5YHyi4qh1pgxAckENgqbqCMxKZU34ulggJ6Y2eVNJm2G44WV7w/svMTk21S3TtUGf6KX22L/TZWOPpqkWw39RWFwNghF8dxZM3Ovvky+nr+9rZEdUeKDDvrhpMHmpU62jYo7HVCWmVSxJtqhsx2SbueSrtGwIvNf5RVtsv4dRs11aMVF607Yb1YnwSmayOA6x71Y8o4bk6ADl0svj0YiePPA== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000001, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: 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/Documentation/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. +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//target_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//apply_interval_us Date: Sep 2023 Contact: SeongJae Park