[mirror_ubuntu-bionic-kernel.git] / include / linux / dma-debug.h

/*
 * Copyright (C) 2008 Advanced Micro Devices, Inc.
 *
 * Author: Joerg Roedel <joerg.roedel@amd.com>
 *
 * This program is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 as published
 * by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
 */

#ifndef __DMA_DEBUG_H
#define __DMA_DEBUG_H

#include <linux/types.h>

struct device;
struct scatterlist;
struct bus_type;

#ifdef CONFIG_DMA_API_DEBUG

extern void dma_debug_add_bus(struct bus_type *bus);

extern void dma_debug_init(u32 num_entries);

extern int dma_debug_resize_entries(u32 num_entries);

extern void 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);

extern void debug_dma_mapping_error(struct device *dev, dma_addr_t dma_addr);

extern void debug_dma_unmap_page(struct device *dev, dma_addr_t addr,
				 size_t size, int direction, bool map_single);

extern void debug_dma_map_sg(struct device *dev, struct scatterlist *sg,
			     int nents, int mapped_ents, int direction);

extern void debug_dma_unmap_sg(struct device *dev, struct scatterlist *sglist,
			       int nelems, int dir);

extern void debug_dma_alloc_coherent(struct device *dev, size_t size,
				     dma_addr_t dma_addr, void *virt);

extern void debug_dma_free_coherent(struct device *dev, size_t size,
				    void *virt, dma_addr_t addr);

extern void debug_dma_map_resource(struct device *dev, phys_addr_t addr,
				   size_t size, int direction,
				   dma_addr_t dma_addr);

extern void debug_dma_unmap_resource(struct device *dev, dma_addr_t dma_addr,
				     size_t size, int direction);

extern void debug_dma_sync_single_for_cpu(struct device *dev,
					  dma_addr_t dma_handle, size_t size,
					  int direction);

extern void debug_dma_sync_single_for_device(struct device *dev,
					     dma_addr_t dma_handle,
					     size_t size, int direction);

extern void debug_dma_sync_single_range_for_cpu(struct device *dev,
						dma_addr_t dma_handle,
						unsigned long offset,
						size_t size,
						int direction);

extern void debug_dma_sync_single_range_for_device(struct device *dev,
						   dma_addr_t dma_handle,
						   unsigned long offset,
						   size_t size, int direction);

extern void debug_dma_sync_sg_for_cpu(struct device *dev,
				      struct scatterlist *sg,
				      int nelems, int direction);

extern void debug_dma_sync_sg_for_device(struct device *dev,
					 struct scatterlist *sg,
					 int nelems, int direction);

extern void debug_dma_dump_mappings(struct device *dev);

extern void debug_dma_assert_idle(struct page *page);

#else /* CONFIG_DMA_API_DEBUG */

static inline void dma_debug_add_bus(struct bus_type *bus)
{
}

static inline void dma_debug_init(u32 num_entries)
{
}

static inline int dma_debug_resize_entries(u32 num_entries)
{
	return 0;
}

static inline void 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)
{
}

static inline void debug_dma_mapping_error(struct device *dev,
					  dma_addr_t dma_addr)
{
}

static inline void debug_dma_unmap_page(struct device *dev, dma_addr_t addr,
					size_t size, int direction,
					bool map_single)
{
}

static inline void debug_dma_map_sg(struct device *dev, struct scatterlist *sg,
				    int nents, int mapped_ents, int direction)
{
}

static inline void debug_dma_unmap_sg(struct device *dev,
				      struct scatterlist *sglist,
				      int nelems, int dir)
{
}

static inline void debug_dma_alloc_coherent(struct device *dev, size_t size,
					    dma_addr_t dma_addr, void *virt)
{
}

static inline void debug_dma_free_coherent(struct device *dev, size_t size,
					   void *virt, dma_addr_t addr)
{
}

static inline void debug_dma_map_resource(struct device *dev, phys_addr_t addr,
					  size_t size, int direction,
					  dma_addr_t dma_addr)
{
}

static inline void debug_dma_unmap_resource(struct device *dev,
					    dma_addr_t dma_addr, size_t size,
					    int direction)
{
}

static inline void debug_dma_sync_single_for_cpu(struct device *dev,
						 dma_addr_t dma_handle,
						 size_t size, int direction)
{
}

