mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-10-29 15:42:46 +00:00
92b64bd01f
kmap() and kmap_atomic() have been deprecated. kmap_local_page() should always be used in new code and the call sites of the two deprecated functions should be converted. This latter task can lead to errors if it is not carried out with the necessary attention to the context around and between the maps and unmaps. Therefore, add further information to the Highmem's documentation for the purpose to make it clearer that (1) kmap() and kmap_atomic() must not any longer be called in new code and (2) developers doing conversions from kmap() amd kmap_atomic() are expected to take care of the context around and between the maps and unmaps, in order to not break the code. Relevant parts of this patch have been taken from messages exchanged privately with Ira Weiny (thanks!). [fmdefrancesco@gmail.com: merge two sentences into one, per Bagas] Link: https://lkml.kernel.org/r/20230119123945.10471-1-fmdefrancesco@gmail.com Link: https://lkml.kernel.org/r/20221207225308.8290-1-fmdefrancesco@gmail.com Signed-off-by: Fabio M. De Francesco <fmdefrancesco@gmail.com> Cc: Ira Weiny <ira.weiny@intel.com> Cc: Jonathan Corbet <corbet@lwn.net> Cc: Mike Rapoport <rppt@linux.ibm.com> Cc: Peter Zijlstra <a.p.zijlstra@chello.nl> Cc: Sebastian Andrzej Siewior <bigeasy@linutronix.de> Cc: Thomas Gleixner <tglx@linutronix.de> Signed-off-by: Andrew Morton <akpm@linux-foundation.org> |
||
|---|---|---|
| .. | ||
| damon | ||
| active_mm.rst | ||
| arch_pgtable_helpers.rst | ||
| balance.rst | ||
| bootmem.rst | ||
| free_page_reporting.rst | ||
| frontswap.rst | ||
| highmem.rst | ||
| hmm.rst | ||
| hugetlbfs_reserv.rst | ||
| hwpoison.rst | ||
| index.rst | ||
| ksm.rst | ||
| memory-model.rst | ||
| mmu_notifier.rst | ||
| multigen_lru.rst | ||
| numa.rst | ||
| oom.rst | ||
| overcommit-accounting.rst | ||
| page_allocation.rst | ||
| page_cache.rst | ||
| page_frags.rst | ||
| page_migration.rst | ||
| page_owner.rst | ||
| page_reclaim.rst | ||
| page_table_check.rst | ||
| page_tables.rst | ||
| physical_memory.rst | ||
| process_addrs.rst | ||
| remap_file_pages.rst | ||
| shmfs.rst | ||
| slab.rst | ||
| slub.rst | ||
| split_page_table_lock.rst | ||
| swap.rst | ||
| transhuge.rst | ||
| unevictable-lru.rst | ||
| vmalloc.rst | ||
| vmalloced-kernel-stacks.rst | ||
| vmemmap_dedup.rst | ||
| z3fold.rst | ||
| zsmalloc.rst | ||