1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /* include/asm-generic/tlb.h
32  * Generic MMU-gather implementation.
49  *  - tlb_gather_mmu() / tlb_finish_mmu(); start and finish a mmu_gather
54  *  - tlb_start_vma() / tlb_end_vma(); marks the start / end of a VMA
59  *  - tlb_remove_table()
61  *    tlb_remove_table() is the basic primitive to free page-table directories
68  *  - tlb_remove_page() / __tlb_remove_page()
69  *  - tlb_remove_page_size() / __tlb_remove_page_size()
79  *  - tlb_change_page_size()
81  *    call before __tlb_remove_page*() to set the current page-size; implies a
84  *  - tlb_flush_mmu() / tlb_flush_mmu_tlbonly()
86  *    tlb_flush_mmu_tlbonly() - does the TLB invalidate (and resets
89  *    tlb_flush_mmu() - in addition to the above TLB invalidate, also frees
92  *  - mmu_gather::fullmm
97  *    - We can ignore tlb_{start,end}_vma(); because we don't
100  *    - (RISC) architectures that use ASIDs can cycle to a new ASID
103  *  - mmu_gather::need_flush_all
107  *    x86-PAE needs this when changing top-level entries.
114  *  - mmu_gather::start / mmu_gather::end
119  *  - mmu_gather::freed_tables
123  *  - tlb_get_unmap_shift() / tlb_get_unmap_size()
131  * Additionally there are a few opt-in features:
146  *  Useful if your architecture has non-page page directories.
153  *  Like MMU_GATHER_TABLE_FREE, and adds semi-RCU semantics to the free (see
157  *  and therefore doesn't naturally serialize with software page-table walkers.
185 	((PAGE_SIZE - sizeof(struct mmu_table_batch)) / sizeof(void *))
201  * This allows an architecture that does not use the linux page-tables for
220  * to work on, then just handle a few from the on-stack structure.
232 	((PAGE_SIZE - sizeof(struct mmu_gather_batch)) / sizeof(void *))
236  * lockups for non-preemptible kernels on huge machines when a lot of memory
309 	tlb->start = min(tlb->start, address);  in __tlb_adjust_range()
310 	tlb->end = max(tlb->end, address + range_size);  in __tlb_adjust_range()
315 	if (tlb->fullmm) {  in __tlb_reset_range()
316 		tlb->start = tlb->end = ~0;  in __tlb_reset_range()
318 		tlb->start = TASK_SIZE;  in __tlb_reset_range()
319 		tlb->end = 0;  in __tlb_reset_range()
321 	tlb->freed_tables = 0;  in __tlb_reset_range()
322 	tlb->cleared_ptes = 0;  in __tlb_reset_range()
323 	tlb->cleared_pmds = 0;  in __tlb_reset_range()
324 	tlb->cleared_puds = 0;  in __tlb_reset_range()
325 	tlb->cleared_p4ds = 0;  in __tlb_reset_range()
335 #if defined(tlb_flush) || defined(tlb_start_vma) || defined(tlb_end_vma)
349 	if (tlb->end)  in tlb_flush()
350 		flush_tlb_mm(tlb->mm);  in tlb_flush()
363 #if defined(tlb_start_vma) || defined(tlb_end_vma)
374 	if (tlb->fullmm || tlb->need_flush_all) {  in tlb_flush()
375 		flush_tlb_mm(tlb->mm);  in tlb_flush()
376 	} else if (tlb->end) {  in tlb_flush()
378 			.vm_mm = tlb->mm,  in tlb_flush()
379 			.vm_flags = (tlb->vma_exec ? VM_EXEC    : 0) |  in tlb_flush()
380 				    (tlb->vma_huge ? VM_HUGETLB : 0),  in tlb_flush()
383 		flush_tlb_range(&vma, tlb->start, tlb->end);  in tlb_flush()
392 	 * mips-4k) flush only large pages.  in tlb_update_vma_flags()
394 	 * flush_tlb_range() implementations that flush I-TLB also flush D-TLB  in tlb_update_vma_flags()
401 	tlb->vma_huge = is_vm_hugetlb_page(vma);  in tlb_update_vma_flags()
402 	tlb->vma_exec = !!(vma->vm_flags & VM_EXEC);  in tlb_update_vma_flags()
420 	if (!(tlb->freed_tables || tlb->cleared_ptes || tlb->cleared_pmds ||  in tlb_flush_mmu_tlbonly()
421 	      tlb->cleared_puds || tlb->cleared_p4ds))  in tlb_flush_mmu_tlbonly()
425 	mmu_notifier_invalidate_range(tlb->mm, tlb->start, tlb->end);  in tlb_flush_mmu_tlbonly()
454 	if (tlb->page_size && tlb->page_size != page_size) {  in tlb_change_page_size()
455 		if (!tlb->fullmm && !tlb->need_flush_all)  in tlb_change_page_size()
459 	tlb->page_size = page_size;  in tlb_change_page_size()
465 	if (tlb->cleared_ptes)  in tlb_get_unmap_shift()
467 	if (tlb->cleared_pmds)  in tlb_get_unmap_shift()
469 	if (tlb->cleared_puds)  in tlb_get_unmap_shift()
471 	if (tlb->cleared_p4ds)  in tlb_get_unmap_shift()
490 	if (tlb->fullmm)  in tlb_start_vma()
494 	flush_cache_range(vma, vma->vm_start, vma->vm_end);  in tlb_start_vma()
501 	if (tlb->fullmm)  in tlb_end_vma()
515  * tlb_flush_{pte|pmd|pud|p4d}_range() adjust the tlb->start and tlb->end,
522 	tlb->cleared_ptes = 1;  in tlb_flush_pte_range()
529 	tlb->cleared_pmds = 1;  in tlb_flush_pmd_range()
536 	tlb->cleared_puds = 1;  in tlb_flush_pud_range()
543 	tlb->cleared_p4ds = 1;  in tlb_flush_p4d_range()
551  * tlb_remove_tlb_entry - remember a pte unmapping for later tlb invalidation.
555  * userspace is unmapping already-unmapped pages, which happens quite a lot.
574  * tlb_remove_pmd_tlb_entry - remember a pmd mapping for later tlb invalidation
588  * tlb_remove_pud_tlb_entry - remember a pud mapping for later tlb
606  * architected non-legacy page table cache (which I'm not aware of
607  * anybody actually doing), you're going to have some architecturally
623 		tlb->freed_tables = 1;				\
632 		tlb->freed_tables = 1;				\
641 		tlb->freed_tables = 1;				\
650 		tlb->freed_tables = 1;				\