linux-kernel - Re: [PATCH v4 13/13] 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: Windows password security audit tool. GUI, reports in PDF.

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

Message-ID: <b43ae660-c32e-8e51-a101-da3cd032e546@xs4all.nl>
Date:   Wed, 25 Nov 2020 11:57:48 +0100
From:   Hans Verkuil <hverkuil@...all.nl>
To:     Ezequiel Garcia <ezequiel@...labora.com>,
        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 v4 13/13] media: docs: Move the H264 stateless codec uAPI

On 23/11/2020 15:40, 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/extended-controls.rst           |   3 +-
>  .../media/v4l/pixfmt-compressed.rst           |  21 +-
>  5 files changed, 685 insertions(+), 706 deletions(-)
>  create mode 100644 Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst
> 
> diff --git a/Documentation/userspace-api/media/v4l/common.rst b/Documentation/userspace-api/media/v4l/common.rst
> index d84aeb703165..8c263c5a85d8 100644
> --- a/Documentation/userspace-api/media/v4l/common.rst
> +++ b/Documentation/userspace-api/media/v4l/common.rst
> @@ -44,6 +44,7 @@ applicable to all devices.
>      ext-ctrls-image-source
>      ext-ctrls-image-process
>      ext-ctrls-codec
> +    ext-ctrls-codec-stateless
>      ext-ctrls-jpeg
>      ext-ctrls-dv
>      ext-ctrls-rf-tuner
> diff --git a/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst b/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst
> new file mode 100644
> index 000000000000..ab433afe625f
> --- /dev/null
> +++ b/Documentation/userspace-api/media/v4l/ext-ctrls-codec-stateless.rst
> @@ -0,0 +1,674 @@
> +.. SPDX-License-Identifier: GFDL-1.1-no-invariants-or-later
> +
> +.. _codec-stateless-controls:
> +
> +*********************************
> +Stateless Codec Control Reference
> +*********************************
> +
> +The Stateless Codec control class is intended to support
> +stateless decoder and encoders (i.e. hardware accelerators).
> +
> +These drivers are typically supported by the :ref:`stateless_decoder`,
> +and deal with parsed pixel formats such as V4L2_PIX_FMT_H264_SLICE.
> +
> +Stateless Codec Control ID
> +==========================
> +
> +.. _codec-stateless-control-id:
> +
> +``V4L2_CID_CODEC_STATELESS_CLASS (class)``
> +    The Codec class descriptor.

Codec ->  Stateless Codec

Regards,

	Hans