include/linux/io-pgtable.h

1 /* SPDX-License-Identifier: GPL-2.0 */
26  * struct iommu_flush_ops - IOMMU callbacks for TLB and page table management.
28  * @tlb_flush_all:  Synchronously invalidate the entire TLB context.
29  * @tlb_flush_walk: Synchronously invalidate all intermediate TLB state
32  * @tlb_add_page:   Optional callback to queue up leaf TLB invalidation for a
33  *                  single page.  IOMMUs that cannot batch TLB invalidation
50  * struct io_pgtable_cfg - Configuration data for a set of page tables.
53  *                 action by the low-level page table allocator.
60  * @tlb:           TLB management callbacks for this set of tables.
68 	 *	even in	non-secure state where they should normally be ignored.
73 	 *	format, and/or requires some format-specific default value.
84 	 *	for use in the upper half of a split address space.
86 	 * IO_PGTABLE_QUIRK_ARM_OUTER_WBWA: Override the outer-cacheability
87 	 *	attributes set in the TCR for a non-coherent page-table walker.
100 	const struct iommu_flush_ops	*tlb;  member
113 	 * passing a non-NULL value, make sure the chosen page format supports
119 	 * @free: Custom page de-allocator.
122 	 * hook. Must be non-NULL if @alloc is not NULL, must be NULL
127 	/* Low-level data specific to the table format */
175  * struct io_pgtable_ops - Page table manipulation API for IOMMU drivers.
200  * alloc_io_pgtable_ops() - Allocate a page table allocator for use by an IOMMU.
207  *          the callback routines in cfg->tlb.
214  * free_io_pgtable_ops() - Free an io_pgtable_ops structure. The caller
216  *                         live, but the TLB can be dirty.
228  * struct io_pgtable - Internal structure describing a set of page tables.
247 	if (iop->cfg.tlb && iop->cfg.tlb->tlb_flush_all)  in io_pgtable_tlb_flush_all()
248 		iop->cfg.tlb->tlb_flush_all(iop->cookie);  in io_pgtable_tlb_flush_all()
255 	if (iop->cfg.tlb && iop->cfg.tlb->tlb_flush_walk)  in io_pgtable_tlb_flush_walk()
256 		iop->cfg.tlb->tlb_flush_walk(iova, size, granule, iop->cookie);  in io_pgtable_tlb_flush_walk()
264 	if (iop->cfg.tlb && iop->cfg.tlb->tlb_add_page)  in io_pgtable_tlb_add_page()
265 		iop->cfg.tlb->tlb_add_page(gather, iova, granule, iop->cookie);  in io_pgtable_tlb_add_page()
269  * enum io_pgtable_caps - IO page table backend capabilities.
277  * struct io_pgtable_init_fns - Alloc/free a set of page tables for a