From: SeongJae Park <sjpark@amazon.com>
To: Greg Thelen <gthelen@google.com>
Cc: SeongJae Park <sjpark@amazon.com>, <akpm@linux-foundation.org>,
"SeongJae Park" <sjpark@amazon.de>, <Jonathan.Cameron@Huawei.com>,
<aarcange@redhat.com>, <acme@kernel.org>,
<alexander.shishkin@linux.intel.com>, <amit@kernel.org>,
<benh@kernel.crashing.org>, <brendan.d.gregg@gmail.com>,
<brendanhiggins@google.com>, <cai@lca.pw>,
<colin.king@canonical.com>, <corbet@lwn.net>, <david@redhat.com>,
<dwmw@amazon.com>, <foersleo@amazon.de>, <irogers@google.com>,
<jolsa@redhat.com>, <kirill@shutemov.name>,
<mark.rutland@arm.com>, <mgorman@suse.de>, <minchan@kernel.org>,
<mingo@redhat.com>, <namhyung@kernel.org>, <peterz@infradead.org>,
<rdunlap@infradead.org>, <riel@surriel.com>,
<rientjes@google.com>, <rostedt@goodmis.org>, <rppt@kernel.org>,
<sblbir@amazon.com>, <shakeelb@google.com>, <shuah@kernel.org>,
<sj38.park@gmail.com>, <snu@amazon.de>, <vbabka@suse.cz>,
<vdavydov.dev@gmail.com>, <yang.shi@linux.alibaba.com>,
<ying.huang@intel.com>, <linux-damon@amazon.com>,
<linux-mm@kvack.org>, <linux-doc@vger.kernel.org>,
<linux-kernel@vger.kernel.org>
Subject: Re: Re: [PATCH v18 11/14] Documentation: Add documents for DAMON
Date: Mon, 27 Jul 2020 09:38:42 +0200 [thread overview]
Message-ID: <20200727073842.5328-1-sjpark@amazon.com> (raw)
In-Reply-To: <xr938sf577dn.fsf@gthelen.svl.corp.google.com>
On Mon, 27 Jul 2020 00:19:00 -0700 Greg Thelen <gthelen@google.com> wrote:
> SeongJae Park <sjpark@amazon.com> wrote:
>
> > From: SeongJae Park <sjpark@amazon.de>
> >
> > This commit adds documents for DAMON under
> > `Documentation/admin-guide/mm/damon/` and `Documentation/vm/damon/`.
> >
> > Signed-off-by: SeongJae Park <sjpark@amazon.de>
> > ---
> > 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
> >+
[...]
> > +===============
> > +Detailed Usages
> > +===============
> > +
> > +DAMON provides below three interfaces for different users.
> > +
> > +- *DAMON user space tool.*
> > + This is for privileged people such as system administrators who want a
> > + just-working human-friendly interface. Using this, users can use the DAMON’s
> > + major features in a human-friendly way. It may not be highly tuned for
> > + special cases, though. It supports only virtual address spaces monitoring.
> > +- *debugfs interface.*
> > + This is for privileged user space programmers who want more optimized use of
> > + DAMON. Using this, users can use DAMON’s major features by reading
> > + from and writing to special debugfs files. Therefore, you can write 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 utilize every
> > + feature of DAMON most flexibly and efficiently by writing kernel space
> > + DAMON application programs for you. You can even extend DAMON for various
> > + address spaces.
> > +
> > +This document does not describe the kernel space programming interface in
> > +detail. For that, please refer to the :doc:`/vm/damon/api`.
> > +
> > +
> > +DAMON User Sapce Tool
>
> Space
Right, thanks!
>
[...]
> > +
> > +Can 'idle pages tracking' or 'perf mem' substitute DAMON?
> > +=========================================================
> > +
> > +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 management
> > +optimization and provides sophisticated accuracy/overhead handling mechanisms.
> > +Therefore, 'idle pages tracking' and 'perf mem' could provide a subset of
> > +DAMON's output, but cannot substitute DAMON. Rather than that, thouse could be
>
> those?
Good eye! I will fix both in the next spin.
Thanks,
SeongJae Park
next prev parent reply other threads:[~2020-07-27 7:39 UTC|newest]
Thread overview: 37+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-07-13 8:41 [PATCH v18 00/14] Introduce Data Access MONitor (DAMON) SeongJae Park
2020-07-13 8:41 ` [PATCH v18 01/14] mm/page_ext: Export lookup_page_ext() to GPL modules SeongJae Park
2020-07-13 12:08 ` Mike Rapoport
2020-07-13 12:21 ` SeongJae Park
2020-07-13 17:19 ` Mike Rapoport
2020-07-13 17:38 ` SeongJae Park
2020-07-17 9:59 ` SeongJae Park
2020-07-13 8:41 ` [PATCH v18 02/14] mm: Introduce Data Access MONitor (DAMON) SeongJae Park
2020-07-18 2:47 ` Shakeel Butt
2020-07-18 13:31 ` SeongJae Park
2020-07-29 15:31 ` Shakeel Butt
2020-07-29 17:29 ` SeongJae Park
2020-07-13 8:41 ` [PATCH v18 03/14] mm/damon: Implement region based sampling SeongJae Park
2020-07-13 8:41 ` [PATCH v18 04/14] mm/damon: Adaptively adjust regions SeongJae Park
2020-07-13 8:41 ` [PATCH v18 05/14] mm/damon: Track dynamic monitoring target regions update SeongJae Park
2020-07-13 8:41 ` [PATCH v18 06/14] mm/damon: Implement callbacks for the virtual memory address spaces SeongJae Park
2020-07-17 0:46 ` Shakeel Butt
2020-07-17 6:53 ` SeongJae Park
2020-07-17 15:17 ` Shakeel Butt
2020-07-17 16:24 ` SeongJae Park
2020-07-18 2:23 ` Shakeel Butt
2020-07-18 2:51 ` SeongJae Park
2020-07-27 7:34 ` Greg Thelen
2020-07-27 9:02 ` SeongJae Park
2020-07-28 17:42 ` Shakeel Butt
2020-07-29 6:20 ` SeongJae Park
2020-07-13 8:41 ` [PATCH v18 07/14] mm/damon: Implement access pattern recording SeongJae Park
2020-07-13 8:41 ` [PATCH v18 08/14] mm/damon: Add a tracepoint SeongJae Park
2020-07-13 8:41 ` [PATCH v18 09/14] mm/damon: Implement a debugfs interface SeongJae Park
2020-07-22 10:36 ` SeongJae Park
2020-07-13 8:41 ` [PATCH v18 10/14] tools: Introduce a minimal user-space tool for DAMON SeongJae Park
2020-07-13 8:41 ` [PATCH v18 11/14] Documentation: Add documents " SeongJae Park
2020-07-27 7:19 ` Greg Thelen
2020-07-27 7:38 ` SeongJae Park [this message]
2020-07-13 8:41 ` [PATCH v18 12/14] mm/damon: Add kunit tests SeongJae Park
2020-07-13 8:41 ` [PATCH v18 13/14] mm/damon: Add user space selftests SeongJae Park
2020-07-13 8:41 ` [PATCH v18 14/14] MAINTAINERS: Update for DAMON SeongJae Park
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20200727073842.5328-1-sjpark@amazon.com \
--to=sjpark@amazon.com \
--cc=Jonathan.Cameron@Huawei.com \
--cc=aarcange@redhat.com \
--cc=acme@kernel.org \
--cc=akpm@linux-foundation.org \
--cc=alexander.shishkin@linux.intel.com \
--cc=amit@kernel.org \
--cc=benh@kernel.crashing.org \
--cc=brendan.d.gregg@gmail.com \
--cc=brendanhiggins@google.com \
--cc=cai@lca.pw \
--cc=colin.king@canonical.com \
--cc=corbet@lwn.net \
--cc=david@redhat.com \
--cc=dwmw@amazon.com \
--cc=foersleo@amazon.de \
--cc=gthelen@google.com \
--cc=irogers@google.com \
--cc=jolsa@redhat.com \
--cc=kirill@shutemov.name \
--cc=linux-damon@amazon.com \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-mm@kvack.org \
--cc=mark.rutland@arm.com \
--cc=mgorman@suse.de \
--cc=minchan@kernel.org \
--cc=mingo@redhat.com \
--cc=namhyung@kernel.org \
--cc=peterz@infradead.org \
--cc=rdunlap@infradead.org \
--cc=riel@surriel.com \
--cc=rientjes@google.com \
--cc=rostedt@goodmis.org \
--cc=rppt@kernel.org \
--cc=sblbir@amazon.com \
--cc=shakeelb@google.com \
--cc=shuah@kernel.org \
--cc=sj38.park@gmail.com \
--cc=sjpark@amazon.de \
--cc=snu@amazon.de \
--cc=vbabka@suse.cz \
--cc=vdavydov.dev@gmail.com \
--cc=yang.shi@linux.alibaba.com \
--cc=ying.huang@intel.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).