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 X-Spam-Level: X-Spam-Status: No, score=-9.0 required=3.0 tests=BAYES_00,DKIM_ADSP_ALL, DKIM_INVALID,DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=unavailable autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id DB408C433E8 for ; Mon, 27 Jul 2020 07:39:44 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id 9F7CA2075D for ; Mon, 27 Jul 2020 07:39:44 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (1024-bit key) header.d=amazon.com header.i=@amazon.com header.b="WR9B5dqr" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 9F7CA2075D Authentication-Results: mail.kernel.org; dmarc=fail (p=quarantine dis=none) header.from=amazon.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id 16CE36B0003; Mon, 27 Jul 2020 03:39:44 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 11FB96B0005; Mon, 27 Jul 2020 03:39:44 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id F27626B0007; Mon, 27 Jul 2020 03:39:43 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0179.hostedemail.com [216.40.44.179]) by kanga.kvack.org (Postfix) with ESMTP id D8EC86B0003 for ; Mon, 27 Jul 2020 03:39:43 -0400 (EDT) Received: from smtpin28.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay05.hostedemail.com (Postfix) with ESMTP id 70362181AC9BF for ; Mon, 27 Jul 2020 07:39:43 +0000 (UTC) X-FDA: 77083056246.28.ants37_45150ef26f5f Received: from filter.hostedemail.com (10.5.16.251.rfc1918.com [10.5.16.251]) by smtpin28.hostedemail.com (Postfix) with ESMTP id 4400A6C36 for ; Mon, 27 Jul 2020 07:39:43 +0000 (UTC) X-HE-Tag: ants37_45150ef26f5f X-Filterd-Recvd-Size: 7646 Received: from smtp-fw-9101.amazon.com (smtp-fw-9101.amazon.com [207.171.184.25]) by imf12.hostedemail.com (Postfix) with ESMTP for ; Mon, 27 Jul 2020 07:39:42 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=amazon.com; i=@amazon.com; q=dns/txt; s=amazon201209; t=1595835583; x=1627371583; h=from:to:cc:subject:date:message-id:mime-version: in-reply-to:content-transfer-encoding; bh=FJjAKma81/3e1UdMJPfy23qzvOyOf8SJmgiY8ZS3SwA=; b=WR9B5dqrIkdS1Kcyc4X8lJrhAKRH3vPjwtWy1vBNULMt3+/fhAb676Mw M5jfSWj5iQJFV7DJmm0A9RKJyGjfIsDg8Uul6TtsUNz24yBDpOTUIvz4B +A+gCMWThFj+Y1qtenFAR+CK2eWYsbNXnLlbRgjoUvmrKpU1y/Kla3kS4 8=; IronPort-SDR: GtoPqIMqHLbnDdpFfyhmM3oVIKC3Lc1/KnaY7PBDZJxaLojcdz3M1DT24zbnD4ZVtrJfa9LKoq neDhI05BVRAA== X-IronPort-AV: E=Sophos;i="5.75,401,1589241600"; d="scan'208";a="54913381" Received: from sea32-co-svc-lb4-vlan3.sea.corp.amazon.com (HELO email-inbound-relay-1e-27fb8269.us-east-1.amazon.com) ([10.47.23.38]) by smtp-border-fw-out-9101.sea19.amazon.com with ESMTP; 27 Jul 2020 07:39:32 +0000 Received: from EX13MTAUEA002.ant.amazon.com (iad55-ws-svc-p15-lb9-vlan2.iad.amazon.com [10.40.159.162]) by email-inbound-relay-1e-27fb8269.us-east-1.amazon.com (Postfix) with ESMTPS id 561E2A2A57; Mon, 27 Jul 2020 07:39:18 +0000 (UTC) Received: from EX13D31EUA001.ant.amazon.com (10.43.165.15) by EX13MTAUEA002.ant.amazon.com (10.43.61.77) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Mon, 27 Jul 2020 07:39:17 +0000 Received: from u886c93fd17d25d.ant.amazon.com (10.43.161.145) by EX13D31EUA001.ant.amazon.com (10.43.165.15) with Microsoft SMTP Server (TLS) id 15.0.1497.2; Mon, 27 Jul 2020 07:38:59 +0000 From: SeongJae Park To: Greg Thelen CC: SeongJae Park , , "SeongJae Park" , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , , Subject: Re: Re: [PATCH v18 11/14] Documentation: Add documents for DAMON Date: Mon, 27 Jul 2020 09:38:42 +0200 Message-ID: <20200727073842.5328-1-sjpark@amazon.com> X-Mailer: git-send-email 2.17.1 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset="UTF-8" X-Originating-IP: [10.43.161.145] X-ClientProxiedBy: EX13D12UWC003.ant.amazon.com (10.43.162.12) To EX13D31EUA001.ant.amazon.com (10.43.165.15) X-Rspamd-Queue-Id: 4400A6C36 X-Spamd-Result: default: False [0.00 / 100.00] X-Rspamd-Server: rspam03 Content-Transfer-Encoding: quoted-printable 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: On Mon, 27 Jul 2020 00:19:00 -0700 Greg Thelen wrote= : > SeongJae Park wrote: >=20 > > From: SeongJae Park > > > > This commit adds documents for DAMON under > > `Documentation/admin-guide/mm/damon/` and `Documentation/vm/damon/`. > > > > Signed-off-by: SeongJae Park > > --- > > Documentation/admin-guide/mm/damon/guide.rst | 157 ++++++++++ > > Documentation/admin-guide/mm/damon/index.rst | 15 + > > Documentation/admin-guide/mm/damon/plans.rst | 29 ++ > > Documentation/admin-guide/mm/damon/start.rst | 98 ++++++ > > Documentation/admin-guide/mm/damon/usage.rst | 298 +++++++++++++++++= ++ > > Documentation/admin-guide/mm/index.rst | 1 + > > Documentation/vm/damon/api.rst | 20 ++ > > Documentation/vm/damon/eval.rst | 222 ++++++++++++++ > > Documentation/vm/damon/faq.rst | 59 ++++ > > Documentation/vm/damon/index.rst | 32 ++ > > Documentation/vm/damon/mechanisms.rst | 165 ++++++++++ > > Documentation/vm/index.rst | 1 + > > 12 files changed, 1097 insertions(+) > > create mode 100644 Documentation/admin-guide/mm/damon/guide.rst > > create mode 100644 Documentation/admin-guide/mm/damon/index.rst > > create mode 100644 Documentation/admin-guide/mm/damon/plans.rst > > create mode 100644 Documentation/admin-guide/mm/damon/start.rst > > create mode 100644 Documentation/admin-guide/mm/damon/usage.rst > > create mode 100644 Documentation/vm/damon/api.rst > > create mode 100644 Documentation/vm/damon/eval.rst > > create mode 100644 Documentation/vm/damon/faq.rst > > create mode 100644 Documentation/vm/damon/index.rst > > create mode 100644 Documentation/vm/damon/mechanisms.rst > >+ [...] > > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > +Detailed Usages > > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > + > > +DAMON provides below three interfaces for different users. > > + > > +- *DAMON user space tool.* > > + This is for privileged people such as system administrators who wa= nt a > > + just-working human-friendly interface. Using this, users can use = the DAMON=E2=80=99s > > + major features in a human-friendly way. It may not be highly tune= d for > > + special cases, though. It supports only virtual address spaces mo= nitoring. > > +- *debugfs interface.* > > + This is for privileged user space programmers who want more optimi= zed use of > > + DAMON. Using this, users can use DAMON=E2=80=99s major features b= y reading > > + from and writing to special debugfs files. Therefore, you can wri= te and use > > + your personalized DAMON debugfs wrapper programs that reads/writes= the > > + debugfs files instead of you. The DAMON user space tool is also a= reference > > + implementation of such programs. It supports only virtual address= spaces > > + monitoring. > > +- *Kernel Space Programming Interface.* > > + This is for kernel space programmers. Using this, users can utili= ze every > > + feature of DAMON most flexibly and efficiently by writing kernel s= pace > > + DAMON application programs for you. You can even extend DAMON for= various > > + address spaces. > > + > > +This document does not describe the kernel space programming interfa= ce in > > +detail. For that, please refer to the :doc:`/vm/damon/api`. > > + > > + > > +DAMON User Sapce Tool >=20 > Space Right, thanks! >=20 [...] > > + > > +Can 'idle pages tracking' or 'perf mem' substitute DAMON? > > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D > > + > > +Idle page tracking is a low level primitive for access check of the = physical > > +address space. 'perf mem' is similar, though it can use sampling to= minimize > > +the overhead. On the other hand, DAMON is a higher-level framework = for the > > +monitoring of various address spaces. It is focused on memory manag= ement > > +optimization and provides sophisticated accuracy/overhead handling m= echanisms. > > +Therefore, 'idle pages tracking' and 'perf mem' could provide a subs= et of > > +DAMON's output, but cannot substitute DAMON. Rather than that, thou= se could be >=20 > those? Good eye! I will fix both in the next spin. Thanks, SeongJae Park