From patchwork Tue Jan 30 01:35:44 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 193769 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2087:b0:106:209c:c626 with SMTP id gs7csp940308dyb; Mon, 29 Jan 2024 17:38:01 -0800 (PST) X-Google-Smtp-Source: AGHT+IF5KuJHZtyDu0Rq/SPndpmGvLKSpKtYc31p3z+QAw2F1ynwtLr1aosGoW1uAfpkTrjX0h+b X-Received: by 2002:a05:6870:c1d5:b0:218:5600:e72c with SMTP id i21-20020a056870c1d500b002185600e72cmr8543032oad.37.1706578681547; Mon, 29 Jan 2024 17:38:01 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1706578681; cv=pass; d=google.com; s=arc-20160816; b=TCAcgun7gyyfahERnS9JbfQNW7b9iKOJcWd6Z8gqWUnnJgQfVUPGXl59iETDuiwkEq X/NqQLSSPsZONDaaNzP/ThpWvQ1KcJm9veRzKZXW00D3deVJF9Q1eSFniGai5XPsoWRG YK/kdUlb9HNGMbHz3zmlKC1UuTqyzz5s4kmsZJgWbXbaBIglY4uC2mq+A3oi9wmrSp5M GWyGCvRwHrHrvuLZsPeBbDVr+Q0wWqt+Wk4mDyI6Z8kiABceAwW0w6x6wHK9ZgXw19s8 DlMiccM0V1Gr4pzrQUpXhXCxb5tH1vv7NoVWILSjiC4cpKMOlOnHmuWF6g4HuRCwxppI cyog== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=TiqnJbNWgCiHv+i0MWoxbS4Se8F+bil1/y+IujP2iuE=; fh=jKijsxc1Z2CHKVFf4S4lB42jMLcn6gTpewOn4Tq1/VM=; b=ErhfSb0LIcn6IF8Kp7T2Rzthmpei6AARaT608iKY056EcZk+3vXbFa9cXsBxsAknnJ vkJXZ5nlPLZYnVNfYs+jOPKllI8ATrRC8mATkexZUJtu4baM+b+/NDpSiwI1Koa/6Db7 ETIjFZMD6vb6AX9pPLAu9zocZ9BtD/w1Lg6KyfFhX6RYp+4X4wxC7Qzk8RkOMStUzpZM OtRDBXCDSZ6I+aQi55sqbrzR40IslHfdb1ywJxZbhA39QrVWhBW7MNcTr2AZ5+7SmYAk X2zokIc6o5NmDhpDayFsp2fZD8tT0dceRj1dfw12Ge2GodHtBVARbW3Nptmc02Jfr1pd T+Iw== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=jn2kAJ64; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-43725-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-43725-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id k6-20020a63ba06000000b005d7ab49ae83si6529099pgf.120.2024.01.29.17.38.01 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Jan 2024 17:38:01 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-43725-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=jn2kAJ64; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-43725-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-43725-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by sv.mirrors.kernel.org (Postfix) with ESMTPS id 4D9AE28256D for ; Tue, 30 Jan 2024 01:38:01 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 1A85D38398; Tue, 30 Jan 2024 01:36:04 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="jn2kAJ64" 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 798EF36B1B; Tue, 30 Jan 2024 01:36:00 +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=1706578560; cv=none; b=GNUeGW8ZGYQ468w90q2YdDVk0VHY01KbMwPz52D3ro2b+QoIF13dkPaqVUpnjkfQzrs0Yv4mljnJC5eavU/Z0VV7C0M4oUiNsTMDUBWHa8TbpEC6OuNRB6/KbUZhYTN3PimVpYyWsyILl0KuKIgr/gyXfKRsrl4WO2ESioP8MJo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706578560; c=relaxed/simple; bh=QwFDGVTfCJQhExDgwMfhXxVfZDEJjE7tnYoyx4MeyPs=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=cEy0B004EPCXvZmhUuLZintVuc9x2OFedxGkhHVYDzXsh031nBfxyM9nqGWvljEbbo7uBxX/+NhLLTbYQKqLAe5BzEWdyCcAp8rcjYQJghtEsJc9v+QmVtY0J7yQ3bTftHXB59maxOMi156fVmuEyT+x4yvN8IvFGkYslYDIHGs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=jn2kAJ64; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPSA id 95812C433F1; Tue, 30 Jan 2024 01:35:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1706578560; bh=QwFDGVTfCJQhExDgwMfhXxVfZDEJjE7tnYoyx4MeyPs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=jn2kAJ64jX3y9uusBNQba+8eCKSt8+re6HtxCuT5lrz8GaEdHb/UDdbWUpFsPzV/H qz9NZmQUntd0hZVO21XYjgv5CulXkKXa1O3jOq+SOTjHYkQPGs5Z7gf2GqIKPD+yKl iOD7bi+o09rntjgPn52bdOchOVvTPPkZReLtosLJjkRWtCucPbKLvg722vug2eMmzf l2sU6+rEU+zLPTVEp/xH672L+9wm4bi9gJTkNDgun/kFVGHKk7BgFj66SwQAO2DrT1 Oy9yNc01U5/dhyvG4zc1Imxbsn34vWm0UxdP8/0c60W1c2B9PYIfyCs5JFE7YVsAHp gv8DmsSs+ANKQ== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 5/9] Docs/admin-guide/mm/damon/usage: document 'DEPRECATED' file of DAMON debugfs interface Date: Mon, 29 Jan 2024 17:35:44 -0800 Message-Id: <20240130013549.89538-6-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240130013549.89538-1-sj@kernel.org> References: <20240130013549.89538-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1789477447879134548 X-GMAIL-MSGID: 1789477447879134548 Document the newly added DAMON debugfs interface deprecation notice file on the usage document. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index f2feabb4bd35..5d3df18dfb9f 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -628,9 +628,16 @@ debugfs Interface (DEPRECATED!) move, please report your usecase to damon@lists.linux.dev and linux-mm@kvack.org. -DAMON exports eight files, ``attrs``, ``target_ids``, ``init_regions``, -``schemes``, ``monitor_on``, ``kdamond_pid``, ``mk_contexts`` and -``rm_contexts`` under its debugfs directory, ``/damon/``. +DAMON exports nine files, ``DEPRECATED``, ``attrs``, ``target_ids``, +``init_regions``, ``schemes``, ``monitor_on``, ``kdamond_pid``, ``mk_contexts`` +and ``rm_contexts`` under its debugfs directory, ``/damon/``. + + +``DEPRECATED`` is a read-only file for the DAMON debugfs interface deprecation +notice. Reading it returns the deprecation notice, as below:: + + # cat DEPRECATED + DAMON debugfs interface is deprecated, so users should move to DAMON_SYSFS. If you cannot, please report your usecase to damon@lists.linux.dev and linux-mm@kvack.org. Attributes