1 // SPDX-License-Identifier: GPL-2.0
3 * High memory handling common code and variables.
5 * (C) 1999 Andrea Arcangeli, SuSE GmbH, andrea@suse.de
6 * Gerhard Wichert, Siemens AG, Gerhard.Wichert@pdb.siemens.de
9 * Redesigned the x86 32-bit VM architecture to deal with
10 * 64-bit physical space. With current x86 CPUs this
11 * means up to 64 Gigabytes physical RAM.
13 * Rewrote high memory support to move the page cache into
14 * high memory. Implemented permanent (schedulable) kmaps
15 * based on Linus' idea.
17 * Copyright (C) 1999 Ingo Molnar <mingo@redhat.com>
21 #include <linux/export.h>
22 #include <linux/swap.h>
23 #include <linux/bio.h>
24 #include <linux/pagemap.h>
25 #include <linux/mempool.h>
26 #include <linux/init.h>
27 #include <linux/hash.h>
28 #include <linux/highmem.h>
29 #include <linux/kgdb.h>
30 #include <asm/tlbflush.h>
31 #include <linux/vmalloc.h>
33 #ifdef CONFIG_KMAP_LOCAL
34 static inline int kmap_local_calc_idx(int idx)
36 return idx + KM_MAX_IDX * smp_processor_id();
39 #ifndef arch_kmap_local_map_idx
40 #define arch_kmap_local_map_idx(idx, pfn) kmap_local_calc_idx(idx)
42 #endif /* CONFIG_KMAP_LOCAL */
45 * Virtual_count is not a pure "count".
46 * 0 means that it is not mapped, and has not been mapped
47 * since a TLB flush - it is usable.
48 * 1 means that there are no users, but it has been mapped
49 * since the last TLB flush - so we can't use it.
50 * n means that there are (n-1) current users of it.
55 * Architecture with aliasing data cache may define the following family of
56 * helper functions in its asm/highmem.h to control cache color of virtual
57 * addresses where physical memory pages are mapped by kmap.
59 #ifndef get_pkmap_color
62 * Determine color of virtual address where the page should be mapped.
64 static inline unsigned int get_pkmap_color(struct page *page)
68 #define get_pkmap_color get_pkmap_color
71 * Get next index for mapping inside PKMAP region for page with given color.
73 static inline unsigned int get_next_pkmap_nr(unsigned int color)
75 static unsigned int last_pkmap_nr;
77 last_pkmap_nr = (last_pkmap_nr + 1) & LAST_PKMAP_MASK;
82 * Determine if page index inside PKMAP region (pkmap_nr) of given color
83 * has wrapped around PKMAP region end. When this happens an attempt to
84 * flush all unused PKMAP slots is made.
86 static inline int no_more_pkmaps(unsigned int pkmap_nr, unsigned int color)
92 * Get the number of PKMAP entries of the given color. If no free slot is
93 * found after checking that many entries, kmap will sleep waiting for
94 * someone to call kunmap and free PKMAP slot.
96 static inline int get_pkmap_entries_count(unsigned int color)
102 * Get head of a wait queue for PKMAP entries of the given color.
103 * Wait queues for different mapping colors should be independent to avoid
104 * unnecessary wakeups caused by freeing of slots of other colors.
106 static inline wait_queue_head_t *get_pkmap_wait_queue_head(unsigned int color)
108 static DECLARE_WAIT_QUEUE_HEAD(pkmap_map_wait);
110 return &pkmap_map_wait;
114 atomic_long_t _totalhigh_pages __read_mostly;
115 EXPORT_SYMBOL(_totalhigh_pages);
117 unsigned int __nr_free_highpages(void)
120 unsigned int pages = 0;
122 for_each_populated_zone(zone) {
123 if (is_highmem(zone))
124 pages += zone_page_state(zone, NR_FREE_PAGES);
130 static int pkmap_count[LAST_PKMAP];
131 static __cacheline_aligned_in_smp DEFINE_SPINLOCK(kmap_lock);
133 pte_t *pkmap_page_table;
136 * Most architectures have no use for kmap_high_get(), so let's abstract
137 * the disabling of IRQ out of the locking in that case to save on a
138 * potential useless overhead.
140 #ifdef ARCH_NEEDS_KMAP_HIGH_GET
141 #define lock_kmap() spin_lock_irq(&kmap_lock)
142 #define unlock_kmap() spin_unlock_irq(&kmap_lock)
143 #define lock_kmap_any(flags) spin_lock_irqsave(&kmap_lock, flags)
144 #define unlock_kmap_any(flags) spin_unlock_irqrestore(&kmap_lock, flags)
146 #define lock_kmap() spin_lock(&kmap_lock)
147 #define unlock_kmap() spin_unlock(&kmap_lock)
148 #define lock_kmap_any(flags) \
149 do { spin_lock(&kmap_lock); (void)(flags); } while (0)
150 #define unlock_kmap_any(flags) \
151 do { spin_unlock(&kmap_lock); (void)(flags); } while (0)
154 struct page *__kmap_to_page(void *vaddr)
156 unsigned long base = (unsigned long) vaddr & PAGE_MASK;
157 struct kmap_ctrl *kctrl = ¤t->kmap_ctrl;
158 unsigned long addr = (unsigned long)vaddr;
161 /* kmap() mappings */
162 if (WARN_ON_ONCE(addr >= PKMAP_ADDR(0) &&
163 addr < PKMAP_ADDR(LAST_PKMAP)))
164 return pte_page(ptep_get(&pkmap_page_table[PKMAP_NR(addr)]));
166 /* kmap_local_page() mappings */
167 if (WARN_ON_ONCE(base >= __fix_to_virt(FIX_KMAP_END) &&
168 base < __fix_to_virt(FIX_KMAP_BEGIN))) {
169 for (i = 0; i < kctrl->idx; i++) {
170 unsigned long base_addr;
173 idx = arch_kmap_local_map_idx(i, pte_pfn(pteval));
174 base_addr = __fix_to_virt(FIX_KMAP_BEGIN + idx);
176 if (base_addr == base)
177 return pte_page(kctrl->pteval[i]);
181 return virt_to_page(vaddr);
183 EXPORT_SYMBOL(__kmap_to_page);
185 static void flush_all_zero_pkmaps(void)
192 for (i = 0; i < LAST_PKMAP; i++) {
197 * zero means we don't have anything to do,
198 * >1 means that it is still in use. Only
199 * a count of 1 means that it is free but
200 * needs to be unmapped
202 if (pkmap_count[i] != 1)
207 ptent = ptep_get(&pkmap_page_table[i]);
208 BUG_ON(pte_none(ptent));
211 * Don't need an atomic fetch-and-clear op here;
212 * no-one has the page mapped, and cannot get at
213 * its virtual address (and hence PTE) without first
214 * getting the kmap_lock (which is held here).
215 * So no dangers, even with speculative execution.
217 page = pte_page(ptent);
218 pte_clear(&init_mm, PKMAP_ADDR(i), &pkmap_page_table[i]);
220 set_page_address(page, NULL);
224 flush_tlb_kernel_range(PKMAP_ADDR(0), PKMAP_ADDR(LAST_PKMAP));
227 void __kmap_flush_unused(void)
230 flush_all_zero_pkmaps();
234 static inline unsigned long map_new_virtual(struct page *page)
238 unsigned int last_pkmap_nr;
239 unsigned int color = get_pkmap_color(page);
242 count = get_pkmap_entries_count(color);
243 /* Find an empty entry */
245 last_pkmap_nr = get_next_pkmap_nr(color);
246 if (no_more_pkmaps(last_pkmap_nr, color)) {
247 flush_all_zero_pkmaps();
248 count = get_pkmap_entries_count(color);
250 if (!pkmap_count[last_pkmap_nr])
251 break; /* Found a usable entry */
256 * Sleep for somebody else to unmap their entries
259 DECLARE_WAITQUEUE(wait, current);
260 wait_queue_head_t *pkmap_map_wait =
261 get_pkmap_wait_queue_head(color);
263 __set_current_state(TASK_UNINTERRUPTIBLE);
264 add_wait_queue(pkmap_map_wait, &wait);
267 remove_wait_queue(pkmap_map_wait, &wait);
270 /* Somebody else might have mapped it while we slept */
271 if (page_address(page))
272 return (unsigned long)page_address(page);
278 vaddr = PKMAP_ADDR(last_pkmap_nr);
279 set_pte_at(&init_mm, vaddr,
280 &(pkmap_page_table[last_pkmap_nr]), mk_pte(page, kmap_prot));
282 pkmap_count[last_pkmap_nr] = 1;
283 set_page_address(page, (void *)vaddr);
289 * kmap_high - map a highmem page into memory
290 * @page: &struct page to map
292 * Returns the page's virtual memory address.
294 * We cannot call this from interrupts, as it may block.
296 void *kmap_high(struct page *page)
301 * For highmem pages, we can't trust "virtual" until
302 * after we have the lock.
305 vaddr = (unsigned long)page_address(page);
307 vaddr = map_new_virtual(page);
308 pkmap_count[PKMAP_NR(vaddr)]++;
309 BUG_ON(pkmap_count[PKMAP_NR(vaddr)] < 2);
311 return (void *) vaddr;
313 EXPORT_SYMBOL(kmap_high);
315 #ifdef ARCH_NEEDS_KMAP_HIGH_GET
317 * kmap_high_get - pin a highmem page into memory
318 * @page: &struct page to pin
320 * Returns the page's current virtual memory address, or NULL if no mapping
321 * exists. If and only if a non null address is returned then a
322 * matching call to kunmap_high() is necessary.
324 * This can be called from any context.
326 void *kmap_high_get(struct page *page)
328 unsigned long vaddr, flags;
330 lock_kmap_any(flags);
331 vaddr = (unsigned long)page_address(page);
333 BUG_ON(pkmap_count[PKMAP_NR(vaddr)] < 1);
334 pkmap_count[PKMAP_NR(vaddr)]++;
336 unlock_kmap_any(flags);
337 return (void *) vaddr;
342 * kunmap_high - unmap a highmem page into memory
343 * @page: &struct page to unmap
345 * If ARCH_NEEDS_KMAP_HIGH_GET is not defined then this may be called
346 * only from user context.
348 void kunmap_high(struct page *page)
354 unsigned int color = get_pkmap_color(page);
355 wait_queue_head_t *pkmap_map_wait;
357 lock_kmap_any(flags);
358 vaddr = (unsigned long)page_address(page);
360 nr = PKMAP_NR(vaddr);
363 * A count must never go down to zero
364 * without a TLB flush!
367 switch (--pkmap_count[nr]) {
372 * Avoid an unnecessary wake_up() function call.
373 * The common case is pkmap_count[] == 1, but
375 * The tasks queued in the wait-queue are guarded
376 * by both the lock in the wait-queue-head and by
377 * the kmap_lock. As the kmap_lock is held here,
378 * no need for the wait-queue-head's lock. Simply
379 * test if the queue is empty.
381 pkmap_map_wait = get_pkmap_wait_queue_head(color);
382 need_wakeup = waitqueue_active(pkmap_map_wait);
384 unlock_kmap_any(flags);
386 /* do wake-up, if needed, race-free outside of the spin lock */
388 wake_up(pkmap_map_wait);
390 EXPORT_SYMBOL(kunmap_high);
392 void zero_user_segments(struct page *page, unsigned start1, unsigned end1,
393 unsigned start2, unsigned end2)
397 BUG_ON(end1 > page_size(page) || end2 > page_size(page));
404 for (i = 0; i < compound_nr(page); i++) {
407 if (start1 >= PAGE_SIZE) {
411 unsigned this_end = min_t(unsigned, end1, PAGE_SIZE);
414 kaddr = kmap_local_page(page + i);
415 memset(kaddr + start1, 0, this_end - start1);
421 if (start2 >= PAGE_SIZE) {
425 unsigned this_end = min_t(unsigned, end2, PAGE_SIZE);
429 kaddr = kmap_local_page(page + i);
430 memset(kaddr + start2, 0, this_end - start2);
438 flush_dcache_page(page + i);
445 BUG_ON((start1 | start2 | end1 | end2) != 0);
447 EXPORT_SYMBOL(zero_user_segments);
448 #endif /* CONFIG_HIGHMEM */
450 #ifdef CONFIG_KMAP_LOCAL
452 #include <asm/kmap_size.h>
455 * With DEBUG_KMAP_LOCAL the stack depth is doubled and every second
456 * slot is unused which acts as a guard page
458 #ifdef CONFIG_DEBUG_KMAP_LOCAL
464 static inline int kmap_local_idx_push(void)
466 WARN_ON_ONCE(in_hardirq() && !irqs_disabled());
467 current->kmap_ctrl.idx += KM_INCR;
468 BUG_ON(current->kmap_ctrl.idx >= KM_MAX_IDX);
469 return current->kmap_ctrl.idx - 1;
472 static inline int kmap_local_idx(void)
474 return current->kmap_ctrl.idx - 1;
477 static inline void kmap_local_idx_pop(void)
479 current->kmap_ctrl.idx -= KM_INCR;
480 BUG_ON(current->kmap_ctrl.idx < 0);
483 #ifndef arch_kmap_local_post_map
484 # define arch_kmap_local_post_map(vaddr, pteval) do { } while (0)
487 #ifndef arch_kmap_local_pre_unmap
488 # define arch_kmap_local_pre_unmap(vaddr) do { } while (0)
491 #ifndef arch_kmap_local_post_unmap
492 # define arch_kmap_local_post_unmap(vaddr) do { } while (0)
495 #ifndef arch_kmap_local_unmap_idx
496 #define arch_kmap_local_unmap_idx(idx, vaddr) kmap_local_calc_idx(idx)
499 #ifndef arch_kmap_local_high_get
500 static inline void *arch_kmap_local_high_get(struct page *page)
506 #ifndef arch_kmap_local_set_pte
507 #define arch_kmap_local_set_pte(mm, vaddr, ptep, ptev) \
508 set_pte_at(mm, vaddr, ptep, ptev)
511 /* Unmap a local mapping which was obtained by kmap_high_get() */
512 static inline bool kmap_high_unmap_local(unsigned long vaddr)
514 #ifdef ARCH_NEEDS_KMAP_HIGH_GET
515 if (vaddr >= PKMAP_ADDR(0) && vaddr < PKMAP_ADDR(LAST_PKMAP)) {
516 kunmap_high(pte_page(ptep_get(&pkmap_page_table[PKMAP_NR(vaddr)])));
523 static pte_t *__kmap_pte;
525 static pte_t *kmap_get_pte(unsigned long vaddr, int idx)
527 if (IS_ENABLED(CONFIG_KMAP_LOCAL_NON_LINEAR_PTE_ARRAY))
529 * Set by the arch if __kmap_pte[-idx] does not produce
532 return virt_to_kpte(vaddr);
534 __kmap_pte = virt_to_kpte(__fix_to_virt(FIX_KMAP_BEGIN));
535 return &__kmap_pte[-idx];
538 void *__kmap_local_pfn_prot(unsigned long pfn, pgprot_t prot)
540 pte_t pteval, *kmap_pte;
545 * Disable migration so resulting virtual address is stable
550 idx = arch_kmap_local_map_idx(kmap_local_idx_push(), pfn);
551 vaddr = __fix_to_virt(FIX_KMAP_BEGIN + idx);
552 kmap_pte = kmap_get_pte(vaddr, idx);
553 BUG_ON(!pte_none(ptep_get(kmap_pte)));
554 pteval = pfn_pte(pfn, prot);
555 arch_kmap_local_set_pte(&init_mm, vaddr, kmap_pte, pteval);
556 arch_kmap_local_post_map(vaddr, pteval);
557 current->kmap_ctrl.pteval[kmap_local_idx()] = pteval;
560 return (void *)vaddr;
562 EXPORT_SYMBOL_GPL(__kmap_local_pfn_prot);
564 void *__kmap_local_page_prot(struct page *page, pgprot_t prot)
569 * To broaden the usage of the actual kmap_local() machinery always map
570 * pages when debugging is enabled and the architecture has no problems
571 * with alias mappings.
573 if (!IS_ENABLED(CONFIG_DEBUG_KMAP_LOCAL_FORCE_MAP) && !PageHighMem(page))
574 return page_address(page);
576 /* Try kmap_high_get() if architecture has it enabled */
577 kmap = arch_kmap_local_high_get(page);
581 return __kmap_local_pfn_prot(page_to_pfn(page), prot);
583 EXPORT_SYMBOL(__kmap_local_page_prot);
585 void kunmap_local_indexed(const void *vaddr)
587 unsigned long addr = (unsigned long) vaddr & PAGE_MASK;
591 if (addr < __fix_to_virt(FIX_KMAP_END) ||
592 addr > __fix_to_virt(FIX_KMAP_BEGIN)) {
593 if (IS_ENABLED(CONFIG_DEBUG_KMAP_LOCAL_FORCE_MAP)) {
594 /* This _should_ never happen! See above. */
599 * Handle mappings which were obtained by kmap_high_get()
600 * first as the virtual address of such mappings is below
601 * PAGE_OFFSET. Warn for all other addresses which are in
602 * the user space part of the virtual address space.
604 if (!kmap_high_unmap_local(addr))
605 WARN_ON_ONCE(addr < PAGE_OFFSET);
610 idx = arch_kmap_local_unmap_idx(kmap_local_idx(), addr);
611 WARN_ON_ONCE(addr != __fix_to_virt(FIX_KMAP_BEGIN + idx));
613 kmap_pte = kmap_get_pte(addr, idx);
614 arch_kmap_local_pre_unmap(addr);
615 pte_clear(&init_mm, addr, kmap_pte);
616 arch_kmap_local_post_unmap(addr);
617 current->kmap_ctrl.pteval[kmap_local_idx()] = __pte(0);
618 kmap_local_idx_pop();
622 EXPORT_SYMBOL(kunmap_local_indexed);
625 * Invoked before switch_to(). This is safe even when during or after
626 * clearing the maps an interrupt which needs a kmap_local happens because
627 * the task::kmap_ctrl.idx is not modified by the unmapping code so a
628 * nested kmap_local will use the next unused index and restore the index
629 * on unmap. The already cleared kmaps of the outgoing task are irrelevant
630 * because the interrupt context does not know about them. The same applies
631 * when scheduling back in for an interrupt which happens before the
632 * restore is complete.
634 void __kmap_local_sched_out(void)
636 struct task_struct *tsk = current;
641 for (i = 0; i < tsk->kmap_ctrl.idx; i++) {
642 pte_t pteval = tsk->kmap_ctrl.pteval[i];
646 /* With debug all even slots are unmapped and act as guard */
647 if (IS_ENABLED(CONFIG_DEBUG_KMAP_LOCAL) && !(i & 0x01)) {
648 WARN_ON_ONCE(pte_val(pteval) != 0);
651 if (WARN_ON_ONCE(pte_none(pteval)))
655 * This is a horrible hack for XTENSA to calculate the
656 * coloured PTE index. Uses the PFN encoded into the pteval
657 * and the map index calculation because the actual mapped
658 * virtual address is not stored in task::kmap_ctrl.
659 * For any sane architecture this is optimized out.
661 idx = arch_kmap_local_map_idx(i, pte_pfn(pteval));
663 addr = __fix_to_virt(FIX_KMAP_BEGIN + idx);
664 kmap_pte = kmap_get_pte(addr, idx);
665 arch_kmap_local_pre_unmap(addr);
666 pte_clear(&init_mm, addr, kmap_pte);
667 arch_kmap_local_post_unmap(addr);
671 void __kmap_local_sched_in(void)
673 struct task_struct *tsk = current;
678 for (i = 0; i < tsk->kmap_ctrl.idx; i++) {
679 pte_t pteval = tsk->kmap_ctrl.pteval[i];
683 /* With debug all even slots are unmapped and act as guard */
684 if (IS_ENABLED(CONFIG_DEBUG_KMAP_LOCAL) && !(i & 0x01)) {
685 WARN_ON_ONCE(pte_val(pteval) != 0);
688 if (WARN_ON_ONCE(pte_none(pteval)))
691 /* See comment in __kmap_local_sched_out() */
692 idx = arch_kmap_local_map_idx(i, pte_pfn(pteval));
693 addr = __fix_to_virt(FIX_KMAP_BEGIN + idx);
694 kmap_pte = kmap_get_pte(addr, idx);
695 set_pte_at(&init_mm, addr, kmap_pte, pteval);
696 arch_kmap_local_post_map(addr, pteval);
700 void kmap_local_fork(struct task_struct *tsk)
702 if (WARN_ON_ONCE(tsk->kmap_ctrl.idx))
703 memset(&tsk->kmap_ctrl, 0, sizeof(tsk->kmap_ctrl));
708 #if defined(HASHED_PAGE_VIRTUAL)
710 #define PA_HASH_ORDER 7
713 * Describes one page->virtual association
715 struct page_address_map {
718 struct list_head list;
721 static struct page_address_map page_address_maps[LAST_PKMAP];
726 static struct page_address_slot {
727 struct list_head lh; /* List of page_address_maps */
728 spinlock_t lock; /* Protect this bucket's list */
729 } ____cacheline_aligned_in_smp page_address_htable[1<<PA_HASH_ORDER];
731 static struct page_address_slot *page_slot(const struct page *page)
733 return &page_address_htable[hash_ptr(page, PA_HASH_ORDER)];
737 * page_address - get the mapped virtual address of a page
738 * @page: &struct page to get the virtual address of
740 * Returns the page's virtual address.
742 void *page_address(const struct page *page)
746 struct page_address_slot *pas;
748 if (!PageHighMem(page))
749 return lowmem_page_address(page);
751 pas = page_slot(page);
753 spin_lock_irqsave(&pas->lock, flags);
754 if (!list_empty(&pas->lh)) {
755 struct page_address_map *pam;
757 list_for_each_entry(pam, &pas->lh, list) {
758 if (pam->page == page) {
765 spin_unlock_irqrestore(&pas->lock, flags);
768 EXPORT_SYMBOL(page_address);
771 * set_page_address - set a page's virtual address
772 * @page: &struct page to set
773 * @virtual: virtual address to use
775 void set_page_address(struct page *page, void *virtual)
778 struct page_address_slot *pas;
779 struct page_address_map *pam;
781 BUG_ON(!PageHighMem(page));
783 pas = page_slot(page);
784 if (virtual) { /* Add */
785 pam = &page_address_maps[PKMAP_NR((unsigned long)virtual)];
787 pam->virtual = virtual;
789 spin_lock_irqsave(&pas->lock, flags);
790 list_add_tail(&pam->list, &pas->lh);
791 spin_unlock_irqrestore(&pas->lock, flags);
792 } else { /* Remove */
793 spin_lock_irqsave(&pas->lock, flags);
794 list_for_each_entry(pam, &pas->lh, list) {
795 if (pam->page == page) {
796 list_del(&pam->list);
800 spin_unlock_irqrestore(&pas->lock, flags);
806 void __init page_address_init(void)
810 for (i = 0; i < ARRAY_SIZE(page_address_htable); i++) {
811 INIT_LIST_HEAD(&page_address_htable[i].lh);
812 spin_lock_init(&page_address_htable[i].lock);
816 #endif /* defined(HASHED_PAGE_VIRTUAL) */