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