From patchwork Fri Oct 22 09:03:08 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 12577417 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 mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 7CB8BC433F5 for ; Fri, 22 Oct 2021 09:03:20 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 2020361183 for ; Fri, 22 Oct 2021 09:03:20 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.4.1 mail.kernel.org 2020361183 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=kernel.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=kvack.org Received: by kanga.kvack.org (Postfix) id B0A7D900002; Fri, 22 Oct 2021 05:03:19 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id A924E940007; Fri, 22 Oct 2021 05:03:19 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 93358900004; Fri, 22 Oct 2021 05:03:19 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0163.hostedemail.com [216.40.44.163]) by kanga.kvack.org (Postfix) with ESMTP id 834B3900002 for ; Fri, 22 Oct 2021 05:03:19 -0400 (EDT) Received: from smtpin22.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay05.hostedemail.com (Postfix) with ESMTP id 4250F180289B1 for ; Fri, 22 Oct 2021 09:03:19 +0000 (UTC) X-FDA: 78723484518.22.EE5F5F1 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by imf05.hostedemail.com (Postfix) with ESMTP id 0016A5084BA0 for ; Fri, 22 Oct 2021 09:03:11 +0000 (UTC) Received: by mail.kernel.org (Postfix) with ESMTPSA id 8EA5D61163; Fri, 22 Oct 2021 09:03:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1634893398; bh=OkzRP2etOM84DmGdDzDCdPmrOdQc3nNLDRppJQreb7E=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=nFmfWaIcuMDsNJL+vD2Jaz/HzP+HxsaIfG3loLLf+PPQG6xPHFKZ7X5ECAFXWkeuc AbgQt8oAmkR1SqAO0cRapjMERqm8/tNr6MTVStXYQuiLcUrUrlg9JeBUG5sG2F8qqC 19zqb2WCoNUFzICb1Z/978D0dTUTEd8eaM0077CniezMbLgt+UTi+KBGy7pzveVZH3 FF/b10dwmZAhBmQ/irGW+FY/XMp0rd85OBzrEiIF5gCnO08RHfGfLhVnW1EZsVEQyW tz5QkRHuQKD8CTcfZv+amkq5O1SpHyf9/DsbNwJ5x39774+yl48PWtFR3MIx+TVTa+ QWomLmLbZoM+w== From: SeongJae Park To: akpm@linux-foundation.org, corbet@lwn.net Cc: peterx@redhat.com, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, SeongJae Park Subject: [PATCH 1/4] Docs/admin-guide/mm/damon/start: Fix wrong example commands Date: Fri, 22 Oct 2021 09:03:08 +0000 Message-Id: <20211022090311.3856-2-sj@kernel.org> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20211022090311.3856-1-sj@kernel.org> References: <20211022090311.3856-1-sj@kernel.org> X-Stat-Signature: wi98h7w6osqw7puopcesxf4cgrg4oyw4 Authentication-Results: imf05.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=nFmfWaIc; spf=pass (imf05.hostedemail.com: domain of sj@kernel.org designates 198.145.29.99 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org X-Rspamd-Server: rspam04 X-Rspamd-Queue-Id: 0016A5084BA0 X-HE-Tag: 1634893391-94685 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: Some of the example commands in DAMON getting started guide are outdated, missing sudo, or just wrong. This commit fixes those. Signed-off-by: SeongJae Park --- Documentation/admin-guide/mm/damon/start.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/Documentation/admin-guide/mm/damon/start.rst b/Documentation/admin-guide/mm/damon/start.rst index 51503cf90ca2..3ad8bbed9b18 100644 --- a/Documentation/admin-guide/mm/damon/start.rst +++ b/Documentation/admin-guide/mm/damon/start.rst @@ -19,7 +19,7 @@ your workload. :: # mount -t debugfs none /sys/kernel/debug/ # git clone https://github.com/awslabs/damo # ./damo/damo record $(pidof ) - # ./damo/damo report heat --plot_ascii + # ./damo/damo report heats --heatmap stdout The final command draws the access heatmap of ````. The heatmap shows which memory region (x-axis) is accessed when (y-axis) and how frequently @@ -94,9 +94,9 @@ Visualizing Recorded Patterns The following three commands visualize the recorded access patterns and save the results as separate image files. :: - $ damo report heats --heatmap access_pattern_heatmap.png - $ damo report wss --range 0 101 1 --plot wss_dist.png - $ damo report wss --range 0 101 1 --sortby time --plot wss_chron_change.png + $ sudo damo report heats --heatmap access_pattern_heatmap.png + $ sudo damo report wss --range 0 101 1 --plot wss_dist.png + $ sudo damo report wss --range 0 101 1 --sortby time --plot wss_chron_change.png - ``access_pattern_heatmap.png`` will visualize the data access pattern in a heatmap, showing which memory region (y-axis) got accessed when (x-axis) @@ -115,9 +115,9 @@ Data Access Pattern Aware Memory Management Below three commands make every memory region of size >=4K that doesn't accessed for >=60 seconds in your workload to be swapped out. :: - $ echo "#min-size max-size min-acc max-acc min-age max-age action" > scheme - $ echo "4K max 0 0 60s max pageout" >> scheme - $ damo schemes -c my_thp_scheme + $ echo "#min-size max-size min-acc max-acc min-age max-age action" > test_scheme + $ echo "4K max 0 0 60s max pageout" >> test_scheme + $ damo schemes -c test_scheme .. [1] https://damonitor.github.io/doc/html/v17/admin-guide/mm/damon/start.html#visualizing-recorded-patterns .. [2] https://damonitor.github.io/test/result/visual/latest/rec.heatmap.1.png.html