57  *  - GET_UNIQUE ioctl, implemented by drm_getunique is wrapped up in libdrm
59  *  - The libdrm drmSetBusid function is backed by the SET_UNIQUE ioctl. All
61  *  - The internal set_busid kernel functions and driver callbacks are
64  *  - Other ioctls and functions involved are named consistently.
71  * Now the actual horror story of how device lookup in drm works. At large,
72  * there's 2 different ways, either by busid, or by device driver name.
77  *    side-effect this fills out the unique name in the master structure.
78  * 2. Call GET_UNIQUE to read out the unique name from the master structure,
80  *    the next device node.
86  *    means the unique name for the master node just opening is _not_ filled
87  *    out. This despite that with current drm device nodes are always bound to
88  *    one device, and can't be runtime assigned like with drm 1.0.
89  * 2. Match driver name. If it mismatches, proceed to the next device node.
90  * 3. Call GET_UNIQUE, and check whether the unique name has length zero (by
92  *    libdrm skips and proceeds to the next device node. Probably this is just
93  *    copypasta from drm 1.0 times where a set unique name meant that the driver
97  * _not_ return a unique string when SET_VERSION hasn't been called yet,
98  * otherwise libdrm breaks. Even when that unique string can't ever change, and
99  * is totally irrelevant for actually opening the device because runtime
100  * assignable device instances were only support in drm 1.0, which is long dead.
108  * \param inode device inode.
114  * Copies the bus id from drm_device::unique into user space.
122 	mutex_lock(&dev->master_mutex);  in drm_getunique()
123 	master = file_priv->master;  in drm_getunique()
124 	if (u->unique_len >= master->unique_len) {  in drm_getunique()
125 		if (copy_to_user(u->unique, master->unique, master->unique_len)) {  in drm_getunique()
126 			mutex_unlock(&dev->master_mutex);  in drm_getunique()
127 			return -EFAULT;  in drm_getunique()
130 	u->unique_len = master->unique_len;  in drm_getunique()
131 	mutex_unlock(&dev->master_mutex);  in drm_getunique()
140 	kfree(master->unique);  in drm_unset_busid()
141 	master->unique = NULL;  in drm_unset_busid()
142 	master->unique_len = 0;  in drm_unset_busid()
147 	struct drm_master *master = file_priv->master;  in drm_set_busid()
150 	if (master->unique != NULL)  in drm_set_busid()
153 	if (dev->dev && dev_is_pci(dev->dev)) {  in drm_set_busid()
160 		WARN_ON(!dev->unique);  in drm_set_busid()
161 		master->unique = kstrdup(dev->unique, GFP_KERNEL);  in drm_set_busid()
162 		if (master->unique)  in drm_set_busid()
163 			master->unique_len = strlen(dev->unique);  in drm_set_busid()
172  * \param inode device inode.
188 	 * Hollowed-out getclient ioctl to keep some dead old drm tests/tools  in drm_getclient()
190 	 * get -EINVAL, hence this is the return value we need to hand back for  in drm_getclient()
198 	if (client->idx == 0) {  in drm_getclient()
199 		client->auth = file_priv->authenticated;  in drm_getclient()
200 		client->pid = task_pid_vnr(current);  in drm_getclient()
201 		client->uid = overflowuid;  in drm_getclient()
202 		client->magic = 0;  in drm_getclient()
203 		client->iocs = 0;  in drm_getclient()
207 		return -EINVAL;  in drm_getclient()
214  * \param inode device inode.
233  * Get device/driver capabilities
240 	req->value = 0;  in drm_getcap()
242 	/* Only some caps make sense with UMS/render-only drivers. */  in drm_getcap()
243 	switch (req->capability) {  in drm_getcap()
245 		req->value = 1;  in drm_getcap()
248 		req->value |= dev->driver->prime_fd_to_handle ? DRM_PRIME_CAP_IMPORT : 0;  in drm_getcap()
249 		req->value |= dev->driver->prime_handle_to_fd ? DRM_PRIME_CAP_EXPORT : 0;  in drm_getcap()
252 		req->value = drm_core_check_feature(dev, DRIVER_SYNCOBJ);  in drm_getcap()
255 		req->value = drm_core_check_feature(dev, DRIVER_SYNCOBJ_TIMELINE);  in drm_getcap()
261 		return -EOPNOTSUPP;  in drm_getcap()
263 	switch (req->capability) {  in drm_getcap()
265 		if (dev->driver->dumb_create)  in drm_getcap()
266 			req->value = 1;  in drm_getcap()
269 		req->value = 1;  in drm_getcap()
272 		req->value = dev->mode_config.preferred_depth;  in drm_getcap()
275 		req->value = dev->mode_config.prefer_shadow;  in drm_getcap()
278 		req->value = dev->mode_config.async_page_flip;  in drm_getcap()
281 		req->value = 1;  in drm_getcap()
283 			if (!crtc->funcs->page_flip_target)  in drm_getcap()
284 				req->value = 0;  in drm_getcap()
288 		if (dev->mode_config.cursor_width)  in drm_getcap()
289 			req->value = dev->mode_config.cursor_width;  in drm_getcap()
291 			req->value = 64;  in drm_getcap()
294 		if (dev->mode_config.cursor_height)  in drm_getcap()
295 			req->value = dev->mode_config.cursor_height;  in drm_getcap()
297 			req->value = 64;  in drm_getcap()
300 		req->value = !dev->mode_config.fb_modifiers_not_supported;  in drm_getcap()
303 		req->value = 1;  in drm_getcap()
306 		return -EINVAL;  in drm_getcap()
312  * Set device/driver capabilities
319 	/* No render-only settable capabilities for now */  in drm_setclientcap()
323 		return -EOPNOTSUPP;  in drm_setclientcap()
325 	switch (req->capability) {  in drm_setclientcap()
327 		if (req->value > 1)  in drm_setclientcap()
328 			return -EINVAL;  in drm_setclientcap()
329 		file_priv->stereo_allowed = req->value;  in drm_setclientcap()
332 		if (req->value > 1)  in drm_setclientcap()
333 			return -EINVAL;  in drm_setclientcap()
334 		file_priv->universal_planes = req->value;  in drm_setclientcap()
338 			return -EOPNOTSUPP;  in drm_setclientcap()
340 		if (current->comm[0] == 'X' && req->value == 1) {  in drm_setclientcap()
342 			return -EOPNOTSUPP;  in drm_setclientcap()
344 		if (req->value > 2)  in drm_setclientcap()
345 			return -EINVAL;  in drm_setclientcap()
346 		file_priv->atomic = req->value;  in drm_setclientcap()
347 		file_priv->universal_planes = req->value;  in drm_setclientcap()
349 		 * No atomic user-space blows up on aspect ratio mode bits.  in drm_setclientcap()
351 		file_priv->aspect_ratio_allowed = req->value;  in drm_setclientcap()
354 		if (req->value > 1)  in drm_setclientcap()
355 			return -EINVAL;  in drm_setclientcap()
356 		file_priv->aspect_ratio_allowed = req->value;  in drm_setclientcap()
359 		if (!file_priv->atomic)  in drm_setclientcap()
360 			return -EINVAL;  in drm_setclientcap()
361 		if (req->value > 1)  in drm_setclientcap()
362 			return -EINVAL;  in drm_setclientcap()
363 		file_priv->writeback_connectors = req->value;  in drm_setclientcap()
366 		return -EINVAL;  in drm_setclientcap()
375  * \param inode device inode.
388 	mutex_lock(&dev->master_mutex);  in drm_setversion()
389 	if (sv->drm_di_major != -1) {  in drm_setversion()
390 		if (sv->drm_di_major != DRM_IF_MAJOR ||  in drm_setversion()
391 		    sv->drm_di_minor < 0 || sv->drm_di_minor > DRM_IF_MINOR) {  in drm_setversion()
392 			retcode = -EINVAL;  in drm_setversion()
395 		if_version = DRM_IF_VERSION(sv->drm_di_major,  in drm_setversion()
396 					    sv->drm_di_minor);  in drm_setversion()
397 		dev->if_version = max(if_version, dev->if_version);  in drm_setversion()
398 		if (sv->drm_di_minor >= 1) {  in drm_setversion()
400 			 * Version 1.1 includes tying of DRM to specific device  in drm_setversion()
409 	if (sv->drm_dd_major != -1) {  in drm_setversion()
410 		if (sv->drm_dd_major != dev->driver->major ||  in drm_setversion()
411 		    sv->drm_dd_minor < 0 || sv->drm_dd_minor >  in drm_setversion()
412 		    dev->driver->minor) {  in drm_setversion()
413 			retcode = -EINVAL;  in drm_setversion()
419 	sv->drm_di_major = DRM_IF_MAJOR;  in drm_setversion()
420 	sv->drm_di_minor = DRM_IF_MINOR;  in drm_setversion()
421 	sv->drm_dd_major = dev->driver->major;  in drm_setversion()
422 	sv->drm_dd_minor = dev->driver->minor;  in drm_setversion()
423 	mutex_unlock(&dev->master_mutex);  in drm_setversion()
429  * drm_noop - DRM no-op ioctl implementation
430  * @dev: DRM device for the ioctl
434  * This no-op implementation for drm ioctls is useful for deprecated
449  * drm_invalid_op - DRM invalid ioctl implementation
450  * @dev: DRM device for the ioctl
454  * This no-op implementation for drm ioctls is useful for deprecated
461  * Always fails with a return value of -EINVAL.
466 	return -EINVAL;  in drm_invalid_op()
489 	 * larger than the userspace-supplied buffer) */  in drm_copy_field()
495 			return -EFAULT;  in drm_copy_field()
502  * \param inode device inode.
516 	version->version_major = dev->driver->major;  in drm_version()
517 	version->version_minor = dev->driver->minor;  in drm_version()
518 	version->version_patchlevel = dev->driver->patchlevel;  in drm_version()
519 	err = drm_copy_field(version->name, &version->name_len,  in drm_version()
520 			dev->driver->name);  in drm_version()
522 		err = drm_copy_field(version->date, &version->date_len,  in drm_version()
523 				dev->driver->date);  in drm_version()
525 		err = drm_copy_field(version->desc, &version->desc_len,  in drm_version()
526 				dev->driver->desc);  in drm_version()
535 		return -EACCES;  in drm_ioctl_permit()
539 		     !file_priv->authenticated))  in drm_ioctl_permit()
540 		return -EACCES;  in drm_ioctl_permit()
545 		return -EACCES;  in drm_ioctl_permit()
550 		return -EACCES;  in drm_ioctl_permit()
745  * ``Documentation/process/botching-up-ioctls.rst``. Note that drm_ioctl()
746  * automatically zero-extends structures, hence make sure you can add more stuff
768  * the driver-specific IOCTLs are wired up.
774 	struct drm_file *file_priv = file->private_data;  in drm_ioctl_kernel()
775 	struct drm_device *dev = file_priv->minor->dev;  in drm_ioctl_kernel()
779 		return -ENODEV;  in drm_ioctl_kernel()
799  * drm_ioctl - ioctl callback implementation for DRM drivers
814 	struct drm_file *file_priv = filp->private_data;  in drm_ioctl()
819 	int retcode = -EINVAL;  in drm_ioctl()
825 	dev = file_priv->minor->dev;  in drm_ioctl()
828 		return -ENODEV;  in drm_ioctl()
831 		return -ENOTTY;  in drm_ioctl()
837 		unsigned int index = nr - DRM_COMMAND_BASE;  in drm_ioctl()
839 		if (index >= dev->driver->num_ioctls)  in drm_ioctl()
841 		index = array_index_nospec(index, dev->driver->num_ioctls);  in drm_ioctl()
842 		ioctl = &dev->driver->ioctls[index];  in drm_ioctl()
851 	drv_size = _IOC_SIZE(ioctl->cmd);  in drm_ioctl()
853 	if ((cmd & ioctl->cmd & IOC_IN) == 0)  in drm_ioctl()
855 	if ((cmd & ioctl->cmd & IOC_OUT) == 0)  in drm_ioctl()
860 		  current->comm, task_pid_nr(current),  in drm_ioctl()
861 		  (long)old_encode_dev(file_priv->minor->kdev->devt),  in drm_ioctl()
862 		  file_priv->authenticated, ioctl->name);  in drm_ioctl()
865 	func = ioctl->func;  in drm_ioctl()
869 		retcode = -EINVAL;  in drm_ioctl()
878 			retcode = -ENOMEM;  in drm_ioctl()
884 		retcode = -EFAULT;  in drm_ioctl()
889 		memset(kdata + in_size, 0, ksize - in_size);  in drm_ioctl()
891 	retcode = drm_ioctl_kernel(filp, func, kdata, ioctl->flags);  in drm_ioctl()
893 		retcode = -EFAULT;  in drm_ioctl()
898 			  current->comm, task_pid_nr(current),  in drm_ioctl()
899 			  (long)old_encode_dev(file_priv->minor->kdev->devt),  in drm_ioctl()
900 			  file_priv->authenticated, cmd, nr);  in drm_ioctl()
905 		DRM_DEBUG("comm=\"%s\", pid=%d, ret=%d\n", current->comm,  in drm_ioctl()
912  * drm_ioctl_flags - Check for core ioctl and return ioctl permission flags