linux.git/Documentation/admin-guide/mm, branch v5.16

Docs/admin-guide/mm/pagemap: wordsmith page flags descriptions

2021-11-06T20:30:46+00:00

Some descriptions of page flags in 'pagemap.rst' are written in
assumption of none-rst, which respects every new line, as below:

    7 - SLAB
       page is managed by the SLAB/SLOB/SLUB/SLQB kernel memory allocator
       When compound page is used, SLUB/SLQB will only set this flag on the head

Because rst ignores the new line between the first sentence and second
sentence, resulting html looks a little bit weird, as below.

    7 - SLAB
    page is managed by the SLAB/SLOB/SLUB/SLQB kernel memory allocator When
                                                                       ^
    compound page is used, SLUB/SLQB will only set this flag on the head
    page; SLOB will not flag it at all.

This change makes it more natural and consistent with other parts in the
rendered version.

Link: https://lkml.kernel.org/r/20211022090311.3856-5-sj@kernel.org
Signed-off-by: SeongJae Park 
Cc: Jonathan Corbet 
Cc: Peter Xu 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

Docs/admin-guide/mm/damon/start: simplify the content

2021-11-06T20:30:46+00:00

Information in 'TL; DR' section of 'Getting Started' is duplicated in
other parts of the doc.  It is also asking readers to visit the access
pattern visualizations gallery web site to show the results of example
visualization commands, while the users of the commands can use terminal
output.

To make the doc simple, this removes the duplicated 'TL; DR' section and
replaces the visualization example commands with versions using terminal
outputs.

Link: https://lkml.kernel.org/r/20211022090311.3856-4-sj@kernel.org
Signed-off-by: SeongJae Park 
Cc: Jonathan Corbet 
Cc: Peter Xu 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

Docs/admin-guide/mm/damon/start: fix a wrong link

2021-11-06T20:30:46+00:00

The 'Getting Started' of DAMON is providing a link to DAMON's user
interface document while saying about its user space tool's detailed
usages.  This fixes the link.

Link: https://lkml.kernel.org/r/20211022090311.3856-3-sj@kernel.org
Signed-off-by: SeongJae Park 
Cc: Jonathan Corbet 
Cc: Peter Xu 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

Docs/admin-guide/mm/damon/start: fix wrong example commands

2021-11-06T20:30:46+00:00

Patch series "Fix trivial nits in Documentation/admin-guide/mm".

This patchset fixes trivial nits in admin guide documents for DAMON and
pagemap.

This patch (of 4):

Some of the example commands in DAMON getting started guide are
outdated, missing sudo, or just wrong.  This fixes those.

Link: https://lkml.kernel.org/r/20211022090311.3856-2-sj@kernel.org
Signed-off-by: SeongJae Park 
Cc: Jonathan Corbet 
Cc: Peter Xu 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

Documentation/admin-guide/mm/damon: add a document for DAMON_RECLAIM

2021-11-06T20:30:46+00:00

This adds an admin-guide document for DAMON-based Reclamation.

Link: https://lkml.kernel.org/r/20211019150731.16699-16-sj@kernel.org
Signed-off-by: SeongJae Park 
Cc: Amit Shah 
Cc: Benjamin Herrenschmidt 
Cc: David Hildenbrand 
Cc: David Rientjes 
Cc: David Woodhouse 
Cc: Greg Thelen 
Cc: Jonathan Cameron 
Cc: Jonathan Corbet 
Cc: Leonard Foerster 
Cc: Marco Elver 
Cc: Markus Boehme 
Cc: Shakeel Butt 
Cc: Shuah Khan 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

Docs/DAMON: document physical memory monitoring support

2021-11-06T20:30:45+00:00

This updates the DAMON documents for the physical memory address space
monitoring support.

Link: https://lkml.kernel.org/r/20211012205711.29216-8-sj@kernel.org
Signed-off-by: SeongJae Park 
Cc: Amit Shah 
Cc: Benjamin Herrenschmidt 
Cc: Brendan Higgins 
Cc: David Hildenbrand 
Cc: David Rienjes 
Cc: David Woodhouse 
Cc: Greg Thelen 
Cc: Jonathan Cameron 
Cc: Jonathan Corbet 
Cc: Leonard Foerster 
Cc: Marco Elver 
Cc: Markus Boehme 
Cc: Shakeel Butt 
Cc: Shuah Khan 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

Docs/admin-guide/mm/damon: document 'init_regions' feature

2021-11-06T20:30:44+00:00

This adds description of the 'init_regions' feature in the DAMON usage
document.

Link: https://lkml.kernel.org/r/20211012205711.29216-4-sj@kernel.org
Signed-off-by: SeongJae Park 
Cc: Amit Shah 
Cc: Benjamin Herrenschmidt 
Cc: Brendan Higgins 
Cc: David Hildenbrand 
Cc: David Rienjes 
Cc: David Woodhouse 
Cc: Greg Thelen 
Cc: Jonathan Cameron 
Cc: Jonathan Corbet 
Cc: Leonard Foerster 
Cc: Marco Elver 
Cc: Markus Boehme 
Cc: Shakeel Butt 
Cc: Shuah Khan 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

Docs/admin-guide/mm/damon: document DAMON-based Operation Schemes

2021-11-06T20:30:44+00:00

This adds the description of DAMON-based operation schemes in the DAMON
documents.

Link: https://lkml.kernel.org/r/20211001125604.29660-8-sj@kernel.org
Signed-off-by: SeongJae Park 
Cc: Amit Shah 
Cc: Benjamin Herrenschmidt 
Cc: David Hildenbrand 
Cc: David Rienjes 
Cc: David Woodhouse 
Cc: Greg Thelen 
Cc: Jonathan Cameron 
Cc: Jonathan Corbet 
Cc: Leonard Foerster 
Cc: Marco Elver 
Cc: Markus Boehme 
Cc: Shakeel Butt 
Cc: Shuah Khan 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

Documentation/vm: move user guides to admin-guide/mm/

2021-11-06T20:30:44+00:00

Most memory management user guide documents are in 'admin-guide/mm/',
but two of those are in 'vm/'.  This moves the two docs into
'admin-guide/mm' for easier documents finding.

Link: https://lkml.kernel.org/r/20210917123958.3819-2-sj@kernel.org
Signed-off-by: SeongJae Park 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

memory-hotplug.rst: document the "auto-movable" online policy

2021-11-06T20:30:42+00:00

Commit e83a437faa62 ("mm/memory_hotplug: introduce "auto-movable" online
policy") introduced a new memory online policy to automatically select a
zone for memory blocks to be onlined.  It added a way to set the active
online policy and tunables for the auto-movable online policy.

Follow-up commits tweaked the "auto-movable" policy to also consider
memory device details when selecting zones for memory blocks to be
onlined.

Let's document the new toggles and how the two online policies we have
work.

[david@redhat.com: updates]
  Link: https://lkml.kernel.org/r/20211011082058.6076-4-david@redhat.com

Link: https://lkml.kernel.org/r/20210930144117.23641-4-david@redhat.com
Signed-off-by: David Hildenbrand 
Acked-by: Mike Rapoport 
Cc: Jonathan Corbet 
Cc: Michal Hocko 
Cc: Oscar Salvador 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds