diff options
| author |   Hans Verkuil <hansverk@cisco.com> | 2018-08-23 06:45:09 -0400 |
|---|---|---|
| committer |   Mauro Carvalho Chehab <mchehab+samsung@kernel.org> | 2018-09-11 09:47:38 -0400 |
| commit | dc58a553ba8c4edd26c4f585bbbc16ab2f0ec35f (patch) | |
| tree | b28d1fe1581c5206205cea0967998abb44bc24f6 /Documentation | |
| parent | media: v4l2-ctrls: return -EACCES if request wasn't completed (diff) | |
| download | linux-dev-dc58a553ba8c4edd26c4f585bbbc16ab2f0ec35f.tar.xz linux-dev-dc58a553ba8c4edd26c4f585bbbc16ab2f0ec35f.zip | |
media: buffer.rst: only set V4L2_BUF_FLAG_REQUEST_FD for QBUF
Document that V4L2_BUF_FLAG_REQUEST_FD should only be used with
VIDIOC_QBUF and cleared otherwise.
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')
| -rw-r--r-- | Documentation/media/uapi/v4l/buffer.rst | 2 |
1 files changed, 2 insertions, 0 deletions
diff --git a/Documentation/media/uapi/v4l/buffer.rst b/Documentation/media/uapi/v4l/buffer.rst index 35c2fadd10de..1865cd5b9d3c 100644 --- a/Documentation/media/uapi/v4l/buffer.rst +++ b/Documentation/media/uapi/v4l/buffer.rst @@ -312,6 +312,8 @@ struct v4l2_buffer and flag ``V4L2_BUF_FLAG_REQUEST_FD`` is set, then the buffer will be queued to that request. This is set by the user when calling :ref:`ioctl VIDIOC_QBUF <VIDIOC_QBUF>` and ignored by other ioctls. + Applications should not set ``V4L2_BUF_FLAG_REQUEST_FD`` for any ioctls + other than :ref:`VIDIOC_QBUF <VIDIOC_QBUF>`. If the device does not support requests, then ``EPERM`` will be returned. If requests are supported but an invalid request file descriptor is given, then ``EINVAL`` will be returned. |