From patchwork Fri Sep 9 20:29:01 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 12972164 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 87674ECAAD3 for ; Fri, 9 Sep 2022 20:29:16 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 2ABF48D000A; Fri, 9 Sep 2022 16:29:12 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 1988D8D0006; Fri, 9 Sep 2022 16:29:12 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id F04338D000A; Fri, 9 Sep 2022 16:29:11 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0014.hostedemail.com [216.40.44.14]) by kanga.kvack.org (Postfix) with ESMTP id D30F48D0006 for ; Fri, 9 Sep 2022 16:29:11 -0400 (EDT) Received: from smtpin06.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 92663A0192 for ; Fri, 9 Sep 2022 20:29:11 +0000 (UTC) X-FDA: 79893686502.06.3B7A5A6 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by imf16.hostedemail.com (Postfix) with ESMTP id 42DC618007F for ; Fri, 9 Sep 2022 20:29:11 +0000 (UTC) Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ams.source.kernel.org (Postfix) with ESMTPS id 36662B82625; Fri, 9 Sep 2022 20:29:10 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 7D210C433B5; Fri, 9 Sep 2022 20:29:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1662755349; bh=c/LlClDFkomglVBmI+e/AfXU1bu10Srp2u/iwk3ayRo=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=SKFDbBEJPpu9o71DSKWucKzDnYfHJ46Mw5IuVdh4sib1buz9UJZY9VFsxJ9TmVpfv 9W/+Ijx7nGgKZJYWkUigQUJIrgiiN6YW3+QP0VMvmtRG51ij1jf7yZXr/pUZmMfx4M xhsfQSlc4wwOZgOdr+5LGwolssAveCxQEMewgp4SDM2BDeNZwTt6j0gMzDBshvizuS P+r19tASMND//x7KTOpqkILncHfSczF9fgmPJYoBKilS+v0bQZmQZFdVbi8ZaYuShk 3O/2RBFW1U8gxrYkeQgi2GKm+FEvYQCcmWMRPv95JPuYMqkiKwjGg+5UYoUMAd3mZ+ bqCHFxBWTgHhA== From: SeongJae Park To: Andrew Morton Cc: Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, SeongJae Park Subject: [PATCH 7/7] Docs/admin-guide/mm/damon/usage: note DAMON debugfs interface deprecation plan Date: Fri, 9 Sep 2022 20:29:01 +0000 Message-Id: <20220909202901.57977-8-sj@kernel.org> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220909202901.57977-1-sj@kernel.org> References: <20220909202901.57977-1-sj@kernel.org> MIME-Version: 1.0 ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1662755351; 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=OYPzfT0QJ/GdRwXTLcfFBZJCnION2w+GXurqsUeBPog=; b=w3rTD7kzPh7ghoQcTzHgACO7V2nli+av1ZRko1Q3au36G2XBnF76aQm8Gz3BZ3Tpxtt93G t0dydaZz+2MzPwl20RI+3glJyTwN2p4/EeR95PHUN4dnJQ8sRMpC7AQ9MR9gRHMNgII/Xh +07dSaZe08b7uDPYc/7y600kMoAp660= ARC-Authentication-Results: i=1; imf16.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=SKFDbBEJ; spf=pass (imf16.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1662755351; a=rsa-sha256; cv=none; b=qjQQLLkShnNbVV/Zoj2VcViGpMDq5w4PWARhUqcf7ql6OjdEQg/jKNIJsoQHIk0EtiPRCL HJQI8dESza0uvLWZBtaSI4zMScUReM833blJdA8m9hggU7+NZsXG6PujT+ydjsVwLVVXz+ wDU08KIFUjYwsPrEw9FHqkp1KHh1z7Q= X-Rspam-User: Authentication-Results: imf16.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=SKFDbBEJ; spf=pass (imf16.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org X-Rspamd-Server: rspam06 X-Stat-Signature: 96dj66g1iomu8gum897hsm9oajm99f6p X-Rspamd-Queue-Id: 42DC618007F X-HE-Tag: 1662755351-684212 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: Commit b18402726bd1 ("Docs/admin-guide/mm/damon/usage: document DAMON sysfs interface") announced the DAMON debugfs interface deprecation plan, but it is not so aggressively announced. As the deprecation time is coming, this commit makes the announce more easy to be found by adding the note at the beginning of the DAMON debugfs interface usage document. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/usage.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/admin-guide/mm/damon/usage.rst b/Documentation/admin-guide/mm/damon/usage.rst index d52f572a9029..c050b882ddc1 100644 --- a/Documentation/admin-guide/mm/damon/usage.rst +++ b/Documentation/admin-guide/mm/damon/usage.rst @@ -393,6 +393,11 @@ the files as above. Above is only for an example. debugfs Interface ================= +.. note:: + + DAMON debugfs interface will be removed after next LTS kernel is released, so + users should move to the :ref:`sysfs interface `. + DAMON exports eight files, ``attrs``, ``target_ids``, ``init_regions``, ``schemes``, ``monitor_on``, ``kdamond_pid``, ``mk_contexts`` and ``rm_contexts`` under its debugfs directory, ``/damon/``.