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 extern void swiotlb_init_with_tbl(char *tlb, unsigned long nslabs, int verbose);
27 
28 /*
29  * Enumeration for sync targets
30  */
31 enum dma_sync_target {
32 	SYNC_FOR_CPU = 0,
33 	SYNC_FOR_DEVICE = 1,
34 };
35 extern void *swiotlb_tbl_map_single(struct device *hwdev, dma_addr_t tbl_dma_addr,
36 				    phys_addr_t phys, size_t size,
37 				    enum dma_data_direction dir);
38 
39 extern void swiotlb_tbl_unmap_single(struct device *hwdev, char *dma_addr,
40 				     size_t size, enum dma_data_direction dir);
41 
42 extern void swiotlb_tbl_sync_single(struct device *hwdev, char *dma_addr,
43 				    size_t size, enum dma_data_direction dir,
44 				    enum dma_sync_target target);
45 
46 /* Accessory functions. */
47 extern void swiotlb_bounce(phys_addr_t phys, char *dma_addr, size_t size,
48 			   enum dma_data_direction dir);
49 
50 extern void
51 *swiotlb_alloc_coherent(struct device *hwdev, size_t size,
52 			dma_addr_t *dma_handle, gfp_t flags);
53 
54 extern void
55 swiotlb_free_coherent(struct device *hwdev, size_t size,
56 		      void *vaddr, dma_addr_t dma_handle);
57 
58 extern dma_addr_t swiotlb_map_page(struct device *dev, struct page *page,
59 				   unsigned long offset, size_t size,
60 				   enum dma_data_direction dir,
61 				   struct dma_attrs *attrs);
62 extern void swiotlb_unmap_page(struct device *hwdev, dma_addr_t dev_addr,
63 			       size_t size, enum dma_data_direction dir,
64 			       struct dma_attrs *attrs);
65 
66 extern int
67 swiotlb_map_sg(struct device *hwdev, struct scatterlist *sg, int nents,
68 	       enum dma_data_direction dir);
69 
70 extern void
71 swiotlb_unmap_sg(struct device *hwdev, struct scatterlist *sg, int nents,
72 		 enum dma_data_direction dir);
73 
74 extern int
75 swiotlb_map_sg_attrs(struct device *hwdev, struct scatterlist *sgl, int nelems,
76 		     enum dma_data_direction dir, struct dma_attrs *attrs);
77 
78 extern void
79 swiotlb_unmap_sg_attrs(struct device *hwdev, struct scatterlist *sgl,
80 		       int nelems, enum dma_data_direction dir,
81 		       struct dma_attrs *attrs);
82 
83 extern void
84 swiotlb_sync_single_for_cpu(struct device *hwdev, dma_addr_t dev_addr,
85 			    size_t size, enum dma_data_direction dir);
86 
87 extern void
88 swiotlb_sync_sg_for_cpu(struct device *hwdev, struct scatterlist *sg,
89 			int nelems, enum dma_data_direction dir);
90 
91 extern void
92 swiotlb_sync_single_for_device(struct device *hwdev, dma_addr_t dev_addr,
93 			       size_t size, enum dma_data_direction dir);
94 
95 extern void
96 swiotlb_sync_sg_for_device(struct device *hwdev, struct scatterlist *sg,
97 			   int nelems, enum dma_data_direction dir);
98 
99 extern int
100 swiotlb_dma_mapping_error(struct device *hwdev, dma_addr_t dma_addr);
101 
102 extern int
103 swiotlb_dma_supported(struct device *hwdev, u64 mask);
104 
105 #ifdef CONFIG_SWIOTLB
106 extern void __init swiotlb_free(void);
107 #else
swiotlb_free(void)108 static inline void swiotlb_free(void) { }
109 #endif
110 
111 extern void swiotlb_print_info(void);
112 #endif /* __LINUX_SWIOTLB_H */
113