Re: [PATCH 2/2] Documentation: v4l: Document that link_validate op is valid for sink only

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On 04.12.2020 14:20, Sakari Ailus wrote:
Hi Sebastian,

On Thu, Dec 03, 2020 at 06:00:40AM +0100, Sebastian Fricke wrote:
Thank you.

On 02.12.2020 20:19, Sakari Ailus wrote:
> The link_validate pad op will only be called on sink pads. Document this.
>
> Signed-off-by: Sakari Ailus <sakari.ailus@xxxxxxxxxxxxxxx>
> ---
> Documentation/driver-api/media/v4l2-subdev.rst | 11 ++++++-----
> 1 file changed, 6 insertions(+), 5 deletions(-)
>
> diff --git a/Documentation/driver-api/media/v4l2-subdev.rst b/Documentation/driver-api/media/v4l2-subdev.rst
> index d4cba0d6c4ca..6d5c799c49fe 100644
> --- a/Documentation/driver-api/media/v4l2-subdev.rst
> +++ b/Documentation/driver-api/media/v4l2-subdev.rst
> @@ -122,11 +122,12 @@ Don't forget to cleanup the media entity before the sub-device is destroyed:
>
> 	media_entity_cleanup(&sd->entity);
>
> -In that case, the subdev driver may set the link_validate field to provide
> -its own link validation function. The link validation function is called for
> -every link in the pipeline where both of the ends of the links are V4L2
> -sub-devices. The driver is still responsible for validating the correctness
> -of the format configuration between sub-devices and video nodes.
> +If a sub-device driver implements sink pads, the subdev driver may set the
> +link_validate field in :c:type:`v4l2_subdev_pad_ops`to provide its own link
> +validation function. For every link in the pipeline, the link_validate pad
> +operation of the sink end of the link is called. In both cases the driver is

s/In both cases the driver/In both cases, the driver/

Is there any particular reason for this change? I think it's fine as it
was. :-)

I was just proof reading the change and thought that a comma would fit
here quite well. It really isn't anything important, so if you
don't agree, that is totally fine for me.



> +still responsible for validating the correctness of the format configuration
> +between sub-devices and video nodes.
>
> If link_validate op is not set, the default function
> :c:func:`v4l2_subdev_link_validate_default` is used instead. This function

--
Regards,

Sakari Ailus



[Index of Archives]     [Linux Input]     [Video for Linux]     [Gstreamer Embedded]     [Mplayer Users]     [Linux USB Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [Yosemite Backpacking]

  Powered by Linux