Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 5ed470fe authored by Mauro Carvalho Chehab's avatar Mauro Carvalho Chehab
Browse files

[media] media: Improve documentation for link_setup/link_modify



Those callbacks are called with the media_device.graph_mutex held.

Add a note about that, as the code called by those notifiers should
not be touching in the mutex.

Acked-by: default avatarSakari Ailus <sakari.ailus@linux.intel.com>
Acked-by: default avatarHans Verkuil <hans.verkuil@cisco.com>
Signed-off-by: default avatarMauro Carvalho Chehab <mchehab@osg.samsung.com>
parent e2c91d4d
Loading
Loading
Loading
Loading
+2 −1
Original line number Diff line number Diff line
@@ -311,7 +311,8 @@ struct media_entity_notify {
 * @enable_source: Enable Source Handler function pointer
 * @disable_source: Disable Source Handler function pointer
 *
 * @link_notify: Link state change notification callback
 * @link_notify: Link state change notification callback. This callback is
 *		 called with the graph_mutex held.
 *
 * This structure represents an abstract high-level media device. It allows easy
 * access to entities and provides basic media device-level support. The
+3 −0
Original line number Diff line number Diff line
@@ -179,6 +179,9 @@ struct media_pad {
 * @link_validate:	Return whether a link is valid from the entity point of
 *			view. The media_entity_pipeline_start() function
 *			validates all links by calling this operation. Optional.
 *
 * Note: Those these callbacks are called with struct media_device.@graph_mutex
 * mutex held.
 */
struct media_entity_operations {
	int (*link_setup)(struct media_entity *entity,