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/