Commit b6e4ca81 authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab
Browse files

[media] media-device.h: document the last functions 



Add kernel-doc documentation for media_device_get_devres and
media_device_find_devres.

Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
parent 60266185

drivers/media/media-device.c

+0 −7
Original line number Diff line number Diff line
@@ -689,10 +689,6 @@ static void media_device_release_devres(struct device *dev, void *res) 
{

}



/*

 * media_device_get_devres() -	get media device as device resource

 *				creates if one doesn't exist

*/

struct media_device *media_device_get_devres(struct device *dev)

{

	struct media_device *mdev;
@@ -709,9 +705,6 @@ struct media_device *media_device_get_devres(struct device *dev) 
}

EXPORT_SYMBOL_GPL(media_device_get_devres);



/*

 * media_device_find_devres() - find media device as device resource

*/

struct media_device *media_device_find_devres(struct device *dev)

{

	return devres_find(dev, media_device_release_devres, NULL, NULL);

include/media/media-device.h

+22 −0
Original line number Diff line number Diff line
@@ -449,7 +449,29 @@ int __must_check media_device_register_entity(struct media_device *mdev, 
 * the driver if required.

 */

void media_device_unregister_entity(struct media_entity *entity);



/**

 * media_device_get_devres() -	get media device as device resource

 *				creates if one doesn't exist

 *

 * @dev: pointer to struct &device.

 *

 * Sometimes, the media controller &media_device needs to be shared by more

 * than one driver. This function adds support for that, by dynamically

 * allocating the &media_device and allowing it to be obtained from the

 * struct &device associated with the common device where all sub-device

 * components belong. So, for example, on an USB device with multiple

 * interfaces, each interface may be handled by a separate per-interface

 * drivers. While each interface have its own &device, they all share a

 * common &device associated with the hole USB device.

 */

struct media_device *media_device_get_devres(struct device *dev);



/**

 * media_device_find_devres() - find media device as device resource

 *

 * @dev: pointer to struct &device.

 */

struct media_device *media_device_find_devres(struct device *dev);



/* Iterate over all entities. */