1 // SPDX-License-Identifier: GPL-2.0 1
2
3 #ifndef _DRM_MANAGED_H_
4 #define _DRM_MANAGED_H_
5
6 #include <linux/gfp.h>
7 #include <linux/overflow.h>
8 #include <linux/types.h>
9
10 struct drm_device;
11 struct mutex;
12
13 typedef void (*drmres_release_t)(struct drm_de
14
15 /**
16 * drmm_add_action - add a managed release act
17 * @dev: DRM device
18 * @action: function which should be called wh
19 * @data: opaque pointer, passed to @action
20 *
21 * This function adds the @release action with
22 * list of cleanup actions for @dev. The clean
23 * order in the final drm_dev_put() call for @
24 */
25 #define drmm_add_action(dev, action, data) \
26 __drmm_add_action(dev, action, data, #
27
28 int __must_check __drmm_add_action(struct drm_
29 drmres_rele
30 void *data,
31
32 /**
33 * drmm_add_action_or_reset - add a managed re
34 * @dev: DRM device
35 * @action: function which should be called wh
36 * @data: opaque pointer, passed to @action
37 *
38 * Similar to drmm_add_action(), with the only
39 * @action is directly called for any cleanup
40 */
41 #define drmm_add_action_or_reset(dev, action,
42 __drmm_add_action_or_reset(dev, action
43
44 int __must_check __drmm_add_action_or_reset(st
45 dr
46 vo
47
48 void drmm_release_action(struct drm_device *de
49 drmres_release_t acti
50 void *data);
51
52 void *drmm_kmalloc(struct drm_device *dev, siz
53
54 /**
55 * drmm_kzalloc - &drm_device managed kzalloc(
56 * @dev: DRM device
57 * @size: size of the memory allocation
58 * @gfp: GFP allocation flags
59 *
60 * This is a &drm_device managed version of kz
61 * automatically freed on the final drm_dev_pu
62 * before the final drm_dev_put() by calling d
63 */
64 static inline void *drmm_kzalloc(struct drm_de
65 {
66 return drmm_kmalloc(dev, size, gfp | _
67 }
68
69 /**
70 * drmm_kmalloc_array - &drm_device managed km
71 * @dev: DRM device
72 * @n: number of array elements to allocate
73 * @size: size of array member
74 * @flags: GFP allocation flags
75 *
76 * This is a &drm_device managed version of km
77 * memory is automatically freed on the final
78 * like a memory allocation obtained by drmm_k
79 */
80 static inline void *drmm_kmalloc_array(struct
81 size_t
82 {
83 size_t bytes;
84
85 if (unlikely(check_mul_overflow(n, siz
86 return NULL;
87
88 return drmm_kmalloc(dev, bytes, flags)
89 }
90
91 /**
92 * drmm_kcalloc - &drm_device managed kcalloc(
93 * @dev: DRM device
94 * @n: number of array elements to allocate
95 * @size: size of array member
96 * @flags: GFP allocation flags
97 *
98 * This is a &drm_device managed version of kc
99 * automatically freed on the final drm_dev_pu
100 * memory allocation obtained by drmm_kmalloc(
101 */
102 static inline void *drmm_kcalloc(struct drm_de
103 size_t n, siz
104 {
105 return drmm_kmalloc_array(dev, n, size
106 }
107
108 char *drmm_kstrdup(struct drm_device *dev, con
109
110 void drmm_kfree(struct drm_device *dev, void *
111
112 void __drmm_mutex_release(struct drm_device *d
113
114 /**
115 * drmm_mutex_init - &drm_device-managed mutex
116 * @dev: DRM device
117 * @lock: lock to be initialized
118 *
119 * Returns:
120 * 0 on success, or a negative errno code othe
121 *
122 * This is a &drm_device-managed version of mu
123 * lock is automatically destroyed on the fina
124 */
125 #define drmm_mutex_init(dev, lock) ({
126 mutex_init(lock);
127 drmm_add_action_or_reset(dev, __drmm_m
128 })
129
130 #endif
131
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.