summaryrefslogtreecommitdiffstats
path: root/Documentation/media/uapi/v4l/vidioc-create-bufs.rst
diff options
context:
space:
mode:
authorHans Verkuil <hansverk@cisco.com>2018-08-23 09:56:22 -0400
committerMauro Carvalho Chehab <mchehab+samsung@kernel.org>2018-09-11 09:49:15 -0400
commitf35f5d72e70e6b91389eb98fcabf43b79f40587f (patch)
treef8967eac3773ebcab97e8ccb6e7703bf46ef0177 /Documentation/media/uapi/v4l/vidioc-create-bufs.rst
parentdc58a553ba8c4edd26c4f585bbbc16ab2f0ec35f (diff)
downloadlinux-0-day-f35f5d72e70e6b91389eb98fcabf43b79f40587f.tar.gz
linux-0-day-f35f5d72e70e6b91389eb98fcabf43b79f40587f.tar.xz
media: videodev2.h: add new capabilities for buffer types
VIDIOC_REQBUFS and VIDIOC_CREATE_BUFFERS will return capabilities telling userspace what the given buffer type is capable of. Signed-off-by: Hans Verkuil <hansverk@cisco.com> Reviewed-by: Tomasz Figa <tfiga@chromium.org> Acked-by: Sakari Ailus <sakari.ailus@linux.intel.com> Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@kernel.org>
Diffstat (limited to 'Documentation/media/uapi/v4l/vidioc-create-bufs.rst')
-rw-r--r--Documentation/media/uapi/v4l/vidioc-create-bufs.rst14
1 files changed, 13 insertions, 1 deletions
diff --git a/Documentation/media/uapi/v4l/vidioc-create-bufs.rst b/Documentation/media/uapi/v4l/vidioc-create-bufs.rst
index a39e18d69511f..eadf6f757fbfe 100644
--- a/Documentation/media/uapi/v4l/vidioc-create-bufs.rst
+++ b/Documentation/media/uapi/v4l/vidioc-create-bufs.rst
@@ -102,7 +102,19 @@ than the number requested.
- ``format``
- Filled in by the application, preserved by the driver.
* - __u32
- - ``reserved``\ [8]
+ - ``capabilities``
+ - Set by the driver. If 0, then the driver doesn't support
+ capabilities. In that case all you know is that the driver is
+ guaranteed to support ``V4L2_MEMORY_MMAP`` and *might* support
+ other :c:type:`v4l2_memory` types. It will not support any others
+ capabilities. See :ref:`here <v4l2-buf-capabilities>` for a list of the
+ capabilities.
+
+ If you want to just query the capabilities without making any
+ other changes, then set ``count`` to 0, ``memory`` to
+ ``V4L2_MEMORY_MMAP`` and ``format.type`` to the buffer type.
+ * - __u32
+ - ``reserved``\ [7]
- A place holder for future extensions. Drivers and applications
must set the array to zero.