Describe how devices are registered using the drm_*_init() functions.
Adding this to docbook requires a largish set of changes to the comments
in drm_{pci,usb,platform}.c since they are doxygen-style rather than
proper kernel-doc and therefore mess with the docbook generation.
While at it, mark usage of drm_put_dev() as discouraged in favour of
calling drm_dev_unregister() and drm_dev_unref() directly.
Acked-by: Daniel Vetter <daniel.vetter@ffwll.ch>
Signed-off-by: Thierry Reding <treding@nvidia.com>
		
	
			
		
			
				
	
	
		
			88 lines
		
	
	
	
		
			1.9 KiB
			
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			88 lines
		
	
	
	
		
			1.9 KiB
			
		
	
	
	
		
			C
		
	
	
	
	
	
#include <drm/drmP.h>
 | 
						|
#include <drm/drm_usb.h>
 | 
						|
#include <linux/usb.h>
 | 
						|
#include <linux/module.h>
 | 
						|
 | 
						|
int drm_get_usb_dev(struct usb_interface *interface,
 | 
						|
		    const struct usb_device_id *id,
 | 
						|
		    struct drm_driver *driver)
 | 
						|
{
 | 
						|
	struct drm_device *dev;
 | 
						|
	int ret;
 | 
						|
 | 
						|
	DRM_DEBUG("\n");
 | 
						|
 | 
						|
	dev = drm_dev_alloc(driver, &interface->dev);
 | 
						|
	if (!dev)
 | 
						|
		return -ENOMEM;
 | 
						|
 | 
						|
	dev->usbdev = interface_to_usbdev(interface);
 | 
						|
	usb_set_intfdata(interface, dev);
 | 
						|
 | 
						|
	ret = drm_dev_register(dev, 0);
 | 
						|
	if (ret)
 | 
						|
		goto err_free;
 | 
						|
 | 
						|
	DRM_INFO("Initialized %s %d.%d.%d %s on minor %d\n",
 | 
						|
		 driver->name, driver->major, driver->minor, driver->patchlevel,
 | 
						|
		 driver->date, dev->primary->index);
 | 
						|
 | 
						|
	return 0;
 | 
						|
 | 
						|
err_free:
 | 
						|
	drm_dev_unref(dev);
 | 
						|
	return ret;
 | 
						|
 | 
						|
}
 | 
						|
EXPORT_SYMBOL(drm_get_usb_dev);
 | 
						|
 | 
						|
static int drm_usb_set_busid(struct drm_device *dev,
 | 
						|
			       struct drm_master *master)
 | 
						|
{
 | 
						|
	return 0;
 | 
						|
}
 | 
						|
 | 
						|
static struct drm_bus drm_usb_bus = {
 | 
						|
	.set_busid = drm_usb_set_busid,
 | 
						|
};
 | 
						|
 | 
						|
/**
 | 
						|
 * drm_usb_init - Register matching USB devices with the DRM subsystem
 | 
						|
 * @driver: DRM device driver
 | 
						|
 * @udriver: USB device driver
 | 
						|
 *
 | 
						|
 * Registers one or more devices matched by a USB driver with the DRM
 | 
						|
 * subsystem.
 | 
						|
 *
 | 
						|
 * Return: 0 on success or a negative error code on failure.
 | 
						|
 */
 | 
						|
int drm_usb_init(struct drm_driver *driver, struct usb_driver *udriver)
 | 
						|
{
 | 
						|
	int res;
 | 
						|
	DRM_DEBUG("\n");
 | 
						|
 | 
						|
	driver->bus = &drm_usb_bus;
 | 
						|
 | 
						|
	res = usb_register(udriver);
 | 
						|
	return res;
 | 
						|
}
 | 
						|
EXPORT_SYMBOL(drm_usb_init);
 | 
						|
 | 
						|
/**
 | 
						|
 * drm_usb_exit - Unregister matching USB devices from the DRM subsystem
 | 
						|
 * @driver: DRM device driver
 | 
						|
 * @udriver: USB device driver
 | 
						|
 *
 | 
						|
 * Unregisters one or more devices matched by a USB driver from the DRM
 | 
						|
 * subsystem.
 | 
						|
 */
 | 
						|
void drm_usb_exit(struct drm_driver *driver,
 | 
						|
		  struct usb_driver *udriver)
 | 
						|
{
 | 
						|
	usb_deregister(udriver);
 | 
						|
}
 | 
						|
EXPORT_SYMBOL(drm_usb_exit);
 | 
						|
 | 
						|
MODULE_AUTHOR("David Airlie");
 | 
						|
MODULE_DESCRIPTION("USB DRM support");
 | 
						|
MODULE_LICENSE("GPL and additional rights");
 |