summaryrefslogtreecommitdiff
path: root/Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst
diff options
context:
space:
mode:
authorJacopo Mondi <jacopo@jmondi.org>2020-05-07 18:12:49 +0300
committerMauro Carvalho Chehab <mchehab+huawei@kernel.org>2020-05-12 18:03:26 +0300
commit3fb0ee8b3b79ee9c8fb7769bdf802bffeae7e085 (patch)
treeed1520460313915b3c985600613d5fee113e1507 /Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst
parent18200e9e243d9095be953cf09cba29f9b3b5f262 (diff)
downloadlinux-3fb0ee8b3b79ee9c8fb7769bdf802bffeae7e085.tar.xz
media: Documentation: media: Document read-only subdevice
Document a new kAPI function to register subdev device nodes in read only mode and for each affected ioctl report how access is restricted. Acked-by: Sakari Ailus <sakari.ailus@linux.intel.com> Signed-off-by: Jacopo Mondi <jacopo@jmondi.org> Signed-off-by: Hans Verkuil <hverkuil-cisco@xs4all.nl> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Diffstat (limited to 'Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst')
-rw-r--r--Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst6
1 files changed, 6 insertions, 0 deletions
diff --git a/Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst b/Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst
index 84806a893cb7..9a035a4ea0f0 100644
--- a/Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst
+++ b/Documentation/userspace-api/media/v4l/vidioc-g-dv-timings.rst
@@ -57,6 +57,10 @@ pointer to the struct :c:type:`v4l2_dv_timings`
structure as argument. If the ioctl is not supported or the timing
values are not correct, the driver returns ``EINVAL`` error code.
+Calling ``VIDIOC_SUBDEV_S_DV_TIMINGS`` on a subdev device node that has been
+registered in read-only mode is not allowed. An error is returned and the errno
+variable is set to ``-EPERM``.
+
The ``linux/v4l2-dv-timings.h`` header can be used to get the timings of
the formats in the :ref:`cea861` and :ref:`vesadmt` standards. If
the current input or output does not support DV timings (e.g. if
@@ -81,6 +85,8 @@ ENODATA
EBUSY
The device is busy and therefore can not change the timings.
+EPERM
+ ``VIDIOC_SUBDEV_S_DV_TIMINGS`` has been called on a read-only subdevice.
.. tabularcolumns:: |p{4.4cm}|p{4.4cm}|p{8.7cm}|