From mboxrd@z Thu Jan 1 00:00:00 1970 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 97A3CC77B7C for ; Wed, 2 Jul 2025 20:14:35 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 372928D0003; Wed, 2 Jul 2025 16:14:35 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 324058D0001; Wed, 2 Jul 2025 16:14:35 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 1EA8D8D0003; Wed, 2 Jul 2025 16:14:35 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id 067498D0001 for ; Wed, 2 Jul 2025 16:14:35 -0400 (EDT) Received: from smtpin10.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay06.hostedemail.com (Postfix) with ESMTP id CB91D106976 for ; Wed, 2 Jul 2025 20:14:34 +0000 (UTC) X-FDA: 83620427268.10.D320C3D Received: from mail-yw1-f176.google.com (mail-yw1-f176.google.com [209.85.128.176]) by imf29.hostedemail.com (Postfix) with ESMTP id DA409120008 for ; Wed, 2 Jul 2025 20:14:32 +0000 (UTC) Authentication-Results: imf29.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=P7zAtkl2; spf=pass (imf29.hostedemail.com: domain of bijan311@gmail.com designates 209.85.128.176 as permitted sender) smtp.mailfrom=bijan311@gmail.com; dmarc=pass (policy=none) header.from=gmail.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1751487272; 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=whp07KqijnEckNg3QoMixvcYpADgEZZkHKJXbQWF63Q=; b=b6irSgPPE90MQ/4mW1HYspCG6kAaFXa1pTEh7o1xbG0GfvswCwi4A3s+9YnwpGhSks6Q+Q 2BewdXmXOWvRliw8kfJ/1hXKrXTGqNFlOxAfjiHS4OfNBnJzzC4iPSR48Xv0khb0vjv7M5 a7Xo1MehrNofq+gQHDDe4R97UC7tEfI= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1751487272; a=rsa-sha256; cv=none; b=CzidwpBMdFbJIdF6FBsT0JGIdKjNHZwegPFHCRt/F1doo6aJUfaF6VX09V4oCkzsemq4FN S+iHBWPZjPeyVlVFUcdN5QMzXNNJvBmXAycnJf5a5R5sM1EvOcFoGc23sbey2bwG13K0+s Bu2lHAqUanZfEUOZzNycKTqXDsZGN60= ARC-Authentication-Results: i=1; imf29.hostedemail.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=P7zAtkl2; spf=pass (imf29.hostedemail.com: domain of bijan311@gmail.com designates 209.85.128.176 as permitted sender) smtp.mailfrom=bijan311@gmail.com; dmarc=pass (policy=none) header.from=gmail.com Received: by mail-yw1-f176.google.com with SMTP id 00721157ae682-714078015edso53071377b3.2 for ; Wed, 02 Jul 2025 13:14:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1751487272; x=1752092072; darn=kvack.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; bh=whp07KqijnEckNg3QoMixvcYpADgEZZkHKJXbQWF63Q=; b=P7zAtkl2dzzvSkdT0HJI1b/sATCy+jEqu+7pxDvnV31SRCdXMlN2otHZikf7lz4Vez SnbNHqTohFhC/H2jZFKkIuI2l4FMcOEYrZTXZskm7rNh5PE6zdFhz7vw1KA0CQO7hE2T eWclH5kWJnqYZJuu/WjBWUA6rh79KKrCkVPS1NgDI+jpblUOJDWc600dUA1yOQ2vgAFl nRfiagciN0VStVWdmcbpeM/nBFmtG25SOztWrLGBuH+3gZaKeR3AtZeHgdb47nbvllTL bHmxnc9cIIgIDFrKlyi9oX6MtIY1z5QUhoy10n9o+hHZ5VB/zBas2V/4n1kzR4yFcDvd /weA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1751487272; x=1752092072; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=whp07KqijnEckNg3QoMixvcYpADgEZZkHKJXbQWF63Q=; b=q1SAH2pE6ly8hfH9i23MxlvvU8xR5b5dbS03WWIY+SGp8+ib5FmmVwfAnmi8hYyJ1j tVuAl93nHrvTKjZHG7Xxb6g6R0mVe1aYs0ZfYkVj5T7Hzbqowwlp2W5p1IIPl2s8B4BS aD5vT9MNyCfadfq5JFbVKbQCx+6MHVWFmhmYKBdyJw7Bo7GDz8r50P2+M1seu+nlCcmm J+sdv1QXn/hPW4Xw34+S/njmuBvjGNq69PLoBS67kN8OIXbMjnMM4Z8OgANbAlw6/5Re MBD51kG3QeSue9okmBLgfuoWFDLJyE5l3s6RSneZ26Cv/q+5uYBvOqsAQQqNYrDUIkUW 0Wew== X-Forwarded-Encrypted: i=1; AJvYcCXLjFsGb+3YSNTrBOyihV/e2C9G9T+bwv/g4NFYp0vXNPHKEZcTwyxzCQJjmMaMgscwj1xyyHepvw==@kvack.org X-Gm-Message-State: AOJu0Ywd4cKsihTv3I5KXCg06im7KAf47gtM/XO+3Se4xiDvj3oBythW u/zc1qNQBFNNSmKMFOyWpaxcBJfxVP9lAQkvwnxWe50Yf0AcvyMMOtmI X-Gm-Gg: ASbGncu+kUl6FDNkNROOzXE+x+8qkJecbVjFC9ukRqsgoTIzVxMIc3T1lSpOlrhhBxR +FdzWWVosfzdIuDrQIQ05votWiVnt0CyOZqO5+EMwa2vBEGIgGBH+EoCVwWrR3e/6SWohbATMJ5 4TsunLHggtonc3KYNyqRs83IuPug5MHrpPoRiVzOPmLEVkbqE6CxG/cES92bZGpQYTK6KeO+ZZt x3ip2JqKxw0v1YB0AYehkjXoD4YWfPdPuHp1gtflduWCUOv6RG8hqnSW/pantRmTqmydEyxPVKR e+dFFCBxZz4dpaEeOLHSrMAwFUAsf6m5hZwd/S8mjqwRLl4jJZeBdMkXQ09kvrWYzA049CTc394 7adtGjoqXPvenUQWsgg== X-Google-Smtp-Source: AGHT+IGTS3C4MNCq+aw22xTnq01sw8nUASYU0w+f4Bsq2yNG7missxlZkISVB8+vcdsLs6QkRmv8xA== X-Received: by 2002:a05:690c:6308:b0:711:41a5:482a with SMTP id 00721157ae682-7164d46a2d2mr64613437b3.27.1751487271759; Wed, 02 Jul 2025 13:14:31 -0700 (PDT) Received: from bijan-laptop.attlocal.net ([2600:1700:680e:c000:873e:8f35:7cd8:3fe3]) by smtp.gmail.com with ESMTPSA id 00721157ae682-71515cb4347sm26124157b3.83.2025.07.02.13.14.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 02 Jul 2025 13:14:31 -0700 (PDT) From: Bijan Tabatabai To: damon@lists.linux.dev, linux-mm@kvack.org, linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org Cc: sj@kernel.org, akpm@linux-foundation.org, corbet@lwn.net, joshua.hahnjy@gmail.com, bijantabatab@micron.com, venkataravis@micron.com, emirakhur@micron.com, ajayjoshi@micron.com, vtavarespetr@micron.com Subject: [RFC PATCH v3 06/13] Docs/admin-guide/mm/damon/usage: document dests directory Date: Wed, 2 Jul 2025 15:13:29 -0500 Message-ID: <20250702201337.5780-7-bijan311@gmail.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250702201337.5780-1-bijan311@gmail.com> References: <20250702201337.5780-1-bijan311@gmail.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam03 X-Rspamd-Queue-Id: DA409120008 X-Stat-Signature: x6wrtwme9njof8aa19ytuydt3tabynpt X-Rspam-User: X-HE-Tag: 1751487272-524297 X-HE-Meta: U2FsdGVkX1+gP6t7cPjbyZMuZlZ0nlY2530LA5SlTZ6fbnsPWnIqAtlp2ntwYdWFSRW9dy0Sd19M3ecuzKotivpWI7EYGvr+3vgK+A6qYao75r0ff9l9hBgvsjm9i5UR203DOkntq4RvPavpukiYzaDcfD3Pm8gmXAfuUUIwbrOo2IWdc7Jx1K0TkYoNCoRmSnNcw4sracliRuaiDOMwQR3XP2tFoH/9FQJt4TgBat7G2YHj4pCf/qNwv+gYT+D1bMHBvP0lilB4McKpNZVPTS84zHkvDPFitnihi1VBTCO2P0sxivTIf/PCrc1pZi7Y/yl+mNlmIs7bB0x/pPKsCu00XqqZRVsKA6qbTsmB1c3qKjFFMmw+00o953bCLE8+7XDZn0rxLlIriUe8FE+6hk5d+oaoH9LrwMOYmTJQoP4eWpmsXM4+e3bxiqAyzRsjLV9cNOHCoMiWMwaOgHBu/SgBpMOdF+isBFk8QlOvGhQ25MkVAsJKjOa1NIldICZsuKsIehdVuSd7PzBT0PcxauW1/cXjKGTAI6STO4D1X68TX8m5AZfv9kV/Kyooce4WDS+Bla8SJaUl7/t1KHqAE/ZJkEKtetfmqDNIQsScDRoSI9ADK7aBrA2HgHU58rDeCDcfGd9BESK9sngnnxF5BemysbHZZLyJXAV5C3L1PJDKi/IQVf0TIua3gBbTMOwi/cqYA6gvq4H9Ab593A7cdQ0xlX86dnSZJdqs9JVhoPSrZ/KclmYUU+w/j9r96OTFZjtYDRBKKzI+ZRZbZhnI8TZqubEhCjmrKsHdarN7WGGyuEM/d1T98IalvqWvekN338wREuW3v3MUfyirZnFVuQHUrzCUqgmspH4fdOp2pGaxzX0Rrps++qH2cpGTBQAzJTEDhcVKavDlY80ILxWIdHsXiIJVVLZzA3dGV51ntOX6O76Rn7FRap3sQ2VhFj6eTuB/wnj1PwGfElcUC7s Rn4ifGEH WFBMiUJdTEGV+kQVrRoL9owZPh4J8igNBuETmAsw8Q+mXt7IMosMF0pQjXClRaa+18HCrFO9gp2KR0s3VvmW4x0u0kooa6Pk3iBitGwv9lwKbCTj6USZgFh0k6CELqhKjWsD1XJIsn+g/slZnuF38n77PBsftadKmstb/b9Tjd1edxmJgyV8Odh+eqc5SKYkvQgdEtQur6t+pJu9HLNauvjOH3LJLD74O9IFz13IpwK/HMx05Y1Zoq1isMedjuRnm+8nm4asZgqsTz+DVlDRnY4WNLv1PovuoMpkzpO4YV1Wr9nhT5NzuT4DGmSBKisHEgqnm5s95VEZgKIsbQcX2sf0d3563Wmmk6Pp9rZm+UmZuGqBxtvDGR0bu00oHh3rKEo1L64cxtCIntePOnhzcaeya+Yc+9kmqPMZH92qh2KiCithQrf0jhyUvCdTcY9dawWHVgzgliAcSnDqqYGt8RMdlt+pGwfA1rluodnXep6MUJaARzB1ALAcKw3wytZZkwjcf1t5G84GWIUOzyjUu5Dfj6m7wOY4nyUN/hkLvQ+cGhrzrsPyVDy+kMD/q67UtPwrdct9ZSVBcJh8yf6IqG5zkTGzN70z/x4/5 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: From: SeongJae Park Document the newly added DAMOS action destination directory of the DAMON sysfs interface on the usage document. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 33 +++++++++++++++++--- 1 file changed, 29 insertions(+), 4 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index d960aba72b82..fc5c962353ed 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -85,6 +85,8 @@ comma (","). │ │ │ │ │ │ │ :ref:`watermarks `/metric,interval_us,high,mid,low │ │ │ │ │ │ │ :ref:`{core_,ops_,}filters `/nr_filters │ │ │ │ │ │ │ │ 0/type,matching,allow,memcg_path,addr_start,addr_end,target_idx,min,max + │ │ │ │ │ │ │ :ref:`dests `/nr_dests + │ │ │ │ │ │ │ │ 0/id,weight │ │ │ │ │ │ │ :ref:`stats `/nr_tried,sz_tried,nr_applied,sz_applied,sz_ops_filter_passed,qt_exceeds │ │ │ │ │ │ │ :ref:`tried_regions `/total_bytes │ │ │ │ │ │ │ │ 0/start,end,nr_accesses,age,sz_filter_passed @@ -307,10 +309,10 @@ to ``N-1``. Each directory represents each DAMON-based operation scheme. schemes// ------------ -In each scheme directory, seven directories (``access_pattern``, ``quotas``, -``watermarks``, ``core_filters``, ``ops_filters``, ``filters``, ``stats``, and -``tried_regions``) and three files (``action``, ``target_nid`` and -``apply_interval``) exist. +In each scheme directory, eight directories (``access_pattern``, ``quotas``, +``watermarks``, ``core_filters``, ``ops_filters``, ``filters``, ``dests``, +``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 @@ -484,6 +486,29 @@ Refer to the :ref:`DAMOS filters design documentation of different ``allow`` works, when each of the filters are supported, and differences on stats. +.. _damon_sysfs_dests: + +schemes//dests/ +------------------ + +Directory for specifying the destinations of given DAMON-based operation +scheme's action. This directory is ignored if the action of the given scheme +is not supporting multiple destinations. Only ``DAMOS_MIGRATE_{HOT,COLD}`` +actions are supporting multiple destinations. + +In the beginning, the directory has only one file, ``nr_dests``. Writing a +number (``N``) to the file creates the number of child directories named ``0`` +to ``N-1``. Each directory represents each action destination. + +Each destination directory contains two files, namely ``id`` and ``weight``. +Users can write and read the identifier of the destination to ``id`` file. +For ``DAMOS_MIGRATE_{HOT,COLD}`` actions, the migrate destination node's node +id should be written to ``id`` file. Users can write and read the weight of +the destination among the given destinations to the ``weight`` file. The +weight can be an arbitrary integer. When DAMOS apply the action to each entity +of the memory region, it will select the destination of the action based on the +relative weights of the destinations. + .. _sysfs_schemes_stats: schemes//stats/ -- 2.43.5