linux-kernel - Re: [PATCH v2 9/9] media: docs: Move the H264 stateless codec uAPI

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite for Android: free password hash cracker in your pocket

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <3803ef740171b4684c788ab21f7fcc32231ca198.camel@collabora.com>
Date:   Sat, 14 Nov 2020 22:11:52 -0300
From:   Ezequiel Garcia <ezequiel@...labora.com>
To:     Hans Verkuil <hverkuil@...all.nl>, linux-media@...r.kernel.org,
        linux-kernel@...r.kernel.org
Cc:     kernel@...labora.com, Jonas Karlman <jonas@...boo.se>,
        Nicolas Dufresne <nicolas.dufresne@...labora.com>,
        Philipp Zabel <p.zabel@...gutronix.de>,
        Maxime Ripard <mripard@...nel.org>,
        Paul Kocialkowski <paul.kocialkowski@...tlin.com>,
        Jernej Skrabec <jernej.skrabec@...l.net>
Subject: Re: [PATCH v2 9/9] media: docs: Move the H264 stateless codec uAPI

On Sat, 2020-11-14 at 13:57 +0100, Hans Verkuil wrote:
> On 13/11/2020 22:51, Ezequiel Garcia wrote:
> > Now that we've destaged the H264 stateless codec controls,
> > and with all the pieces in place, update the documentation
> > and move it to its own section.
> > 
> > Signed-off-by: Ezequiel Garcia <ezequiel@...labora.com>
> > ---
> >  .../userspace-api/media/v4l/common.rst        |   1 +
> >  .../media/v4l/ext-ctrls-codec-stateless.rst   | 674 +++++++++++++++++
> >  .../media/v4l/ext-ctrls-codec.rst             | 692 ------------------
> >  .../media/v4l/pixfmt-compressed.rst           |  14 +-
> >  4 files changed, 682 insertions(+), 699 deletions(-)
> >  create mode 100644 Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst
> > 
> 
> <snip>
> 
> > diff --git a/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst b/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst
> > index d585909bc4e2..32b91ce0f0d9 100644
> > --- a/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst
> > +++ b/Documentation/userspace-api/media/v4l/pixfmt-compressed.rst
> > @@ -59,14 +59,14 @@ Compressed Formats
> >  	This format is adapted for stateless video decoders that implement an
> >  	H264 pipeline (using the :ref:`mem2mem` and :ref:`media-request-api`).
> >  	This pixelformat has two modifiers that must be set at least once
> > -	through the ``V4L2_CID_MPEG_VIDEO_H264_DECODE_MODE``
> > -        and ``V4L2_CID_MPEG_VIDEO_H264_START_CODE`` controls.
> > +	through the ``V4L2_CID_STATELESS_H264_DECODE_MODE``
> > +        and ``V4L2_CID_STATELESS_H264_START_CODE`` controls.
> >  	In addition, metadata associated with the frame to decode are
> > -	required to be passed through the ``V4L2_CID_MPEG_VIDEO_H264_SPS``,
> > -	``V4L2_CID_MPEG_VIDEO_H264_PPS``,
> > -	``V4L2_CID_MPEG_VIDEO_H264_SCALING_MATRIX``,
> > -	``V4L2_CID_MPEG_VIDEO_H264_SLICE_PARAMS`` and
> > -	``V4L2_CID_MPEG_VIDEO_H264_DECODE_PARAMS`` controls.  See the
> > +	required to be passed through the ``V4L2_CID_STATELESS_H264_SPS``,
> > +	``V4L2_CID_STATELESS_H264_PPS``,
> > +	``V4L2_CID_STATELESS_H264_SCALING_MATRIX``,
> > +	``V4L2_CID_STATELESS_H264_SLICE_PARAMS`` and
> > +	``V4L2_CID_STATELESS_H264_DECODE_PARAMS`` controls.  See the
> >  	:ref:`associated Codec Control IDs <v4l2-mpeg-h264>`.  Exactly
> >  	one output and one capture buffer must be provided for use
> >  	with this pixel format. The output buffer must contain the
> > 
> 
> There is a note about this 'format not yet part of the public API' that
> needs to be deleted as well.
> 

Good catch.

Thanks,
Eze

> 
> 
>