static inline void debug_dma_sync_single_for_device(struct device *dev,
						    dma_addr_t dma_handle,
						    size_t size, int direction)
{
}

static inline void debug_dma_sync_single_range_for_cpu(struct device *dev,
						       dma_addr_t dma_handle,
						       unsigned long offset,
						       size_t size,
						       int direction)
{
}

static inline void debug_dma_sync_single_range_for_device(struct device *dev,
							  dma_addr_t dma_handle,
							  unsigned long offset,
							  size_t size,
							  int direction)
{
}

static inline void debug_dma_sync_sg_for_cpu(struct device *dev,
					     struct scatterlist *sg,
					     int nelems, int direction)
{
}

static inline void debug_dma_sync_sg_for_device(struct device *dev,
						struct scatterlist *sg,
						int nelems, int direction)
{
}

static inline void debug_dma_dump_mappings(struct device *dev)
{
}

static inline void debug_dma_assert_idle(struct page *page)
{
}

#endif /* CONFIG_DMA_API_DEBUG */

#endif /* __DMA_DEBUG_H */
Commit	Line	Data
f2f45e5f JR	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
6bf07871 JR	23	#include <linux/types.h>
6bf07871 JR	24
f2f45e5f	25	struct device;
972aa45c	26	struct scatterlist;
41531c8f	27	struct bus_type;
f2f45e5f	28
6bf07871 JR	29	#ifdef CONFIG_DMA_API_DEBUG
6bf07871 JR	30
41531c8f JR	31	extern void dma_debug_add_bus(struct bus_type *bus);
41531c8f JR	32
6bf07871 JR	33	extern void dma_debug_init(u32 num_entries);
6bf07871 JR	34
e6a1a89d FT	35	extern int dma_debug_resize_entries(u32 num_entries);
e6a1a89d FT	36
f62bc980 JR	37	extern void debug_dma_map_page(struct device dev, struct page page,
	38	size_t offset, size_t size,
	39	int direction, dma_addr_t dma_addr,
	40	bool map_single);
	41
6c9c6d63 SK	42	extern void debug_dma_mapping_error(struct device *dev, dma_addr_t dma_addr);
6c9c6d63 SK	43
f62bc980 JR	44	extern void debug_dma_unmap_page(struct device *dev, dma_addr_t addr,
	45	size_t size, int direction, bool map_single);
	46
972aa45c JR	47	extern void debug_dma_map_sg(struct device dev, struct scatterlist sg,
	48	int nents, int mapped_ents, int direction);
	49
	50	extern void debug_dma_unmap_sg(struct device dev, struct scatterlist sglist,
	51	int nelems, int dir);
f62bc980	52
6bfd4498 JR	53	extern void debug_dma_alloc_coherent(struct device *dev, size_t size,
	54	dma_addr_t dma_addr, void *virt);
	55
	56	extern void debug_dma_free_coherent(struct device *dev, size_t size,
	57	void *virt, dma_addr_t addr);
	58
0e74b34d NS	59	extern void debug_dma_map_resource(struct device *dev, phys_addr_t addr,
	60	size_t size, int direction,
	61	dma_addr_t dma_addr);
	62
	63	extern void debug_dma_unmap_resource(struct device *dev, dma_addr_t dma_addr,
	64	size_t size, int direction);
	65
b9d2317e JR	66	extern void debug_dma_sync_single_for_cpu(struct device *dev,
	67	dma_addr_t dma_handle, size_t size,
	68	int direction);
	69
	70	extern void debug_dma_sync_single_for_device(struct device *dev,
	71	dma_addr_t dma_handle,
	72	size_t size, int direction);
	73
948408ba JR	74	extern void debug_dma_sync_single_range_for_cpu(struct device *dev,
	75	dma_addr_t dma_handle,
	76	unsigned long offset,
	77	size_t size,
	78	int direction);
	79
	80	extern void debug_dma_sync_single_range_for_device(struct device *dev,
	81	dma_addr_t dma_handle,
	82	unsigned long offset,
	83	size_t size, int direction);
	84
a31fba5d JR	85	extern void debug_dma_sync_sg_for_cpu(struct device *dev,
	86	struct scatterlist *sg,
	87	int nelems, int direction);
	88
	89	extern void debug_dma_sync_sg_for_device(struct device *dev,
	90	struct scatterlist *sg,
	91	int nelems, int direction);
	92
