1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * DMABUF Heaps Allocation Infrastructure
4  *
5  * Copyright (C) 2011 Google, Inc.
6  * Copyright (C) 2019 Linaro Ltd.
7  */
8 
9 #ifndef _DMA_HEAPS_H
10 #define _DMA_HEAPS_H
11 
12 #include <linux/cdev.h>
13 #include <linux/types.h>
14 
15 struct dma_heap;
16 
17 /**
18  * struct dma_heap_ops - ops to operate on a given heap
19  * @allocate:		allocate dmabuf and return struct dma_buf ptr
20  *
21  * allocate returns dmabuf on success, ERR_PTR(-errno) on error.
22  */
23 struct dma_heap_ops {
24 	struct dma_buf *(*allocate)(struct dma_heap *heap,
25 				    unsigned long len,
26 				    unsigned long fd_flags,
27 				    unsigned long heap_flags);
28 };
29 
30 /**
31  * struct dma_heap_export_info - information needed to export a new dmabuf heap
32  * @name:	used for debugging/device-node name
33  * @ops:	ops struct for this heap
34  * @priv:	heap exporter private data
35  *
36  * Information needed to export a new dmabuf heap.
37  */
38 struct dma_heap_export_info {
39 	const char *name;
40 	const struct dma_heap_ops *ops;
41 	void *priv;
42 };
43 
44 /**
45  * dma_heap_get_drvdata() - get per-heap driver data
46  * @heap: DMA-Heap to retrieve private data for
47  *
48  * Returns:
49  * The per-heap data for the heap.
50  */
51 void *dma_heap_get_drvdata(struct dma_heap *heap);
52 
53 /**
54  * dma_heap_get_name() - get heap name
55  * @heap: DMA-Heap to retrieve private data for
56  *
57  * Returns:
58  * The char* for the heap name.
59  */
60 const char *dma_heap_get_name(struct dma_heap *heap);
61 
62 /**
63  * dma_heap_add - adds a heap to dmabuf heaps
64  * @exp_info:		information needed to register this heap
65  */
66 struct dma_heap *dma_heap_add(const struct dma_heap_export_info *exp_info);
67 
68 #endif /* _DMA_HEAPS_H */
69