Skip to content

highmem: Extend kmap_local_page() documentation

Fabio M. De Francesco linux-doc lkml 2 versions – Applied

Status from this message: [merged mm-stable] highmem-delete-a-sentence-from-kmap_local_page-kdocs.patch removed from -mm tree

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v2 Latest7 patches 0 repliesApplied 7/7
  2. v17 patches 3 repliesSuperseded

Patches in v2 All 7 applied

#Subject and filesSizeRepliesApplied
1/7highmem: Remove unneeded spaces in kmap_local_page() kdocsinclude/linux/highmem.h+1 -10 repliesApplied
2/7highmem: Specify that kmap_local_page() is callable from interruptsinclude/linux/highmem.h+1 -10 repliesApplied
3/7Documentation/mm: Don't kmap*() pages which can't come from HIGHMEMDocumentation/vm/highmem.rst+6 -00 repliesApplied
4/7Documentation/mm: Avoid invalid use of addresses from kmap_local_page()Documentation/vm/highmem.rst+7 -00 repliesApplied
5/7Documentation/mm: Prefer kmap_local_page() and avoid kmap()Documentation/vm/highmem.rst+5 -00 repliesApplied
6/7highmem: Delete a sentence from kmap_local_page() kdocsinclude/linux/highmem.h+1 -20 repliesApplied
7/7Documentation/mm: Add details about kmap_local_page() and preemptionDocumentation/vm/highmem.rst+9 -40 repliesApplied

Reviews trailers per patch

2 of 7 patches have a Reviewed-by or Acked-by.

PatchIra Weiny
1/7R-b
2/7
3/7
4/7
5/7
6/7R-b
7/7

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v2 thread

Cover letter [PATCH v2 0/7] highmem: Extend kmap_local_page() documentation

The Highmem's interface is evolving and the current documentation does not reflect the intended uses of each of the calls. Furthermore, after a recent series of reworks, the differences of the calls can still be confusing and may lead to the expanded use of calls which are deprecated.

This series is the second round of changes towards an enhanced documentation of the Highmem's interface; at this stage the patches are only focused to kmap_local_page().

In addition it also contains some minor clean ups.

Cc Andrew Morton <[email protected]>
Cc Matthew Wilcox (Oracle) <[email protected]>
Cc Mike Rapoport <[email protected]>
Cc Sebastian Andrzej Siewior <[email protected]>
Cc Thomas Gleixner <[email protected]>

v1->v2: According to a comment from Jonathan Corbet and some modifications suggested by Ira Weiny, change a couple of phrases in 3/7. 1,2,4-7/7 have no changes since v1.

Fabio M. De Francesco (7):
highmem: Remove unneeded spaces in kmap_local_page() kdocs
highmem: Specify that kmap_local_page() is callable from interrupts Documentation/mm: Don't kmap*() pages which can't come from HIGHMEM Documentation/mm: Avoid invalid use of addresses from
kmap_local_page()
Documentation/mm: Prefer kmap_local_page() and avoid kmap()
highmem: Delete a sentence from kmap_local_page() kdocs Documentation/mm: Add details about kmap_local_page() and preemption

 Documentation/vm/highmem.rst | 31 +++++++++++++++++++++++++++----
 include/linux/highmem.h      |  7 +++----
 2 files changed, 30 insertions(+), 8 deletions(-)
Signature · 1 line
2.37.1