ac26c18b DW	93	extern void debug_dma_dump_mappings(struct device *dev);
ac26c18b DW	94
0abdd7a8 DW	95	extern void debug_dma_assert_idle(struct page *page);
0abdd7a8 DW	96
6bf07871 JR	97	#else /* CONFIG_DMA_API_DEBUG */
6bf07871 JR	98
84be58d4	99	static inline void dma_debug_add_bus(struct bus_type *bus)
41531c8f JR	100	{
	101	}
	102
6bf07871 JR	103	static inline void dma_debug_init(u32 num_entries)
	104	{
	105	}
	106
e6a1a89d FT	107	static inline int dma_debug_resize_entries(u32 num_entries)
	108	{
	109	return 0;
	110	}
	111
f62bc980 JR	112	static inline void debug_dma_map_page(struct device dev, struct page page,
	113	size_t offset, size_t size,
	114	int direction, dma_addr_t dma_addr,
	115	bool map_single)
	116	{
	117	}
	118
6c9c6d63 SK	119	static inline void debug_dma_mapping_error(struct device *dev,
	120	dma_addr_t dma_addr)
	121	{
	122	}
	123
f62bc980 JR	124	static inline void debug_dma_unmap_page(struct device *dev, dma_addr_t addr,
	125	size_t size, int direction,
	126	bool map_single)
	127	{
	128	}
	129
972aa45c JR	130	static inline void debug_dma_map_sg(struct device dev, struct scatterlist sg,
	131	int nents, int mapped_ents, int direction)
	132	{
	133	}
	134
	135	static inline void debug_dma_unmap_sg(struct device *dev,
	136	struct scatterlist *sglist,
	137	int nelems, int dir)
	138	{
	139	}
f62bc980	140
6bfd4498 JR	141	static inline void debug_dma_alloc_coherent(struct device *dev, size_t size,
	142	dma_addr_t dma_addr, void *virt)
	143	{
	144	}
	145
	146	static inline void debug_dma_free_coherent(struct device *dev, size_t size,
	147	void *virt, dma_addr_t addr)
	148	{
	149	}
	150
0e74b34d NS	151	static inline void debug_dma_map_resource(struct device *dev, phys_addr_t addr,
	152	size_t size, int direction,
	153	dma_addr_t dma_addr)
	154	{
	155	}
	156
	157	static inline void debug_dma_unmap_resource(struct device *dev,
	158	dma_addr_t dma_addr, size_t size,
	159	int direction)
	160	{
	161	}
	162
b9d2317e JR	163	static inline void debug_dma_sync_single_for_cpu(struct device *dev,
	164	dma_addr_t dma_handle,
	165	size_t size, int direction)
	166	{
	167	}
	168
	169	static inline void debug_dma_sync_single_for_device(struct device *dev,
	170	dma_addr_t dma_handle,
	171	size_t size, int direction)
	172	{
	173	}
	174
948408ba JR	175	static inline void debug_dma_sync_single_range_for_cpu(struct device *dev,
	176	dma_addr_t dma_handle,
	177	unsigned long offset,
	178	size_t size,
	179	int direction)
	180	{
	181	}
	182
	183	static inline void debug_dma_sync_single_range_for_device(struct device *dev,
	184	dma_addr_t dma_handle,
	185	unsigned long offset,
	186	size_t size,
	187	int direction)
	188	{
	189	}
	190
a31fba5d JR	191	static inline void debug_dma_sync_sg_for_cpu(struct device *dev,
	192	struct scatterlist *sg,
	193	int nelems, int direction)
	194	{
	195	}
	196
	197	static inline void debug_dma_sync_sg_for_device(struct device *dev,
	198	struct scatterlist *sg,
	199	int nelems, int direction)
	200	{
	201	}
	202
ac26c18b DW	203	static inline void debug_dma_dump_mappings(struct device *dev)
	204	{
	205	}
	206
0abdd7a8 DW	207	static inline void debug_dma_assert_idle(struct page *page)
	208	{
	209	}
	210
6bf07871 JR	211	#endif /* CONFIG_DMA_API_DEBUG */
6bf07871 JR	212
f2f45e5f	213	#endif /* __DMA_DEBUG_H */