linux-stable.git/Documentation/vm, branch v5.2

mm: fix Documentation/vm/hmm.rst Sphinx warnings

2019-06-01T22:51:31+00:00

Fix Sphinx warnings in Documentation/vm/hmm.rst by using "::" notation and
inserting a blank line.  Also add a missing ';'.

  Documentation/vm/hmm.rst:292: WARNING: Unexpected indentation.
  Documentation/vm/hmm.rst:300: WARNING: Unexpected indentation.

Link: http://lkml.kernel.org/r/c5995359-7c82-4e47-c7be-b58a4dda0953@infradead.org
Fixes: 023a019a9b4e ("mm/hmm: add default fault flags to avoid the need to pre-fill pfns arrays")
Signed-off-by: Randy Dunlap 
Reviewed-by: Jérôme Glisse 
Reviewed-by: Mike Rapoport 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

mm/hmm: add default fault flags to avoid the need to pre-fill pfns arrays

2019-05-14T16:47:48+00:00

The HMM mirror API can be use in two fashions.  The first one where the
HMM user coalesce multiple page faults into one request and set flags per
pfns for of those faults.  The second one where the HMM user want to
pre-fault a range with specific flags.  For the latter one it is a waste
to have the user pre-fill the pfn arrays with a default flags value.

This patch adds a default flags value allowing user to set them for a
range without having to pre-fill the pfn array.

Link: http://lkml.kernel.org/r/20190403193318.16478-8-jglisse@redhat.com
Signed-off-by: Jérôme Glisse 
Reviewed-by: Ralph Campbell 
Cc: John Hubbard 
Cc: Dan Williams 
Cc: Arnd Bergmann 
Cc: Balbir Singh 
Cc: Dan Carpenter 
Cc: Ira Weiny 
Cc: Matthew Wilcox 
Cc: Souptick Joarder 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

mm/hmm: improve driver API to work and wait over a range

2019-05-14T16:47:48+00:00

A common use case for HMM mirror is user trying to mirror a range and
before they could program the hardware it get invalidated by some core mm
event.  Instead of having user re-try right away to mirror the range
provide a completion mechanism for them to wait for any active
invalidation affecting the range.

This also changes how hmm_range_snapshot() and hmm_range_fault() works by
not relying on vma so that we can drop the mmap_sem when waiting and
lookup the vma again on retry.

Link: http://lkml.kernel.org/r/20190403193318.16478-7-jglisse@redhat.com
Signed-off-by: Jérôme Glisse 
Reviewed-by: Ralph Campbell 
Cc: John Hubbard 
Cc: Dan Williams 
Cc: Dan Carpenter 
Cc: Matthew Wilcox 
Cc: Arnd Bergmann 
Cc: Balbir Singh 
Cc: Ira Weiny 
Cc: Souptick Joarder 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

mm/hmm: improve and rename hmm_vma_fault() to hmm_range_fault()

2019-05-14T16:47:48+00:00

Minor optimization around hmm_pte_need_fault().  Rename for consistency
between code, comments and documentation.  Also improves the comments on
all the possible returns values.  Improve the function by returning the
number of populated entries in pfns array.

Link: http://lkml.kernel.org/r/20190403193318.16478-6-jglisse@redhat.com
Signed-off-by: Jérôme Glisse 
Reviewed-by: Ralph Campbell 
Cc: John Hubbard 
Cc: Dan Williams 
Cc: Arnd Bergmann 
Cc: Balbir Singh 
Cc: Dan Carpenter 
Cc: Ira Weiny 
Cc: Matthew Wilcox 
Cc: Souptick Joarder 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

mm/hmm: improve and rename hmm_vma_get_pfns() to hmm_range_snapshot()

2019-05-14T16:47:48+00:00

Rename for consistency between code, comments and documentation.  Also
improves the comments on all the possible returns values.  Improve the
function by returning the number of populated entries in pfns array.

Link: http://lkml.kernel.org/r/20190403193318.16478-5-jglisse@redhat.com
Signed-off-by: Jérôme Glisse 
Reviewed-by: Ralph Campbell 
Reviewed-by: John Hubbard 
Reviewed-by: Ira Weiny 
Cc: Dan Williams 
Cc: Arnd Bergmann 
Cc: Balbir Singh 
Cc: Dan Carpenter 
Cc: Matthew Wilcox 
Cc: Souptick Joarder 
Signed-off-by: Andrew Morton 
Signed-off-by: Linus Torvalds

docs/vm: Minor editorial changes in the THP and hugetlbfs

2019-04-30T12:34:40+00:00

Some minor wording changes and typo corrections.

Signed-off-by: Ralph Campbell 
Acked-by: Randy Dunlap 
Acked-by: Mike Kravetz 
Cc: Mike Rapoport 
Signed-off-by: Jonathan Corbet

docs/vm: add documentation of memory models

2019-04-30T12:30:01+00:00

Describe what {FLAT,DISCONTIG,SPARSE}MEM are and how they manage to
maintain pfn <-> struct page correspondence.

Signed-off-by: Mike Rapoport 
Acked-by: Randy Dunlap 
Signed-off-by: Jonathan Corbet

doc: mm: migration doesn't use FOLL_SPLIT anymore

2019-04-19T18:48:06+00:00

When demonstrating FOLL_SPLIT in transhuge document, migration is used
as an example.  But, since commit 94723aafb9e7 ("mm: unclutter THP
migration"), the way of THP migration is totally changed.  FOLL_SPLIT is
not used by migration anymore due to the change.

Remove the obsolete example to avoid confusion.

Cc: Michal Hocko 
Cc: Kirill A. Shutemov 
Cc: Mike Rapoport 
Signed-off-by: Yang Shi 
Reviewed-by: Zi Yan 
Signed-off-by: Jonathan Corbet

docs: Use reference to link to rst file

2019-04-09T21:21:17+00:00

Current document includes the path to an RST doc file.  Since this is an
RST file we can make this a link.  Keeps the path as the link title
since that what the original author wrote.

Use reference to link to rst file.

Signed-off-by: Tobin C. Harding 
Signed-off-by: Jonathan Corbet

docs: Use underscore not hyphen in label

2019-02-01T23:04:01+00:00

sphinx emits warning

       WARNING: undefined label: memory-allocation ...

This seems to be caused by the use of a hyphen in the label name instead
of an underscore.  Using an underscore for the label name and the
reference clears the warning.

Use underscore not hyphen in label and reference.

Signed-off-by: Tobin C. Harding 
Signed-off-by: Jonathan Corbet