From patchwork Thu Nov 30 02:36:51 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13473982 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 61614C4167B for ; Thu, 30 Nov 2023 02:37:22 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 976226B03F3; Wed, 29 Nov 2023 21:37:08 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 8D6076B03F9; Wed, 29 Nov 2023 21:37:08 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 68B6C6B03FB; Wed, 29 Nov 2023 21:37:08 -0500 (EST) 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 58DA26B03F3 for ; Wed, 29 Nov 2023 21:37:08 -0500 (EST) Received: from smtpin08.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id 3C21B12027D for ; Thu, 30 Nov 2023 02:37:08 +0000 (UTC) X-FDA: 81513058536.08.86D90D4 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by imf09.hostedemail.com (Postfix) with ESMTP id 66D46140008 for ; Thu, 30 Nov 2023 02:37:06 +0000 (UTC) Authentication-Results: imf09.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=V1SVwMeW; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf09.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1701311826; 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=lUIbfuFQ5f07c6eQ5WlZXiGCDTA/MO9hOvBwdWAwWe4=; b=ztIKqqvU9CmGj9itG1cMW9cPoSUmcZX9GKTcAHq9QOV6FMyOMhOYrHZcjVxjFddmgq6c3V F8lgu8NJCZldevbcmUttCwNq3rtDB02TkuqN10W0QxJWV/ijM9v6Xny1E3B4803cm9XwQ+ qN6dIwMDLD+QsUrtE7NDr2tdyMTqDEg= ARC-Authentication-Results: i=1; imf09.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=V1SVwMeW; dmarc=pass (policy=none) header.from=kernel.org; spf=pass (imf09.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1701311826; a=rsa-sha256; cv=none; b=eEdHM7fjbVSPeaMIsvq1XJDo29J/ZhUK/W6XTZ89R11GM9pB9BAhn5lyP5+XlmlTqlKG3j csS6L6BDwmhAWqr7STKy6QRItvikf++VdwiR7sfOxOPn8RoBAfPrPHQl+P8UTya+7mFP3R pqpudYWRSRE6BWiJG6WFVE7YdiDc3ok= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by ams.source.kernel.org (Postfix) with ESMTP id 15F30B83E27; Thu, 30 Nov 2023 02:37:05 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 47FE1C433AB; Thu, 30 Nov 2023 02:37:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1701311824; bh=qpI3K6y2bl+C+kintuKgeKanPx5i37W/Tszsh9HeKhU=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=V1SVwMeWHdgYs4jpDF4orbpSyyG9vn4bRy/aHf+eo+IYlxietj5xvUrwU3gyuZ5+z xnnF2z93D6mPI/Lt4SlB61ZQiwhKBCaZlB7hU7KRqBb99I3x+7LkkAmPf0Kjl0tCoV /vfxe11hgxWaDQyYVe0dbo7OI+UcvT+lMZnvRYriRdlVhcxNl5bUpy/PkR5jF+T1Da 8JP1CDG7KORBs+HtA1lqd9Pn3PpEFPsF2RxmLGVxYCJRYLFegvQuOG1wHynnOyL8rC z+KA0A+0ceyaDTHwqCUEu6ndT7H5VQ1Zqo/uRUI18+GIGDlbgChie1A30qmUbewyAG edOnU4tXWPoxg== 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 8/9] Docs/ABI/damon: document DAMOS quota goals Date: Thu, 30 Nov 2023 02:36:51 +0000 Message-Id: <20231130023652.50284-9-sj@kernel.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231130023652.50284-1-sj@kernel.org> References: <20231130023652.50284-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: 66D46140008 X-Rspam-User: X-Rspamd-Server: rspam05 X-Stat-Signature: kep71jphcaf75741rsoi91n1ge9disep X-HE-Tag: 1701311826-30601 X-HE-Meta: U2FsdGVkX195a6bsrFul6sBl6bHzE6ZT3u+x7qbXvMO6SwluFiBKO4wCqS50g9S9g21wx6+9xGiTh0y9lcj2Uks0n+VylykhQdYq0ogkNS8KpouqZRj7zMiolaLm/gBGfrSE+M/IlSjFXnBDhcTaRmkTyyG47E/F+gVAsCOSTbbmGG2LUHNF10OgcGLL5HhPbNkBMpEHJpPwxcLwO8QnkFmTzE16Dfshn9k5dcEfgCG37CQq7lN/20SNOr0iKs0C1I4d3F4nizZLUYQfA3oNjUsbKm3jxU7PJnQ4wMiPv/2tjAHd7QscG1l90jSP1eoySRuIx0NOhV1k3d4VPi/ilFAHhmPjOokIJ63TQ4VL4xIOczyARTnx4FQhKby/l+cepZIP0MBt6B0N9SzZ9D5gmF0h19GyYHBP6RhKRFDQyadgaK7Oa2oIzba8FSpNKNhm/j/kAIIHtN5unUPVh1+vGADc+MdjEp6LOHB73RxwP2h7Lr1EQPgDqeNRBV8mwEHYsTj1HemS/k77MklUuVgSA7RUga6/ZLpDOxD9sGedHkKYLXuOHR1ARwsQqPz99hsqBinARSgnvY673EPLwCb37Pq+t/nbhlfAHKLtHUjzmIXewPaOyrrJ5kCPy3T3XVTRct6AEyurAiu3RlT904QLliZoTDqA4zAJf/+s1vZth4f7g9GUUmiNVWTzjaSwreH7dwbvHt2XV0opu+NPjEUTLC0HGgZowb+T4TsjF14f35Ke7VyiFnaGkc/PgGnmnDmxqQJfBgLUBLqPXiXnIMQPcsnB4s5QHrKfr54XEmcUBjtec8FuwpNT1pxh8JE6XIYgr17IOqwGumNAhEiWGyTNWgQSi1q1yfoXm2DNbAu6BO22U4dMS52wSMErf6dArXw7hJ+RtFBxr9IgydHF7F4A2Z+7pHA16zvVZmPHeP2JjGSCX8+dYGJEDm+Wf/nAh5zmDume/lC/hBwncW2WMTC XKzHMCbP tV4En0wAAgaUFdWi5XwHqcU5qm+fl2nmTVK4GGczl+3g0Kw/wce6Dw365gTil5qRBHmAkazlfsIaaAthpcH/+UTrQp9/tRorTHSmSHP6YoNbkLWx2K2JU8vk2wqIl+hM+h4Tn6X77rLHgko4fm71z8dtTV2n1nBeajzvnJ+V/m4CcTlvBj+ucsjRP6Dqyfhwz9EH5HzadTltzIlIZSUOS69no/C8m3E63gVlm74Lry7E4nE+jySp4WoTX6V1sfvyDdI4LmfKprYYjcPIdgOrQ5SNPFHSPDYILvu2cRzyyS7aezyU= 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: Update DAMON ABI document for the newly added DAMON sysfs files and inputs for DAMOS quota goals. Signed-off-by: SeongJae Park --- .../ABI/testing/sysfs-kernel-mm-damon | 33 +++++++++++++++---- 1 file changed, 27 insertions(+), 6 deletions(-) diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon index b35649a46a2f..bfa5b8288d8d 100644 --- a/Documentation/ABI/testing/sysfs-kernel-mm-damon +++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon @@ -25,12 +25,14 @@ Description: Writing 'on' or 'off' to this file makes the kdamond starts or stops, respectively. Reading the file returns the keywords based on the current status. Writing 'commit' to this file makes the kdamond reads the user inputs in the sysfs files - except 'state' again. Writing 'update_schemes_stats' to the - file updates contents of schemes stats files of the kdamond. - Writing 'update_schemes_tried_regions' to the file updates - contents of 'tried_regions' directory of every scheme directory - of this kdamond. Writing 'update_schemes_tried_bytes' to the - file updates only '.../tried_regions/total_bytes' files of this + except 'state' again. Writing 'commit_schemes_quota_goals' to + this file makes the kdamond reads the quota goal files again. + Writing 'update_schemes_stats' to the file updates contents of + schemes stats files of the kdamond. Writing + 'update_schemes_tried_regions' to the file updates contents of + 'tried_regions' directory of every scheme directory of this + kdamond. Writing 'update_schemes_tried_bytes' to the file + updates only '.../tried_regions/total_bytes' files of this kdamond. Writing 'clear_schemes_tried_regions' to the file removes contents of the 'tried_regions' directory. @@ -212,6 +214,25 @@ Contact: SeongJae Park Description: Writing to and reading from this file sets and gets the quotas charge reset interval of the scheme in milliseconds. +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//quotas/goals/nr_goals +Date: Nov 2023 +Contact: SeongJae Park +Description: Writing a number 'N' to this file creates the number of + directories for setting automatic tuning of the scheme's + aggressiveness named '0' to 'N-1' under the goals/ directory. + +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//quotas/goals//target_value +Date: Nov 2023 +Contact: SeongJae Park +Description: Writing to and reading from this file sets and gets the target + value of the goal metric. + +What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//quotas/goals//current_value +Date: Nov 2023 +Contact: SeongJae Park +Description: Writing to and reading from this file sets and gets the current + value of the goal metric. + What: /sys/kernel/mm/damon/admin/kdamonds//contexts//schemes//quotas/weights/sz_permil Date: Mar 2022 Contact: SeongJae Park