xref: /dflybsd-src/sys/dev/drm/drm_auth.c (revision 1dedbd3b06c68f627b7825694444529d5eb2b1bf)
12c9916cdSFrançois Tigeot /*
22c9916cdSFrançois Tigeot  * Created: Tue Feb  2 08:37:54 1999 by faith@valinux.com
32c9916cdSFrançois Tigeot  *
47f3c3d6fSHasso Tepper  * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
57f3c3d6fSHasso Tepper  * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
67f3c3d6fSHasso Tepper  * All Rights Reserved.
77f3c3d6fSHasso Tepper  *
8c9049281SFrançois Tigeot  * Author Rickard E. (Rik) Faith <faith@valinux.com>
9c9049281SFrançois Tigeot  * Author Gareth Hughes <gareth@valinux.com>
10c9049281SFrançois Tigeot  *
117f3c3d6fSHasso Tepper  * Permission is hereby granted, free of charge, to any person obtaining a
127f3c3d6fSHasso Tepper  * copy of this software and associated documentation files (the "Software"),
137f3c3d6fSHasso Tepper  * to deal in the Software without restriction, including without limitation
147f3c3d6fSHasso Tepper  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
157f3c3d6fSHasso Tepper  * and/or sell copies of the Software, and to permit persons to whom the
167f3c3d6fSHasso Tepper  * Software is furnished to do so, subject to the following conditions:
177f3c3d6fSHasso Tepper  *
187f3c3d6fSHasso Tepper  * The above copyright notice and this permission notice (including the next
197f3c3d6fSHasso Tepper  * paragraph) shall be included in all copies or substantial portions of the
207f3c3d6fSHasso Tepper  * Software.
217f3c3d6fSHasso Tepper  *
227f3c3d6fSHasso Tepper  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
237f3c3d6fSHasso Tepper  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
247f3c3d6fSHasso Tepper  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
257f3c3d6fSHasso Tepper  * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
267f3c3d6fSHasso Tepper  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
277f3c3d6fSHasso Tepper  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
287f3c3d6fSHasso Tepper  * OTHER DEALINGS IN THE SOFTWARE.
297f3c3d6fSHasso Tepper  */
307f3c3d6fSHasso Tepper 
3118e26a6dSFrançois Tigeot #include <drm/drmP.h>
322c9916cdSFrançois Tigeot #include "drm_internal.h"
33*1dedbd3bSFrançois Tigeot #include "drm_legacy.h"
347f3c3d6fSHasso Tepper 
357f3c3d6fSHasso Tepper /**
36*1dedbd3bSFrançois Tigeot  * DOC: master and authentication
379edbd4a0SFrançois Tigeot  *
38*1dedbd3bSFrançois Tigeot  * struct &drm_master is used to track groups of clients with open
39*1dedbd3bSFrançois Tigeot  * primary/legacy device nodes. For every struct &drm_file which has had at
40*1dedbd3bSFrançois Tigeot  * least once successfully became the device master (either through the
41*1dedbd3bSFrançois Tigeot  * SET_MASTER IOCTL, or implicitly through opening the primary device node when
42*1dedbd3bSFrançois Tigeot  * no one else is the current master that time) there exists one &drm_master.
43*1dedbd3bSFrançois Tigeot  * This is noted in the is_master member of &drm_file. All other clients have
44*1dedbd3bSFrançois Tigeot  * just a pointer to the &drm_master they are associated with.
459edbd4a0SFrançois Tigeot  *
46*1dedbd3bSFrançois Tigeot  * In addition only one &drm_master can be the current master for a &drm_device.
47*1dedbd3bSFrançois Tigeot  * It can be switched through the DROP_MASTER and SET_MASTER IOCTL, or
48*1dedbd3bSFrançois Tigeot  * implicitly through closing/openeing the primary device node. See also
49*1dedbd3bSFrançois Tigeot  * drm_is_current_master().
50*1dedbd3bSFrançois Tigeot  *
51*1dedbd3bSFrançois Tigeot  * Clients can authenticate against the current master (if it matches their own)
52*1dedbd3bSFrançois Tigeot  * using the GETMAGIC and AUTHMAGIC IOCTLs. Together with exchanging masters,
53*1dedbd3bSFrançois Tigeot  * this allows controlled access to the device for an entire group of mutually
54*1dedbd3bSFrançois Tigeot  * trusted clients.
557f3c3d6fSHasso Tepper  */
56*1dedbd3bSFrançois Tigeot 
57b3705d71SHasso Tepper int drm_getmagic(struct drm_device *dev, void *data, struct drm_file *file_priv)
587f3c3d6fSHasso Tepper {
59b3705d71SHasso Tepper 	struct drm_auth *auth = data;
60c9049281SFrançois Tigeot 	int ret = 0;
617f3c3d6fSHasso Tepper 
62*1dedbd3bSFrançois Tigeot 	mutex_lock(&dev->master_mutex);
63c9049281SFrançois Tigeot 	if (!file_priv->magic) {
64c9049281SFrançois Tigeot 		ret = idr_alloc(&dev->magic_map, file_priv,
65c9049281SFrançois Tigeot 				1, 0, GFP_KERNEL);
66c9049281SFrançois Tigeot 		if (ret >= 0)
67c9049281SFrançois Tigeot 			file_priv->magic = ret;
687f3c3d6fSHasso Tepper 	}
69c9049281SFrançois Tigeot 	auth->magic = file_priv->magic;
70*1dedbd3bSFrançois Tigeot 	mutex_unlock(&dev->master_mutex);
717f3c3d6fSHasso Tepper 
727f3c3d6fSHasso Tepper 	DRM_DEBUG("%u\n", auth->magic);
737f3c3d6fSHasso Tepper 
74c9049281SFrançois Tigeot 	return ret < 0 ? ret : 0;
757f3c3d6fSHasso Tepper }
767f3c3d6fSHasso Tepper 
77b3705d71SHasso Tepper int drm_authmagic(struct drm_device *dev, void *data,
78b3705d71SHasso Tepper 		  struct drm_file *file_priv)
797f3c3d6fSHasso Tepper {
80b3705d71SHasso Tepper 	struct drm_auth *auth = data;
81ba55f2f5SFrançois Tigeot 	struct drm_file *file;
827f3c3d6fSHasso Tepper 
837f3c3d6fSHasso Tepper 	DRM_DEBUG("%u\n", auth->magic);
848b983a81SFrançois Tigeot 
85*1dedbd3bSFrançois Tigeot 	mutex_lock(&dev->master_mutex);
86c9049281SFrançois Tigeot 	file = idr_find(&dev->magic_map, auth->magic);
878b983a81SFrançois Tigeot 	if (file) {
88ba55f2f5SFrançois Tigeot 		file->authenticated = 1;
89c9049281SFrançois Tigeot 		idr_replace(&dev->magic_map, NULL, auth->magic);
907f3c3d6fSHasso Tepper 	}
91*1dedbd3bSFrançois Tigeot 	mutex_unlock(&dev->master_mutex);
928b983a81SFrançois Tigeot 
938b983a81SFrançois Tigeot 	return file ? 0 : -EINVAL;
947f3c3d6fSHasso Tepper }
95*1dedbd3bSFrançois Tigeot 
96*1dedbd3bSFrançois Tigeot static struct drm_master *drm_master_create(struct drm_device *dev)
97*1dedbd3bSFrançois Tigeot {
98*1dedbd3bSFrançois Tigeot 	struct drm_master *master;
99*1dedbd3bSFrançois Tigeot 
100*1dedbd3bSFrançois Tigeot 	master = kzalloc(sizeof(*master), GFP_KERNEL);
101*1dedbd3bSFrançois Tigeot 	if (!master)
102*1dedbd3bSFrançois Tigeot 		return NULL;
103*1dedbd3bSFrançois Tigeot 
104*1dedbd3bSFrançois Tigeot 	kref_init(&master->refcount);
105*1dedbd3bSFrançois Tigeot 	spin_init(&master->lock.spinlock, "drmmls");
106*1dedbd3bSFrançois Tigeot 	init_waitqueue_head(&master->lock.lock_queue);
107*1dedbd3bSFrançois Tigeot 	idr_init(&master->magic_map);
108*1dedbd3bSFrançois Tigeot 	master->dev = dev;
109*1dedbd3bSFrançois Tigeot 
110*1dedbd3bSFrançois Tigeot 	return master;
111*1dedbd3bSFrançois Tigeot }
112*1dedbd3bSFrançois Tigeot 
113*1dedbd3bSFrançois Tigeot static int drm_set_master(struct drm_device *dev, struct drm_file *fpriv,
114*1dedbd3bSFrançois Tigeot 			  bool new_master)
115*1dedbd3bSFrançois Tigeot {
116*1dedbd3bSFrançois Tigeot 	int ret = 0;
117*1dedbd3bSFrançois Tigeot 
118*1dedbd3bSFrançois Tigeot 	dev->master = drm_master_get(fpriv->master);
119*1dedbd3bSFrançois Tigeot 	if (dev->driver->master_set) {
120*1dedbd3bSFrançois Tigeot 		ret = dev->driver->master_set(dev, fpriv, new_master);
121*1dedbd3bSFrançois Tigeot 		if (unlikely(ret != 0)) {
122*1dedbd3bSFrançois Tigeot 			drm_master_put(&dev->master);
123*1dedbd3bSFrançois Tigeot 		}
124*1dedbd3bSFrançois Tigeot 	}
125*1dedbd3bSFrançois Tigeot 
126*1dedbd3bSFrançois Tigeot 	return ret;
127*1dedbd3bSFrançois Tigeot }
128*1dedbd3bSFrançois Tigeot 
129*1dedbd3bSFrançois Tigeot static int drm_new_set_master(struct drm_device *dev, struct drm_file *fpriv)
130*1dedbd3bSFrançois Tigeot {
131*1dedbd3bSFrançois Tigeot 	struct drm_master *old_master;
132*1dedbd3bSFrançois Tigeot 	int ret;
133*1dedbd3bSFrançois Tigeot 
134*1dedbd3bSFrançois Tigeot #if 0
135*1dedbd3bSFrançois Tigeot 	lockdep_assert_held_once(&dev->master_mutex);
136*1dedbd3bSFrançois Tigeot #endif
137*1dedbd3bSFrançois Tigeot 
138*1dedbd3bSFrançois Tigeot 	old_master = fpriv->master;
139*1dedbd3bSFrançois Tigeot 	fpriv->master = drm_master_create(dev);
140*1dedbd3bSFrançois Tigeot 	if (!fpriv->master) {
141*1dedbd3bSFrançois Tigeot 		fpriv->master = old_master;
142*1dedbd3bSFrançois Tigeot 		return -ENOMEM;
143*1dedbd3bSFrançois Tigeot 	}
144*1dedbd3bSFrançois Tigeot 
145*1dedbd3bSFrançois Tigeot 	if (dev->driver->master_create) {
146*1dedbd3bSFrançois Tigeot 		ret = dev->driver->master_create(dev, fpriv->master);
147*1dedbd3bSFrançois Tigeot 		if (ret)
148*1dedbd3bSFrançois Tigeot 			goto out_err;
149*1dedbd3bSFrançois Tigeot 	}
150*1dedbd3bSFrançois Tigeot 	fpriv->is_master = 1;
151*1dedbd3bSFrançois Tigeot 	fpriv->authenticated = 1;
152*1dedbd3bSFrançois Tigeot 
153*1dedbd3bSFrançois Tigeot 	ret = drm_set_master(dev, fpriv, true);
154*1dedbd3bSFrançois Tigeot 	if (ret)
155*1dedbd3bSFrançois Tigeot 		goto out_err;
156*1dedbd3bSFrançois Tigeot 
157*1dedbd3bSFrançois Tigeot 	if (old_master)
158*1dedbd3bSFrançois Tigeot 		drm_master_put(&old_master);
159*1dedbd3bSFrançois Tigeot 
160*1dedbd3bSFrançois Tigeot 	return 0;
161*1dedbd3bSFrançois Tigeot 
162*1dedbd3bSFrançois Tigeot out_err:
163*1dedbd3bSFrançois Tigeot 	/* drop references and restore old master on failure */
164*1dedbd3bSFrançois Tigeot 	drm_master_put(&fpriv->master);
165*1dedbd3bSFrançois Tigeot 	fpriv->master = old_master;
166*1dedbd3bSFrançois Tigeot 
167*1dedbd3bSFrançois Tigeot 	return ret;
168*1dedbd3bSFrançois Tigeot }
169*1dedbd3bSFrançois Tigeot 
170*1dedbd3bSFrançois Tigeot int drm_setmaster_ioctl(struct drm_device *dev, void *data,
171*1dedbd3bSFrançois Tigeot 			struct drm_file *file_priv)
172*1dedbd3bSFrançois Tigeot {
173*1dedbd3bSFrançois Tigeot 	int ret = 0;
174*1dedbd3bSFrançois Tigeot 
175*1dedbd3bSFrançois Tigeot 	mutex_lock(&dev->master_mutex);
176*1dedbd3bSFrançois Tigeot 	if (drm_is_current_master(file_priv))
177*1dedbd3bSFrançois Tigeot 		goto out_unlock;
178*1dedbd3bSFrançois Tigeot 
179*1dedbd3bSFrançois Tigeot 	if (dev->master) {
180*1dedbd3bSFrançois Tigeot 		ret = -EINVAL;
181*1dedbd3bSFrançois Tigeot 		goto out_unlock;
182*1dedbd3bSFrançois Tigeot 	}
183*1dedbd3bSFrançois Tigeot 
184*1dedbd3bSFrançois Tigeot 	if (!file_priv->master) {
185*1dedbd3bSFrançois Tigeot 		ret = -EINVAL;
186*1dedbd3bSFrançois Tigeot 		goto out_unlock;
187*1dedbd3bSFrançois Tigeot 	}
188*1dedbd3bSFrançois Tigeot 
189*1dedbd3bSFrançois Tigeot 	if (!file_priv->is_master) {
190*1dedbd3bSFrançois Tigeot 		ret = drm_new_set_master(dev, file_priv);
191*1dedbd3bSFrançois Tigeot 		goto out_unlock;
192*1dedbd3bSFrançois Tigeot 	}
193*1dedbd3bSFrançois Tigeot 
194*1dedbd3bSFrançois Tigeot 	ret = drm_set_master(dev, file_priv, false);
195*1dedbd3bSFrançois Tigeot out_unlock:
196*1dedbd3bSFrançois Tigeot 	mutex_unlock(&dev->master_mutex);
197*1dedbd3bSFrançois Tigeot 	return ret;
198*1dedbd3bSFrançois Tigeot }
199*1dedbd3bSFrançois Tigeot 
200*1dedbd3bSFrançois Tigeot static void drm_drop_master(struct drm_device *dev,
201*1dedbd3bSFrançois Tigeot 			    struct drm_file *fpriv)
202*1dedbd3bSFrançois Tigeot {
203*1dedbd3bSFrançois Tigeot 	if (dev->driver->master_drop)
204*1dedbd3bSFrançois Tigeot 		dev->driver->master_drop(dev, fpriv);
205*1dedbd3bSFrançois Tigeot 	drm_master_put(&dev->master);
206*1dedbd3bSFrançois Tigeot }
207*1dedbd3bSFrançois Tigeot 
208*1dedbd3bSFrançois Tigeot int drm_dropmaster_ioctl(struct drm_device *dev, void *data,
209*1dedbd3bSFrançois Tigeot 			 struct drm_file *file_priv)
210*1dedbd3bSFrançois Tigeot {
211*1dedbd3bSFrançois Tigeot 	int ret = -EINVAL;
212*1dedbd3bSFrançois Tigeot 
213*1dedbd3bSFrançois Tigeot 	mutex_lock(&dev->master_mutex);
214*1dedbd3bSFrançois Tigeot 	if (!drm_is_current_master(file_priv))
215*1dedbd3bSFrançois Tigeot 		goto out_unlock;
216*1dedbd3bSFrançois Tigeot 
217*1dedbd3bSFrançois Tigeot 	if (!dev->master)
218*1dedbd3bSFrançois Tigeot 		goto out_unlock;
219*1dedbd3bSFrançois Tigeot 
220*1dedbd3bSFrançois Tigeot 	ret = 0;
221*1dedbd3bSFrançois Tigeot 	drm_drop_master(dev, file_priv);
222*1dedbd3bSFrançois Tigeot out_unlock:
223*1dedbd3bSFrançois Tigeot 	mutex_unlock(&dev->master_mutex);
224*1dedbd3bSFrançois Tigeot 	return ret;
225*1dedbd3bSFrançois Tigeot }
226*1dedbd3bSFrançois Tigeot 
227*1dedbd3bSFrançois Tigeot int drm_master_open(struct drm_file *file_priv)
228*1dedbd3bSFrançois Tigeot {
229*1dedbd3bSFrançois Tigeot 	struct drm_device *dev = file_priv->minor->dev;
230*1dedbd3bSFrançois Tigeot 	int ret = 0;
231*1dedbd3bSFrançois Tigeot 
232*1dedbd3bSFrançois Tigeot 	/* if there is no current master make this fd it, but do not create
233*1dedbd3bSFrançois Tigeot 	 * any master object for render clients */
234*1dedbd3bSFrançois Tigeot 	mutex_lock(&dev->master_mutex);
235*1dedbd3bSFrançois Tigeot 	if (!dev->master)
236*1dedbd3bSFrançois Tigeot 		ret = drm_new_set_master(dev, file_priv);
237*1dedbd3bSFrançois Tigeot 	else
238*1dedbd3bSFrançois Tigeot 		file_priv->master = drm_master_get(dev->master);
239*1dedbd3bSFrançois Tigeot 	mutex_unlock(&dev->master_mutex);
240*1dedbd3bSFrançois Tigeot 
241*1dedbd3bSFrançois Tigeot 	return ret;
242*1dedbd3bSFrançois Tigeot }
243*1dedbd3bSFrançois Tigeot 
244*1dedbd3bSFrançois Tigeot void drm_master_release(struct drm_file *file_priv)
245*1dedbd3bSFrançois Tigeot {
246*1dedbd3bSFrançois Tigeot 	struct drm_device *dev = file_priv->minor->dev;
247*1dedbd3bSFrançois Tigeot 	struct drm_master *master = file_priv->master;
248*1dedbd3bSFrançois Tigeot 
249*1dedbd3bSFrançois Tigeot 	mutex_lock(&dev->master_mutex);
250*1dedbd3bSFrançois Tigeot 	if (file_priv->magic)
251*1dedbd3bSFrançois Tigeot 		idr_remove(&file_priv->master->magic_map, file_priv->magic);
252*1dedbd3bSFrançois Tigeot 
253*1dedbd3bSFrançois Tigeot 	if (!drm_is_current_master(file_priv))
254*1dedbd3bSFrançois Tigeot 		goto out;
255*1dedbd3bSFrançois Tigeot 
256*1dedbd3bSFrançois Tigeot 	if (drm_core_check_feature(dev, DRIVER_LEGACY)) {
257*1dedbd3bSFrançois Tigeot 		/*
258*1dedbd3bSFrançois Tigeot 		 * Since the master is disappearing, so is the
259*1dedbd3bSFrançois Tigeot 		 * possibility to lock.
260*1dedbd3bSFrançois Tigeot 		 */
261*1dedbd3bSFrançois Tigeot 		mutex_lock(&dev->struct_mutex);
262*1dedbd3bSFrançois Tigeot 		if (master->lock.hw_lock) {
263*1dedbd3bSFrançois Tigeot 			if (dev->sigdata.lock == master->lock.hw_lock)
264*1dedbd3bSFrançois Tigeot 				dev->sigdata.lock = NULL;
265*1dedbd3bSFrançois Tigeot 			master->lock.hw_lock = NULL;
266*1dedbd3bSFrançois Tigeot 			master->lock.file_priv = NULL;
267*1dedbd3bSFrançois Tigeot 			wake_up_interruptible_all(&master->lock.lock_queue);
268*1dedbd3bSFrançois Tigeot 		}
269*1dedbd3bSFrançois Tigeot 		mutex_unlock(&dev->struct_mutex);
270*1dedbd3bSFrançois Tigeot 	}
271*1dedbd3bSFrançois Tigeot 
272*1dedbd3bSFrançois Tigeot 	if (dev->master == file_priv->master)
273*1dedbd3bSFrançois Tigeot 		drm_drop_master(dev, file_priv);
274*1dedbd3bSFrançois Tigeot out:
275*1dedbd3bSFrançois Tigeot 	/* drop the master reference held by the file priv */
276*1dedbd3bSFrançois Tigeot 	if (file_priv->master)
277*1dedbd3bSFrançois Tigeot 		drm_master_put(&file_priv->master);
278*1dedbd3bSFrançois Tigeot 	mutex_unlock(&dev->master_mutex);
279*1dedbd3bSFrançois Tigeot }
280*1dedbd3bSFrançois Tigeot 
281*1dedbd3bSFrançois Tigeot /**
282*1dedbd3bSFrançois Tigeot  * drm_is_current_master - checks whether @priv is the current master
283*1dedbd3bSFrançois Tigeot  * @fpriv: DRM file private
284*1dedbd3bSFrançois Tigeot  *
285*1dedbd3bSFrançois Tigeot  * Checks whether @fpriv is current master on its device. This decides whether a
286*1dedbd3bSFrançois Tigeot  * client is allowed to run DRM_MASTER IOCTLs.
287*1dedbd3bSFrançois Tigeot  *
288*1dedbd3bSFrançois Tigeot  * Most of the modern IOCTL which require DRM_MASTER are for kernel modesetting
289*1dedbd3bSFrançois Tigeot  * - the current master is assumed to own the non-shareable display hardware.
290*1dedbd3bSFrançois Tigeot  */
291*1dedbd3bSFrançois Tigeot bool drm_is_current_master(struct drm_file *fpriv)
292*1dedbd3bSFrançois Tigeot {
293*1dedbd3bSFrançois Tigeot 	return fpriv->is_master;
294*1dedbd3bSFrançois Tigeot }
295*1dedbd3bSFrançois Tigeot EXPORT_SYMBOL(drm_is_current_master);
296*1dedbd3bSFrançois Tigeot 
297*1dedbd3bSFrançois Tigeot /**
298*1dedbd3bSFrançois Tigeot  * drm_master_get - reference a master pointer
299*1dedbd3bSFrançois Tigeot  * @master: struct &drm_master
300*1dedbd3bSFrançois Tigeot  *
301*1dedbd3bSFrançois Tigeot  * Increments the reference count of @master and returns a pointer to @master.
302*1dedbd3bSFrançois Tigeot  */
303*1dedbd3bSFrançois Tigeot struct drm_master *drm_master_get(struct drm_master *master)
304*1dedbd3bSFrançois Tigeot {
305*1dedbd3bSFrançois Tigeot 	kref_get(&master->refcount);
306*1dedbd3bSFrançois Tigeot 	return master;
307*1dedbd3bSFrançois Tigeot }
308*1dedbd3bSFrançois Tigeot EXPORT_SYMBOL(drm_master_get);
309*1dedbd3bSFrançois Tigeot 
310*1dedbd3bSFrançois Tigeot static void drm_master_destroy(struct kref *kref)
311*1dedbd3bSFrançois Tigeot {
312*1dedbd3bSFrançois Tigeot 	struct drm_master *master = container_of(kref, struct drm_master, refcount);
313*1dedbd3bSFrançois Tigeot 	struct drm_device *dev = master->dev;
314*1dedbd3bSFrançois Tigeot 
315*1dedbd3bSFrançois Tigeot 	if (dev->driver->master_destroy)
316*1dedbd3bSFrançois Tigeot 		dev->driver->master_destroy(dev, master);
317*1dedbd3bSFrançois Tigeot 
318*1dedbd3bSFrançois Tigeot 	drm_legacy_master_rmmaps(dev, master);
319*1dedbd3bSFrançois Tigeot 
320*1dedbd3bSFrançois Tigeot 	idr_destroy(&master->magic_map);
321*1dedbd3bSFrançois Tigeot 	kfree(master->unique);
322*1dedbd3bSFrançois Tigeot 	kfree(master);
323*1dedbd3bSFrançois Tigeot }
324*1dedbd3bSFrançois Tigeot 
325*1dedbd3bSFrançois Tigeot /**
326*1dedbd3bSFrançois Tigeot  * drm_master_put - unreference and clear a master pointer
327*1dedbd3bSFrançois Tigeot  * @master: pointer to a pointer of struct &drm_master
328*1dedbd3bSFrançois Tigeot  *
329*1dedbd3bSFrançois Tigeot  * This decrements the &drm_master behind @master and sets it to NULL.
330*1dedbd3bSFrançois Tigeot  */
331*1dedbd3bSFrançois Tigeot void drm_master_put(struct drm_master **master)
332*1dedbd3bSFrançois Tigeot {
333*1dedbd3bSFrançois Tigeot 	kref_put(&(*master)->refcount, drm_master_destroy);
334*1dedbd3bSFrançois Tigeot 	*master = NULL;
335*1dedbd3bSFrançois Tigeot }
336*1dedbd3bSFrançois Tigeot EXPORT_SYMBOL(drm_master_put);
337