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 = DRM_PRIME_CAP_IMPORT | DRM_PRIME_CAP_EXPORT;  in drm_getcap()
251 		req->value = drm_core_check_feature(dev, DRIVER_SYNCOBJ);  in drm_getcap()
254 		req->value = drm_core_check_feature(dev, DRIVER_SYNCOBJ_TIMELINE);  in drm_getcap()
260 		return -EOPNOTSUPP;  in drm_getcap()
262 	switch (req->capability) {  in drm_getcap()
264 		if (dev->driver->dumb_create)  in drm_getcap()
265 			req->value = 1;  in drm_getcap()
268 		req->value = 1;  in drm_getcap()
271 		req->value = dev->mode_config.preferred_depth;  in drm_getcap()
274 		req->value = dev->mode_config.prefer_shadow;  in drm_getcap()
277 		req->value = dev->mode_config.async_page_flip;  in drm_getcap()
280 		req->value = 1;  in drm_getcap()
282 			if (!crtc->funcs->page_flip_target)  in drm_getcap()
283 				req->value = 0;  in drm_getcap()
287 		if (dev->mode_config.cursor_width)  in drm_getcap()
288 			req->value = dev->mode_config.cursor_width;  in drm_getcap()
290 			req->value = 64;  in drm_getcap()
293 		if (dev->mode_config.cursor_height)  in drm_getcap()
294 			req->value = dev->mode_config.cursor_height;  in drm_getcap()
296 			req->value = 64;  in drm_getcap()
299 		req->value = !dev->mode_config.fb_modifiers_not_supported;  in drm_getcap()
302 		req->value = 1;  in drm_getcap()
305 		return -EINVAL;  in drm_getcap()
311  * Set device/driver capabilities
318 	/* No render-only settable capabilities for now */  in drm_setclientcap()
322 		return -EOPNOTSUPP;  in drm_setclientcap()
324 	switch (req->capability) {  in drm_setclientcap()
326 		if (req->value > 1)  in drm_setclientcap()
327 			return -EINVAL;  in drm_setclientcap()
328 		file_priv->stereo_allowed = req->value;  in drm_setclientcap()
331 		if (req->value > 1)  in drm_setclientcap()
332 			return -EINVAL;  in drm_setclientcap()
333 		file_priv->universal_planes = req->value;  in drm_setclientcap()
337 			return -EOPNOTSUPP;  in drm_setclientcap()
339 		if (current->comm[0] == 'X' && req->value == 1) {  in drm_setclientcap()
341 			return -EOPNOTSUPP;  in drm_setclientcap()
343 		if (req->value > 2)  in drm_setclientcap()
344 			return -EINVAL;  in drm_setclientcap()
345 		file_priv->atomic = req->value;  in drm_setclientcap()
346 		file_priv->universal_planes = req->value;  in drm_setclientcap()
348 		 * No atomic user-space blows up on aspect ratio mode bits.  in drm_setclientcap()
350 		file_priv->aspect_ratio_allowed = req->value;  in drm_setclientcap()
353 		if (req->value > 1)  in drm_setclientcap()
354 			return -EINVAL;  in drm_setclientcap()
355 		file_priv->aspect_ratio_allowed = req->value;  in drm_setclientcap()
358 		if (!file_priv->atomic)  in drm_setclientcap()
359 			return -EINVAL;  in drm_setclientcap()
360 		if (req->value > 1)  in drm_setclientcap()
361 			return -EINVAL;  in drm_setclientcap()
362 		file_priv->writeback_connectors = req->value;  in drm_setclientcap()
365 		return -EINVAL;  in drm_setclientcap()
374  * \param inode device inode.
387 	mutex_lock(&dev->master_mutex);  in drm_setversion()
388 	if (sv->drm_di_major != -1) {  in drm_setversion()
389 		if (sv->drm_di_major != DRM_IF_MAJOR ||  in drm_setversion()
390 		    sv->drm_di_minor < 0 || sv->drm_di_minor > DRM_IF_MINOR) {  in drm_setversion()
391 			retcode = -EINVAL;  in drm_setversion()
394 		if_version = DRM_IF_VERSION(sv->drm_di_major,  in drm_setversion()
395 					    sv->drm_di_minor);  in drm_setversion()
396 		dev->if_version = max(if_version, dev->if_version);  in drm_setversion()
397 		if (sv->drm_di_minor >= 1) {  in drm_setversion()
399 			 * Version 1.1 includes tying of DRM to specific device  in drm_setversion()
408 	if (sv->drm_dd_major != -1) {  in drm_setversion()
409 		if (sv->drm_dd_major != dev->driver->major ||  in drm_setversion()
410 		    sv->drm_dd_minor < 0 || sv->drm_dd_minor >  in drm_setversion()
411 		    dev->driver->minor) {  in drm_setversion()
412 			retcode = -EINVAL;  in drm_setversion()
418 	sv->drm_di_major = DRM_IF_MAJOR;  in drm_setversion()
419 	sv->drm_di_minor = DRM_IF_MINOR;  in drm_setversion()
420 	sv->drm_dd_major = dev->driver->major;  in drm_setversion()
421 	sv->drm_dd_minor = dev->driver->minor;  in drm_setversion()
422 	mutex_unlock(&dev->master_mutex);  in drm_setversion()
428  * drm_noop - DRM no-op ioctl implementation
429  * @dev: DRM device for the ioctl
433  * This no-op implementation for drm ioctls is useful for deprecated
448  * drm_invalid_op - DRM invalid ioctl implementation
449  * @dev: DRM device for the ioctl
453  * This no-op implementation for drm ioctls is useful for deprecated
460  * Always fails with a return value of -EINVAL.
465 	return -EINVAL;  in drm_invalid_op()
488 	 * larger than the userspace-supplied buffer) */  in drm_copy_field()
494 			return -EFAULT;  in drm_copy_field()
501  * \param inode device inode.
515 	version->version_major = dev->driver->major;  in drm_version()
516 	version->version_minor = dev->driver->minor;  in drm_version()
517 	version->version_patchlevel = dev->driver->patchlevel;  in drm_version()
518 	err = drm_copy_field(version->name, &version->name_len,  in drm_version()
519 			dev->driver->name);  in drm_version()
521 		err = drm_copy_field(version->date, &version->date_len,  in drm_version()
522 				dev->driver->date);  in drm_version()
524 		err = drm_copy_field(version->desc, &version->desc_len,  in drm_version()
525 				dev->driver->desc);  in drm_version()
534 		return -EACCES;  in drm_ioctl_permit()
538 		     !file_priv->authenticated))  in drm_ioctl_permit()
539 		return -EACCES;  in drm_ioctl_permit()
544 		return -EACCES;  in drm_ioctl_permit()
549 		return -EACCES;  in drm_ioctl_permit()
746  * ``Documentation/process/botching-up-ioctls.rst``. Note that drm_ioctl()
747  * automatically zero-extends structures, hence make sure you can add more stuff
769  * the driver-specific IOCTLs are wired up.
775 	struct drm_file *file_priv = file->private_data;  in drm_ioctl_kernel()
776 	struct drm_device *dev = file_priv->minor->dev;  in drm_ioctl_kernel()
783 		return -ENODEV;  in drm_ioctl_kernel()
803  * drm_ioctl - ioctl callback implementation for DRM drivers
818 	struct drm_file *file_priv = filp->private_data;  in drm_ioctl()
823 	int retcode = -EINVAL;  in drm_ioctl()
829 	dev = file_priv->minor->dev;  in drm_ioctl()
832 		return -ENODEV;  in drm_ioctl()
835 		return -ENOTTY;  in drm_ioctl()
841 		unsigned int index = nr - DRM_COMMAND_BASE;  in drm_ioctl()
843 		if (index >= dev->driver->num_ioctls)  in drm_ioctl()
845 		index = array_index_nospec(index, dev->driver->num_ioctls);  in drm_ioctl()
846 		ioctl = &dev->driver->ioctls[index];  in drm_ioctl()
855 	drv_size = _IOC_SIZE(ioctl->cmd);  in drm_ioctl()
857 	if ((cmd & ioctl->cmd & IOC_IN) == 0)  in drm_ioctl()
859 	if ((cmd & ioctl->cmd & IOC_OUT) == 0)  in drm_ioctl()
864 		     current->comm, task_pid_nr(current),  in drm_ioctl()
865 		     (long)old_encode_dev(file_priv->minor->kdev->devt),  in drm_ioctl()
866 		     file_priv->authenticated, ioctl->name);  in drm_ioctl()
869 	func = ioctl->func;  in drm_ioctl()
873 		retcode = -EINVAL;  in drm_ioctl()
882 			retcode = -ENOMEM;  in drm_ioctl()
888 		retcode = -EFAULT;  in drm_ioctl()
893 		memset(kdata + in_size, 0, ksize - in_size);  in drm_ioctl()
895 	retcode = drm_ioctl_kernel(filp, func, kdata, ioctl->flags);  in drm_ioctl()
897 		retcode = -EFAULT;  in drm_ioctl()
903 			     current->comm, task_pid_nr(current),  in drm_ioctl()
904 			     (long)old_encode_dev(file_priv->minor->kdev->devt),  in drm_ioctl()
905 			     file_priv->authenticated, cmd, nr);  in drm_ioctl()
911 			     current->comm, task_pid_nr(current), retcode);  in drm_ioctl()
917  * drm_ioctl_flags - Check for core ioctl and return ioctl permission flags