1 /*
2  * Copyright (C) 2008 Advanced Micro Devices, Inc.
3  *
4  * Author: Joerg Roedel <joerg.roedel@amd.com>
5  *
6  * This program is free software; you can redistribute it and/or modify it
7  * under the terms of the GNU General Public License version 2 as published
8  * by the Free Software Foundation.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
18  */
19 
20 #ifndef __DMA_DEBUG_H
21 #define __DMA_DEBUG_H
22 
23 #include <linux/types.h>
24 
25 struct device;
26 struct scatterlist;
27 struct bus_type;
28 
29 #ifdef CONFIG_DMA_API_DEBUG
30 
31 extern void dma_debug_add_bus(struct bus_type *bus);
32 
33 extern int dma_debug_resize_entries(u32 num_entries);
34 
35 extern void debug_dma_map_page(struct device *dev, struct page *page,
36 			       size_t offset, size_t size,
37 			       int direction, dma_addr_t dma_addr,
38 			       bool map_single);
39 
40 extern void debug_dma_mapping_error(struct device *dev, dma_addr_t dma_addr);
41 
42 extern void debug_dma_unmap_page(struct device *dev, dma_addr_t addr,
43 				 size_t size, int direction, bool map_single);
44 
45 extern void debug_dma_map_sg(struct device *dev, struct scatterlist *sg,
46 			     int nents, int mapped_ents, int direction);
47 
48 extern void debug_dma_unmap_sg(struct device *dev, struct scatterlist *sglist,
49 			       int nelems, int dir);
50 
51 extern void debug_dma_alloc_coherent(struct device *dev, size_t size,
52 				     dma_addr_t dma_addr, void *virt);
53 
54 extern void debug_dma_free_coherent(struct device *dev, size_t size,
55 				    void *virt, dma_addr_t addr);
56 
57 extern void debug_dma_map_resource(struct device *dev, phys_addr_t addr,
58 				   size_t size, int direction,
59 				   dma_addr_t dma_addr);
60 
61 extern void debug_dma_unmap_resource(struct device *dev, dma_addr_t dma_addr,
62 				     size_t size, int direction);
63 
64 extern void debug_dma_sync_single_for_cpu(struct device *dev,
65 					  dma_addr_t dma_handle, size_t size,
66 					  int direction);
67 
68 extern void debug_dma_sync_single_for_device(struct device *dev,
69 					     dma_addr_t dma_handle,
70 					     size_t size, int direction);
71 
72 extern void debug_dma_sync_single_range_for_cpu(struct device *dev,
73 						dma_addr_t dma_handle,
74 						unsigned long offset,
75 						size_t size,
76 						int direction);
77 
78 extern void debug_dma_sync_single_range_for_device(struct device *dev,
79 						   dma_addr_t dma_handle,
80 						   unsigned long offset,
81 						   size_t size, int direction);
82 
83 extern void debug_dma_sync_sg_for_cpu(struct device *dev,
84 				      struct scatterlist *sg,
85 				      int nelems, int direction);
86 
87 extern void debug_dma_sync_sg_for_device(struct device *dev,
88 					 struct scatterlist *sg,
89 					 int nelems, int direction);
90 
91 extern void debug_dma_dump_mappings(struct device *dev);
92 
93 extern void debug_dma_assert_idle(struct page *page);
94 
95 #else /* CONFIG_DMA_API_DEBUG */
96 
dma_debug_add_bus(struct bus_type * bus)97 static inline void dma_debug_add_bus(struct bus_type *bus)
98 {
99 }
100 
dma_debug_resize_entries(u32 num_entries)101 static inline int dma_debug_resize_entries(u32 num_entries)
102 {
103 	return 0;
104 }
105 
debug_dma_map_page(struct device * dev,struct page * page,size_t offset,size_t size,int direction,dma_addr_t dma_addr,bool map_single)106 static inline void debug_dma_map_page(struct device *dev, struct page *page,
107 				      size_t offset, size_t size,
108 				      int direction, dma_addr_t dma_addr,
109 				      bool map_single)
110 {
111 }
112 
debug_dma_mapping_error(struct device * dev,dma_addr_t dma_addr)113 static inline void debug_dma_mapping_error(struct device *dev,
114 					  dma_addr_t dma_addr)
115 {
116 }
117 
debug_dma_unmap_page(struct device * dev,dma_addr_t addr,size_t size,int direction,bool map_single)118 static inline void debug_dma_unmap_page(struct device *dev, dma_addr_t addr,
119 					size_t size, int direction,
120 					bool map_single)
121 {
122 }
123 
debug_dma_map_sg(struct device * dev,struct scatterlist * sg,int nents,int mapped_ents,int direction)124 static inline void debug_dma_map_sg(struct device *dev, struct scatterlist *sg,
125 				    int nents, int mapped_ents, int direction)
126 {
127 }
128 
debug_dma_unmap_sg(struct device * dev,struct scatterlist * sglist,int nelems,int dir)129 static inline void debug_dma_unmap_sg(struct device *dev,
130 				      struct scatterlist *sglist,
131 				      int nelems, int dir)
132 {
133 }
134 
debug_dma_alloc_coherent(struct device * dev,size_t size,dma_addr_t dma_addr,void * virt)135 static inline void debug_dma_alloc_coherent(struct device *dev, size_t size,
136 					    dma_addr_t dma_addr, void *virt)
137 {
138 }
139 
debug_dma_free_coherent(struct device * dev,size_t size,void * virt,dma_addr_t addr)140 static inline void debug_dma_free_coherent(struct device *dev, size_t size,
141 					   void *virt, dma_addr_t addr)
142 {
143 }
144 
debug_dma_map_resource(struct device * dev,phys_addr_t addr,size_t size,int direction,dma_addr_t dma_addr)145 static inline void debug_dma_map_resource(struct device *dev, phys_addr_t addr,
146 					  size_t size, int direction,
147 					  dma_addr_t dma_addr)
148 {
149 }
150 
debug_dma_unmap_resource(struct device * dev,dma_addr_t dma_addr,size_t size,int direction)151 static inline void debug_dma_unmap_resource(struct device *dev,
152 					    dma_addr_t dma_addr, size_t size,
153 					    int direction)
154 {
155 }
156 
debug_dma_sync_single_for_cpu(struct device * dev,dma_addr_t dma_handle,size_t size,int direction)157 static inline void debug_dma_sync_single_for_cpu(struct device *dev,
158 						 dma_addr_t dma_handle,
159 						 size_t size, int direction)
160 {
161 }
162 
debug_dma_sync_single_for_device(struct device * dev,dma_addr_t dma_handle,size_t size,int direction)163 static inline void debug_dma_sync_single_for_device(struct device *dev,
164 						    dma_addr_t dma_handle,
165 						    size_t size, int direction)
166 {
167 }
168 
debug_dma_sync_single_range_for_cpu(struct device * dev,dma_addr_t dma_handle,unsigned long offset,size_t size,int direction)169 static inline void debug_dma_sync_single_range_for_cpu(struct device *dev,
170 						       dma_addr_t dma_handle,
171 						       unsigned long offset,
172 						       size_t size,
173 						       int direction)
174 {
175 }
176 
debug_dma_sync_single_range_for_device(struct device * dev,dma_addr_t dma_handle,unsigned long offset,size_t size,int direction)177 static inline void debug_dma_sync_single_range_for_device(struct device *dev,
178 							  dma_addr_t dma_handle,
179 							  unsigned long offset,
180 							  size_t size,
181 							  int direction)
182 {
183 }
184 
debug_dma_sync_sg_for_cpu(struct device * dev,struct scatterlist * sg,int nelems,int direction)185 static inline void debug_dma_sync_sg_for_cpu(struct device *dev,
186 					     struct scatterlist *sg,
187 					     int nelems, int direction)
188 {
189 }
190 
debug_dma_sync_sg_for_device(struct device * dev,struct scatterlist * sg,int nelems,int direction)191 static inline void debug_dma_sync_sg_for_device(struct device *dev,
192 						struct scatterlist *sg,
193 						int nelems, int direction)
194 {
195 }
196 
debug_dma_dump_mappings(struct device * dev)197 static inline void debug_dma_dump_mappings(struct device *dev)
198 {
199 }
200 
debug_dma_assert_idle(struct page * page)201 static inline void debug_dma_assert_idle(struct page *page)
202 {
203 }
204 
205 #endif /* CONFIG_DMA_API_DEBUG */
206 
207 #endif /* __DMA_DEBUG_H */
208