include/linux/io-pgtable.h

1 /* SPDX-License-Identifier: GPL-2.0 */
6 #include <linux/iommu.h>
9  * Public API for use by IOMMU drivers
22  * struct iommu_flush_ops - IOMMU callbacks for TLB and page table management.
46  * struct io_pgtable_cfg - Configuration data for a set of page tables.
49  *                 action by the low-level page table allocator.
55  *                 by the IOMMU are coherent with the CPU caches.
64 	 *	even in	non-secure state where they should normally be ignored.
67 	 *	IOMMU_NOEXEC flags and map everything with full access, for
69 	 *	format, and/or requires some format-specific default value.
95 	/* Low-level data specific to the table format */
138  * struct io_pgtable_ops - Page table manipulation API for IOMMU drivers.
140  * @map:          Map a physically contiguous memory region.
141  * @map_pages:    Map a physically contiguous range of pages of the same size.
142  * @map_sg:       Map a scatter-gather list of physically contiguous memory
149  * These functions map directly onto the iommu_ops member functions with
153 	int (*map)(struct io_pgtable_ops *ops, unsigned long iova,  member
171  * alloc_io_pgtable_ops() - Allocate a page table allocator for use by an IOMMU.
177  * @cookie: An opaque token provided by the IOMMU driver and passed back to
178  *          the callback routines in cfg->tlb.
185  * free_io_pgtable_ops() - Free an io_pgtable_ops structure. The caller
199  * struct io_pgtable - Internal structure describing a set of page tables.
202  * @cookie: An opaque token provided by the IOMMU driver and passed back to
218 	if (iop->cfg.tlb && iop->cfg.tlb->tlb_flush_all)  in io_pgtable_tlb_flush_all()
219 		iop->cfg.tlb->tlb_flush_all(iop->cookie);  in io_pgtable_tlb_flush_all()
226 	if (iop->cfg.tlb && iop->cfg.tlb->tlb_flush_walk)  in io_pgtable_tlb_flush_walk()
227 		iop->cfg.tlb->tlb_flush_walk(iova, size, granule, iop->cookie);  in io_pgtable_tlb_flush_walk()
235 	if (iop->cfg.tlb && iop->cfg.tlb->tlb_add_page)  in io_pgtable_tlb_add_page()
236 		iop->cfg.tlb->tlb_add_page(gather, iova, granule, iop->cookie);  in io_pgtable_tlb_add_page()
240  * struct io_pgtable_init_fns - Alloc/free a set of page tables for a