xref: /openbsd/sys/dev/pci/drm/include/drm/drm_suballoc.h (revision f005ef32)
1 /* SPDX-License-Identifier: GPL-2.0 OR MIT */
2 /*
3  * Copyright 2011 Red Hat Inc.
4  * Copyright © 2022 Intel Corporation
5  */
6 #ifndef _DRM_SUBALLOC_H_
7 #define _DRM_SUBALLOC_H_
8 
9 #include <drm/drm_mm.h>
10 
11 #include <linux/dma-fence.h>
12 #include <linux/types.h>
13 
14 #define DRM_SUBALLOC_MAX_QUEUES 32
15 /**
16  * struct drm_suballoc_manager - fenced range allocations
17  * @wq: Wait queue for sleeping allocations on contention.
18  * @hole: Pointer to first hole node.
19  * @olist: List of allocated ranges.
20  * @flist: Array[fence context hash] of queues of fenced allocated ranges.
21  * @size: Size of the managed range.
22  * @align: Default alignment for the managed range.
23  */
24 struct drm_suballoc_manager {
25 	wait_queue_head_t wq;
26 	struct list_head *hole;
27 	struct list_head olist;
28 	struct list_head flist[DRM_SUBALLOC_MAX_QUEUES];
29 	size_t size;
30 	size_t align;
31 };
32 
33 /**
34  * struct drm_suballoc - Sub-allocated range
35  * @olist: List link for list of allocated ranges.
36  * @flist: List linkk for the manager fenced allocated ranges queues.
37  * @manager: The drm_suballoc_manager.
38  * @soffset: Start offset.
39  * @eoffset: End offset + 1 so that @eoffset - @soffset = size.
40  * @dma_fence: The fence protecting the allocation.
41  */
42 struct drm_suballoc {
43 	struct list_head olist;
44 	struct list_head flist;
45 	struct drm_suballoc_manager *manager;
46 	size_t soffset;
47 	size_t eoffset;
48 	struct dma_fence *fence;
49 };
50 
51 void drm_suballoc_manager_init(struct drm_suballoc_manager *sa_manager,
52 			       size_t size, size_t align);
53 
54 void drm_suballoc_manager_fini(struct drm_suballoc_manager *sa_manager);
55 
56 struct drm_suballoc *
57 drm_suballoc_new(struct drm_suballoc_manager *sa_manager, size_t size,
58 		 gfp_t gfp, bool intr, size_t align);
59 
60 void drm_suballoc_free(struct drm_suballoc *sa, struct dma_fence *fence);
61 
62 /**
63  * drm_suballoc_soffset - Range start.
64  * @sa: The struct drm_suballoc.
65  *
66  * Return: The start of the allocated range.
67  */
drm_suballoc_soffset(struct drm_suballoc * sa)68 static inline size_t drm_suballoc_soffset(struct drm_suballoc *sa)
69 {
70 	return sa->soffset;
71 }
72 
73 /**
74  * drm_suballoc_eoffset - Range end.
75  * @sa: The struct drm_suballoc.
76  *
77  * Return: The end of the allocated range + 1.
78  */
drm_suballoc_eoffset(struct drm_suballoc * sa)79 static inline size_t drm_suballoc_eoffset(struct drm_suballoc *sa)
80 {
81 	return sa->eoffset;
82 }
83 
84 /**
85  * drm_suballoc_size - Range size.
86  * @sa: The struct drm_suballoc.
87  *
88  * Return: The size of the allocated range.
89  */
drm_suballoc_size(struct drm_suballoc * sa)90 static inline size_t drm_suballoc_size(struct drm_suballoc *sa)
91 {
92 	return sa->eoffset - sa->soffset;
93 }
94 
95 #ifdef CONFIG_DEBUG_FS
96 void drm_suballoc_dump_debug_info(struct drm_suballoc_manager *sa_manager,
97 				  struct drm_printer *p,
98 				  unsigned long long suballoc_base);
99 #else
100 static inline void
drm_suballoc_dump_debug_info(struct drm_suballoc_manager * sa_manager,struct drm_printer * p,unsigned long long suballoc_base)101 drm_suballoc_dump_debug_info(struct drm_suballoc_manager *sa_manager,
102 			     struct drm_printer *p,
103 			     unsigned long long suballoc_base)
104 { }
105 
106 #endif
107 
108 #endif /* _DRM_SUBALLOC_H_ */
109