xref: /linux-6.15/include/linux/swiotlb.h (revision 659431fc)
1 #ifndef __LINUX_SWIOTLB_H
2 #define __LINUX_SWIOTLB_H
3 
4 #include <linux/types.h>
5 
6 struct device;
7 struct dma_attrs;
8 struct scatterlist;
9 
10 extern int swiotlb_force;
11 
12 /*
13  * Maximum allowable number of contiguous slabs to map,
14  * must be a power of 2.  What is the appropriate value ?
15  * The complexity of {map,unmap}_single is linearly dependent on this value.
16  */
17 #define IO_TLB_SEGSIZE	128
18 
19 /*
20  * log of the size of each IO TLB slab.  The number of slabs is command line
21  * controllable.
22  */
23 #define IO_TLB_SHIFT 11
24 
25 extern void swiotlb_init(int verbose);
26 
27 extern void
28 *swiotlb_alloc_coherent(struct device *hwdev, size_t size,
29 			dma_addr_t *dma_handle, gfp_t flags);
30 
31 extern void
32 swiotlb_free_coherent(struct device *hwdev, size_t size,
33 		      void *vaddr, dma_addr_t dma_handle);
34 
35 extern dma_addr_t swiotlb_map_page(struct device *dev, struct page *page,
36 				   unsigned long offset, size_t size,
37 				   enum dma_data_direction dir,
38 				   struct dma_attrs *attrs);
39 extern void swiotlb_unmap_page(struct device *hwdev, dma_addr_t dev_addr,
40 			       size_t size, enum dma_data_direction dir,
41 			       struct dma_attrs *attrs);
42 
43 extern int
44 swiotlb_map_sg(struct device *hwdev, struct scatterlist *sg, int nents,
45 	       int direction);
46 
47 extern void
48 swiotlb_unmap_sg(struct device *hwdev, struct scatterlist *sg, int nents,
49 		 int direction);
50 
51 extern int
52 swiotlb_map_sg_attrs(struct device *hwdev, struct scatterlist *sgl, int nelems,
53 		     enum dma_data_direction dir, struct dma_attrs *attrs);
54 
55 extern void
56 swiotlb_unmap_sg_attrs(struct device *hwdev, struct scatterlist *sgl,
57 		       int nelems, enum dma_data_direction dir,
58 		       struct dma_attrs *attrs);
59 
60 extern void
61 swiotlb_sync_single_for_cpu(struct device *hwdev, dma_addr_t dev_addr,
62 			    size_t size, enum dma_data_direction dir);
63 
64 extern void
65 swiotlb_sync_sg_for_cpu(struct device *hwdev, struct scatterlist *sg,
66 			int nelems, enum dma_data_direction dir);
67 
68 extern void
69 swiotlb_sync_single_for_device(struct device *hwdev, dma_addr_t dev_addr,
70 			       size_t size, enum dma_data_direction dir);
71 
72 extern void
73 swiotlb_sync_sg_for_device(struct device *hwdev, struct scatterlist *sg,
74 			   int nelems, enum dma_data_direction dir);
75 
76 extern void
77 swiotlb_sync_single_range_for_cpu(struct device *hwdev, dma_addr_t dev_addr,
78 				  unsigned long offset, size_t size,
79 				  enum dma_data_direction dir);
80 
81 extern void
82 swiotlb_sync_single_range_for_device(struct device *hwdev, dma_addr_t dev_addr,
83 				     unsigned long offset, size_t size,
84 				     enum dma_data_direction dir);
85 
86 extern int
87 swiotlb_dma_mapping_error(struct device *hwdev, dma_addr_t dma_addr);
88 
89 extern int
90 swiotlb_dma_supported(struct device *hwdev, u64 mask);
91 
92 #ifdef CONFIG_SWIOTLB
93 extern void __init swiotlb_free(void);
94 #else
95 static inline void swiotlb_free(void) { }
96 #endif
97 
98 extern void swiotlb_print_info(void);
99 #endif /* __LINUX_SWIOTLB_H */
100